Home » 特点 » API

使用 Dotcom-Monitor API 自动化您的每一部分监控

通过文档化的 REST 网页 API 和 XML 报告服务 (XRS),以程序化方式创建监视器,管理设备和任务,协调负载测试,并将实时性能数据流式传输到您自己的仪表盘、SIEM 和 CI/CD 管道。
Three floating dark-mode cards on a deep navy background — a Web API JSON request creating a new HTTPS monitor, an XRS XML response with a timing breakdown, and a live API-surface KPI panel showing requests, devices, locations, sessions, and last deploy.
10,000+

全球机构数

99.99%

平台正常运行时间 SLA

30+

全球监测地点

自 1998 年

网站监控领导者

程序化监控

什么是 Dotcom-Monitor API?

Dotcom-Monitor 平台完全支持脚本操作。无论您在网页界面上能做什么——从创建新的 HTTP 监控到提取三个月的性能报告——都可以通过两种互补的服务以程序化方式完成:用于配置的 基于 REST 的 Web API 和用于实时数据提取的 XML 报告服务(XRS)

Web API 是一个结构化的、基于 JSON 的 HTTP 接口,向您的系统暴露监控和负载测试操作。您可以使用它在每次部署时创建新的监控,将成千上万个设备纳入代码化配置,集成监控到现有的工单工具,或在面向客户的状态页面中嵌入实时性能数据。

XML 报告服务(XRS) 是一个免费的按需数据流,返回监控结果的 XML 文档。您可以将其指向任何报告仪表盘、BI 工具、Excel 工作簿或内部数据库,从而无需等待工程支持即可构建自定义视图。

它们共同为您的平台、SRE 和 DevOps 团队提供完整的程序化控制——无需任何 UI 操作。

Web API — 快速参考

https://api.dotcom-monitor.com/config_api_v1/

格式

JSON 请求 / JSON 响应

方法

GET(读取)· POST / PUT(写入 / 更新)

认证

每次请求,60 秒会话;可选 IP 白名单

传输

HTTP 或 HTTPS

XRS — 快速参考

https://xmlreporter.dotcom-monitor.com/reporting/xml/

格式

HTTP(S) GET 返回 XML 响应

认证

在 管理 > 集成 中生成的账户 UID(PID)

数据深度

最多可追溯 6 个月的原始响应数据

费用

免费,包含在每个账户中

1

生成密钥

在您的账户中创建一个Web API或XML Feed集成。

2

配置

发送JSON以创建设备、任务、组、日程和警报。
3

监控

根据您定义的计划,从30多个全球位置执行运行。
4

提取

通过XRS将结果拉入仪表盘、BI、Excel或内部应用。
核心API功能

UI能做的一切——作为代码

您账户中的每个监控对象都是一流的API资源。可在环境间单独或批量管理。

完整监控配置

设备、任务与组管理

位置与计划

警报与通知集成

XRS 实时报告数据源

工作原理

四步实现从零到自动化监控

无需安装 SDK。如果您的系统可以发出 HTTP 请求,就能与 Dotcom-Monitor 通信。

01

创建集成

在您的Dotcom-Monitor账户中,进入管理 > 集成,创建新的Web API集成(用于配置)或XML Feed集成(用于报告)。可选择按IP地址限制访问。

02

认证

每个请求需对您的集成进行认证。会话在60秒无活动后过期,确保访问时间短且安全。XRS请求使用您生成的账户UID(PID)。

03

发送JSON请求

读取时调用GET,写入时调用POST/PUT。发送请求体时设置Content-Type: application/json。错误会返回结构化JSON。

04

随处自动化

将API整合到Terraform、Jenkins、GitHub Actions、Azure DevOps或您自己的脚本中。在部署时触发监控配置,将性能数据拉入BI,或在SLA违规时自动呼叫。

技术规范

两个API。一个账户。完全控制。

Web API处理配置;XRS处理报告。它们共享单一认证模型,并适用于所有Dotcom-Monitor解决方案。

Web API(配置与控制)

以编程方式管理您的监控基础设施。

基础URL

api.dotcom-monitor.com/config_api_v1/

协议

HTTP,HTTPS

请求格式

JSON (application/json)

响应格式

JSON

方法

GET(读取)· POST,PUT(写入 / 更新)

身份验证

Web API 集成密钥,每次请求的会话(60秒超时)

访问控制

IP 白名单可选

涵盖

监控 + LoadView 方法

管理的对象

设备,任务,组,日程,过滤器,警报,位置,负载测试,用户

错误处理

结构化 JSON,包含错误代码和消息

XML 报告服务(XRS)

将实时监控数据流式传输到任何支持 XML 的系统。

基础URL

xmlreporter.dotcom-monitor.com/reporting/xml/

协议

HTTP,HTTPS

请求格式

带 URL 参数的 HTTP(S) GET

响应格式

XML 文档

身份验证

账户 UID(PID),作为 XML Feed 集成生成

范围

账户范围或限于特定部门

报告类型

