如果你有一组使用 Insomnia 进行内部 API 测试的集成测试,你可以将 Insomnia 测试集合上传到 Dotcom-Monitor,以便从 40+ 全球位置进行 API 测试。

Dotcom-Monitor 支持多种选项,例如对监视时发生的错误发出警报、指定监视位置、配置监视计划程序和筛选器,以及设置监视结果报告。 通过从每分钟到每 3 小时进行一次监控检查,您的团队将在监控设置中获得高度的灵活性。

准备工作

失眠请求集合和设计文件


在开始设备配置之前,请注意 Dotcom-Monitor 支持导入 Insomnia 请求集合和设计文档。 但是,我们处理导入的设计文档和请求集合的方式有所不同


要将
Insomnia 集合或文档上传到 Dotcom-Monitor,请确保将 Insomnia 数据导出到 JSON 文件。

当您将 Insomnia 设计文档上传到 Dotcom-Monitor 并运行监控测试时,我们仅执行测试套件列表中的第一个套件。 文档中的所有其他测试套件都将被忽略。

当您将失眠请求集合上传到 Dotcom-Monitor 时,我们会执行该集合并验证任何网络和响应代码错误(如 404、401、500 等)的响应。

设置 失眠收集监测设备

有关如何创建监视设备的快速概述,请阅读” 创建监视设备知识库 “一文。

如果您要为一组失眠集合设置监控,我们建议您为每个设备设置一个集合。 有关详细信息,请参阅我们 wiki 的 多目标限制 文章。

集合中的 HTTP 请求表示单独的监视任务,将按包收费。 另请参阅

近似 WebView 监控的定价矩阵 知识库文章. P租赁 联系网络监控器 Account Executive 与 任何 问题。

如果希望 Dotcom-Monitor 在
集合执行期间不满足测试设置的任何条件或检测到任何网络错误
时生成警报并发送警报通知,请确保 配置设备警报设置

导入 Insomnia Collection & Design 文档

点击 进口 ,然后选择一个包含 Insomnia Collection 或 Document 的 JSON 文件进行上传。 失眠脚本 将显示在 催收请求 部分.

收集超时

收集超时(以秒为单位)确定设备在终止任务并引发错误之前应等待失眠请求和测试完成的持续时间。

准备脚本

请参阅 使用准备脚本 一文。

保护请求中的数据

请参阅 如何使用 Dotcom-Monitor 保护 Insomnia 请求中的敏感数据 ,以保护与 Insomnia 请求一起发送的敏感信息。

忽略网络错误

网络错误可能包括 DNS 解析错误、TCP 连接超时/错误,或者服务器使用 4xx5xx 响应状态代码(且无数据)终止或重置连接的情况。 默认情况下,Dotcom-Monitor 会生成错误,并针对执行期间发生的 Insomnia 网络错误发送警报通知。 如果网络错误不是您关心的问题,或者是预期的系统行为,您可以配置您的 Insomnia Collection 监控设备以过滤掉此类错误。

如果“ 忽略网络错误 ”选项设置为“ ”,则 Dotcom-Monitor 不会 对来自 Insomnia Collection 的失败请求发出错误,并将设备状态更改为 “警报”。 但是,您将在监视会话报告中看到 HTTP 错误。 在此方案中,集合测试套件将用于验证响应有效性。

通常,如果要接收完全基于随 Insomnia Collection 导入的测试的监控结果,建议启用 “忽略网络错误 ”选项。

假设我们有一个失眠文档检查 401 错误代码,以响应 不正确的登录信息输入

如果在 Dotcom-Monitor 中将 “忽略网络错误 ”选项设置为“ ”,并且在响应中收到 401 未经授权 的响应状态代码,则系统将忽略该错误并将监控检查解释为成功通过。

如果同一失眠收集监测设备的 “忽略网络错误 ”选项设置为 “否 ”,则系统将对运行收集时收到的所有网络错误(包括 401 未经授权 的响应)引发错误。 设备状态将设置为 “警报”。

忽略错误代码

请参阅 忽略 Web 服务和 Internet 基础结构监视的 Web 请求错误

监控基于 OAuth 2.0 的 API

通常,使用 OAuth 2.0 的服务 API 调用包括按顺序执行的两个步骤:首先,使用持有者令牌身份验证机制获取 API 访问令牌。 其次,使用授予的持有者令牌从服务请求自定义数据。

但是,由于在新环境中检索 OAuth 访问令牌时未解决的失眠问题,此基于令牌的身份验证在导入到 Dotcom-Monitor 时失败。 换言之,第二个请求将失去对通过第一个请求获取的持有者令牌的引用。

解决方法是,可以在 Insomnia 中的单个请求中处理需要持有者令牌的 API 调用。

若要使用 Dotcom-Monitor 导入和监视 Insomnia 集合,请避免在集合的第一次 API 调用中请求身份验证令牌。 相反,请使用 OAuth 2 身份验证类型直接在数据请求中设置身份验证。

 

这样,Insomnia 集合将在 Dotcom-Monitor 中正确导入和执行。