设备配置、状态、原始响应、汇总(小时/天/周/月/年)、3 个月统计

数据窗口

原始响应最长可达过去 6 个月

筛选器

位置、计划、设备、成功/失败、部门、日期范围

输出目标

仪表盘、SQL、Excel、Power BI、自定义应用

开发者友好

简单的 HTTP。
无需 SDK。

每个监控对象——设备、任务、警报、组、计划——都以 JSON 资源形式表示。以下示例展示了如何从 XRS 拉取监控数据并通过 Web API 推送新设备。可将这些内容放入 curl、bash 脚本、Python 任务或 CI 步骤 —— 使用您的团队当前使用的任意工具。

返回的字段包括 DnsTimeSSLTimeConnectionTimeRequestTimeFirstPacketTime(TTFB)DownloadTimeDuration,外加位置、状态及监控时间戳 —— 可直接用于任意瀑布图视图。

# 拉取实时 XRS 报告——按位置汇总
GET https://xmlreporter.dotcom-monitor.com/reporting/xml/responses.aspx
     ?PID=4229AF4F0FB545AEA75EAF2013E51BB7
     &Site=12345
     &Type=Overall
     &location=NY, USA

# 响应(已截断)
<Response>
  <ID>3424533543</ID>
  <Name>结账 API</Name>
  <URL>https://shop.example.com/api/checkout</URL>
  <Duration>114</Duration>
  <DnsTime>0</DnsTime>
  <SSLTime>18</SSLTime>
  <ConnectionTime>15</ConnectionTime>
  <FirstPacketTime>97</FirstPacketTime>
  <DownloadTime>2</DownloadTime>
  <Status>S</Status>
</Response>

# 通过 Web API 创建新的 HTTPS 监控
POST https://api.dotcom-monitor.com/config_api_v1/devices
Content-Type: application/json

{
  "name": "结账 API — 生产环境",
  "platform": "HTTPS",
  "tasks": [{
    "url": "https://shop.example.com/api/checkout",
    "method": "POST",
    "keyword": "order_id"
  }],
  "frequency": 60,
  "locations": ["NY-USA", "FR-PARIS", "SG"]
}

五分钟内开始自动化您的监控

每个付费计划均包含完整的 Web API 和 XRS 访问权限 —— 无需额外插件,无调用计费,无额外计费等级。

用例

团队通过 API 构建的内容

平台团队、SRE 和 DevOps 工程师使用 Dotcom-Monitor API 将监控集成到他们日常的工作流中。

代码监控

对每个监控器和其保护的服务同时进行版本控制。通过现有的 Terraform 或 Pulumi 流水线配置、更新和退役设备——确保预发布和生产环境之间无漂移。

部署后冒烟测试

在每次部署后,从 Jenkins、GitHub Actions 或 Azure DevOps 触发按需的 HTTPS 和多步骤事务检查。当新发布破坏关键端点时,使构建失败。

自定义状态页和仪表盘

将 XRS 数据输入面向客户的正常运行时间页面、内部 NOC 显示或高管 SLA 报告。仅提取所需字段,且格式完全符合您的需求。

SLA 证据和合规报告

将每月 SLA 导出(正常运行时间百分比、P95 / P99 响应时间、停机事件)自动从 XRS 导出为 Excel 或 PDF —— 有文档、有时间戳,并且已准备好审计。

批量设备配置

在收购、迁移或 CDN 切换后,一次性启用数百个监控器。克隆现有设备模板,并大规模分配正确的组、计划和警报路径。

第三方仪表盘嵌入

将监控数据导入 Grafana、Power BI、Tableau 或 Datadog,与您的其他遥测数据并列——外部合成检查与内部 APM 跟踪相关联。

多租户账户管理

MSP 和企业团队可以在单个编程操作中管理数百个部门和数千台设备,为每个客户提供部门范围的 XRS 数据流。

事件丰富

当监控触发时,通过 XRS 拉取瀑布图、解密和时间细目,并自动附加到 PagerDuty 或 ServiceNow 事件——减少分诊时间。

XRS 深度解析

实时报告,完全按需呈现

XML 报告服务是灵活、免费的按需数据流。请求汇总数据或原始响应。可按位置、计划或成功状态过滤。只返回您关心的字段。

报告类型
您获得的内容
典型用途
账户使用情况
每个监控解决方案的已用和可用资源
许可和容量规划,计费对账
设备状态
单个设备或设备组的当前状态
实时状态页面,NOC墙面仪表盘
响应详情
每个请求的高度可定制的时间和内容
详细诊断,自定义流水线,事件丰富化
设备和任务配置
导出的监控配置快照
备份,跨环境克隆,审计追踪
摘要数据
正常运行时间,停机时间,成功次数,失败次数,性能,标准差
执行摘要,SLA报告
原始响应
设备的每次检查结果,最多回溯6个月
取证分析,历史比较
每小时汇总
响应数据按1小时窗口分类
峰值负载识别,每小时趋势分析
每日汇总
响应数据按24小时窗口分类
每日运营评审,工作日与周末比较
每周 / 每月 / 每年
跨更长时间范围的汇总
董事会级趋势,年度表现报告
3个月统计数据
在滚动的3个月窗口内计算的统计数据
基线派生的警报,异常检测

每个报告都可以按监控位置计划Dotcom-Monitor过滤器成功或失败状态部门自定义日期范围进行筛选。

团队为何使用API

为DevOps、SRE和平台工程而建

Dotcom-Monitor API为您的监控工作流去除了手动UI点击,使您的团队能够在不增加人手的情况下扩展合成覆盖范围。

消除漂移

将监控配置保存在源代码控制中。自信地在各环境中应用相同监控器。

左移监控

在与服务相同的PR中添加合成检查。监控与代码一起交付,而不是延迟数周。

无点击扩展

通过单个脚本注册数百个新域名或数千个新端点。无点击疲劳。

细粒度安全性

短期会话、可选IP白名单以及部门范围的集成密钥保持访问严格。

适用于任何技术栈

纯HTTP + JSON(或用于报告的GET + XML)。无SDK绑定。支持所有语言和CI/CD工具。

拥有您的数据

按照您的计划将监控数据拉取到您自己的数据仓库、BI平台或合规档案中。

统一界面

一个API涵盖监控和LoadView负载测试——无单独工具,无单独凭证。

无额外费用

API和XRS访问包含在所有付费计划中。无每次调用计费,无自动化额外收费。

客户评价

“Dotcom 最佳功能之一是推送/拉取 API 功能,它为我们提供网络性能数据。我们使用它来监控性能问题以及页面加载统计。Dotcom-Monitor 允许我们在一个界面和平台内监控多项服务,这使我们能够更高效地运作。”
Gregory S.
经理,广播媒体 · Capterra 验证评价

准备好让监控自动化了吗?

每个30天试用包含完整的 Web API 和 XRS 访问权限 — 还有所有监控解决方案、所有地点和所有集成。体验自动化监控的感觉。

常见问题

关于 Dotcom-Monitor API 的常见问题

Web APIconfig_api_v1)是一个基于 JSON 的 REST 接口,用于创建和管理监控配置——设备、任务、组、计划、警报和负载测试。XML 报告服务(XRS)是一个免费的独立服务,通过 HTTP GET 返回监控结果的 XML。大多数团队同时使用两者:使用 Web API 进行配置,使用 XRS 提取结果。

在您的 Dotcom-Monitor 账户中,进入 管理 > 集成 > 新建集成,创建一个Web API集成(用于配置)或XML Feed集成(用于 XRS)。每个 Web API 请求都需通过该集成认证,且会话在60秒无活动后过期。XRS 使用生成的账户 UID 作为PID URL 参数。您也可以通过 IP 地址限制访问。

Web API 完全采用 JSON——请求体和响应均是 JSON。发送带 JSON 体时,请设置 Content-Type: application/json。XRS 通过 HTTP(S) GET 返回 XML 文档,因此请求只是带查询参数的 URL。

Web API 涵盖所有 Dotcom-Monitor 监控平台:HTTPS、REST、SOAP、GraphQL、WebSocket、ServerView、BrowserView、UserView(EveryStep 脚本)和 MetricsView——以及所有协议监控(DNS、SSL、邮件、FTP、ICMP Ping、TCP 端口、Traceroute、VoIP 等)。它还覆盖完整的 LoadView 负载测试界面。

API 和 XRS 访问包含在所有付费计划中——无单次调用计费,无额外费用。会话在60秒无活动后过期,天然限制长时间运行的脚本。如果您需要 IP 限制访问或企业级吞吐量,请联系销售了解企业版选项。

XRS 可以返回 过去最长6个月的原始响应数据。摘要和统计报告(小时/每日/每周/每月/每年汇总及3个月统计)可在更长时间范围内获得。您可以为每个报告指定起始和结束日期/时间。

可以——任何能够发起 HTTP 调用的工具都可以驱动 API。团队通常与 Jenkins、GitHub Actions、GitLab CI、Azure DevOps、CircleCI 和 Terraform 集成,以在部署时配置监控器,运行发布后冒烟测试,并根据监控状态控制生产发布。

可以。当您创建 Web API 集成时,可以允许所有经过身份验证的请求访问,或限制访问到一列可信 IP 地址。详情请参见知识库中的如何为 Web API 访问设置白名单 IP文章。

支持。根账户用户可以以编程方式管理部门,且 XML Feed 集成可以限定到特定部门。部门限定用户只能提取其所属部门的 XRS 报告,支持 MSP 和多租户环境的清晰分离。

完整文档存放在 Dotcom-Monitor 知识库,包括API 入门指南、带 JSON 示例的监控和 LoadView 方法参考,以及XRS 请求参数参考。代码示例部分提供了可直接使用的代码模板。

自动化监控。释放工程时间。

加入超过10,000个组织,使用 Dotcom-Monitor 在客户发现失败前捕获问题——并利用 API 和 XRS 轻松管理监控覆盖。