XML 报告服务 (XRS) 是一种按需服务,通过 HTTP 请求提供数据。 通过将格式正确的 HTTP GET 请求发送到具有有效参数xmlreporter.dotcom-monitor.com,您将收到包含请求数据的 XML 文档。 您可以在需要时处理 XML 文档中的数据。 可能性包括将数据导入其他系统或仪表板。

到 XML 报表服务的最大请求数为每 10 秒 1 个。

如果在 10 秒内提交多个请求,该服务将返回一个 XML 文档,下一个允许的请求时间如下所示:

  • <错误 > 您已达到每个 IP [192 .168.107.97] < /错误的最大允许请求限制>
  • <下一个允许时间 > 2014年2月18日 星期二 7:50:26 PM < /下一个允许时间>
  • <下一个允许时间GMT > 2014年2月18日 4:50:26 PM < /下一个允许时间GMT>

XML FEED 请求是具有许多 GET 参数的 URL,由”&”符号分隔。

XML 请求由以下项组成:

 [base_url_address]  +  [unique_account_uid]  +  [Site_id]    [parameter1] • 和 [parameter2] … 

示例请求:

 https://xmlreporter.dotcom-monitor.com/reporting/xml/responses.aspx  ?pid=4229AF4F0FB545AA75EAF2013E51BB7  &Site=12345  &Type=整体   https://xmlreporter.dotcom-monitor.com/reporting/xml/responses.aspx  ?pid_78789A2394764BA880A4DCAC62AAE90D  &Site_57628  &Type_Detail&位置_NY,美国 

帐户 UID

要创建 XML 请求,您需要您的帐户唯一标识火 (UID) 用作请求参数  [unique_account_uid] . 在 XMLAccount > Integrations > 源互通类型帐户集成唯一标识符 (UID)下的导航菜单中登录到您的帐户时,可以找到此 ID。

UID 部

如果帐户中配置了“部门”,则可以配置 XML 源以仅提供特定部门的数据。 为每个部门分配单独的 UID。 要访问部门 UID,请将 Dotcom-Monitor 帐户切换到部门用户,并从帐户 > 集成 > 唯一标识符 (UID)复制 UID。 使用部门 UID 而不是帐户 UID  [unique_account_uid]  在 XML 源请求中。

可用的请求组件

status.aspx - returns devices state and status information
  • http://xmlreporter.dotcom-monitor.com/reporting/xml/status.aspx

这只会返回状态:向上/向下/延迟,以及请求设备的”活动/延迟/无任务”状态。

参数:

  • PID= < 帐户 UID>

这是您的帐户全局唯一标识符(帐户 > 集成 > 唯一标识符 (UID)列)。

  • 站点 < 1 > 和.[和网站] < 网站N > 或网站* – 网站列表

这是网站指示列表。 在网络监视器中也称为”设备”。 单击所选设备旁边的操作菜单中的编辑,在设备管理器屏幕上登录到您的帐户时,可以找到单个设备指示。 加载下一个屏幕时,设备 ID 将位于 URL 中:

https://user.dotcom-monitor.com/Site-Edit.aspx?

id=123456

您还可以使用 XML 接口获取站点 ID。 请参阅 config.aspx 的用法。 您可以在一个请求中输出多个站点。 使用 * 选择所有网站。

例子:

https://xmlreporter.dotcom-monitor.com/reporting/xml/status.aspx?pid=78789A2394764BA880A4DCAC62AAE90D&Site=*
responses.aspx - returns responses information
  • http://xmlreporter.dotcom-monitor.com/reporting/xml/responses.aspx

此基本 URL 用于传递请求中的多个参数,如下文参数列表中所述。

请确保删除参数之间的任何空格,否则 XML 源将忽略这些参数。

参数:

  • PID= < 帐户 UID>

这是您的帐户全局唯一标识符(帐户 > 集成 > 唯一标识符 (UID)列)。

  • 站点 < 1 > 和.[和网站] < 网站N > 或网站* – 网站列表

这是网站指示列表。 在网络监视器中也称为”设备”。 单击所选设备旁边的操作菜单中的编辑,在设备管理器屏幕上登录到您的帐户时,可以找到单个设备指示。 当下一个屏幕加载时,设备 ID 将位于 URL 中:

https://user.dotcom-monitor.com/Site-Edit.aspx?

id=123456

您还可以使用 XML 接口获取站点 ID。 请参阅上面的 config.aspx 的用法。 您可以在一个请求中输出多个站点。 使用 * 选择所有网站。

  • 任务= < 任务 1 > 和.[和任务] < 任务N > 或任务* – 任务列表

这是任务的 ID,在结构上与站点类似。

单击所选任务旁边的操作菜单中的编辑,在设备管理器屏幕上登录到您的帐户时,可以找到单个任务号。 当下一个屏幕加载时,设备 ID 将位于 URL 中:

https://user.dotcom-monitor.com/task-edit.aspx?

id=123456

您还可以使用 XML 接口获取任务 ID。 请参阅上面的 config.aspx 的用法。 您可以在一个请求中输出多个任务。 使用 * 选择所有任务。

可以使用 &将几个可选参数追加到 URL 中,尤其是在轮询具有http://xmlreporter.dotcom-monitor.com/reporting/xml/responses.aspx基本 URL 的响应时:

  • 类型=总体

这将提供汇总数据,如停机时间/停机时间、成功次数和故障数、性能数据和标准偏差。

  • 类型=小时

此参数将响应聚合为一小时长周期,并显示每小时的统计信息。

  • 类型=天

包括指定期间按天数的摘要。

  • 类型=周

包括指定期间按周汇总。

  • 类型 =季度

此参数将一个周期分为 3 个月(季度)期间和每个 < “/摘要 > … </摘要 > “元素表示在 3 个月内计算的统计数据。

  • 类型=月

指定期间按月汇总。

  • 类型 =年份

年份 = 指定期间的年汇总。

  • 类型=详细信息

它提供请求期间的原始数据。 原始数据仅提供过去 6 个月的数据。

  • 周开始* < 星期一>

允许用户转移业务周的开始日。 例如,您可以将开始一天设置为星期日,如在美国(开始周+星期日),也可以将星期一(周开始=星期一)设置为星期一(周开始=星期一)

  • 从 * < 日期和时间>

这指定报告的开始日期和时间。

对于美国日期和时间格式,请使用斜杠“MM/DD/YYYY H:M”
对于欧盟的日期和时间格式,请使用破折号“YYYY-MM-DD H:M”

  • 到 + < 日期和时间>

这指定报告的结束日期和时间。
对于美国日期和时间格式,请使用斜杠“MM/DD/YYYY H:M”
对于欧盟的日期和时间格式,请使用破折号“YYYY-MM-DD H:M”

美国格式:

http://xmlreporter.dotcom-monitor.com/reporting/xml/responses.aspx?pid=9D7B3CBCEFAD4B41A188E88E750BB865&Site=70795&Type=overall&from=09/13/2012&to=09/13/2012

欧盟格式:

http://xmlreporter.dotcom-monitor.com/reporting/xml/responses.aspx?pid=C8BE4C42486C471ABE06E2DCE5ADB0DF&Site=59106&Type=Detail&from=2012-03-04 15:20&to_2012-03-05 15:20
  • 类型 = 一天中小时

此参数提供包含 24 个编号片段的响应,其中每个 < “/摘要 > … </摘要 > “元素匹配一天中的一个精确小时。 统计值(如平均响应时间、响应时间 STDDev、停机时间百分比等)反映在指定时间段内计算的平均值(例如,一周期间)。 此参数便于分析小时负载。

此类型仅适用于较长或等于 1 天的报告期。

  • 类型 = 状态更改

计算每个块的统计信息,该数据对应于状态更改后的时间长度。 此参数将使 < “/摘要 > … </摘要 > “元素以与任何在线报表的”延长时间/停机时间”部分相同的方式显示周期。

  • 类型 = 周日

此参数提供包含七 (7) 个编号片段的响应,其中每个 < “/摘要 > … </摘要 > “元素匹配一周中的一个确切的一天。 统计值(如平均响应时间、响应时间 STDDev、停机时间百分比等)反映在指定时间段内计算的平均值(例如,一周期间)。 此参数便于分析每日负载。

  • 过滤器= < 过滤器ID>

这提供了根据筛选器规则筛选数据的能力。

在”配置、筛选器”下的导航菜单中的”设备管理器”屏幕上登录帐户时,可以找到单个筛选器文档。 单击筛选器时,将在编辑页面的 URL 中看到 ID:

https://user.dotcom-monitor.com/Filter-Edit.aspx?

id=123456

  • 计划程序* < 计划ID>

这提供了在特定时间段内排除数据的能力。

在”配置,计划”下的导航菜单中的”设备管理器”屏幕上登录您的帐户时,可以找到单独的计划。 单击筛选器时,将在编辑页面的 URL 中看到 ID:

https://user.dotcom-monitor.com/Scheduler-Edit.aspx?

id=123456

  • 状态 =S

仅查看成功响应。

  • 状态=F

仅查看故障响应。

  • 位置和 [agent1] …[和位置][agent2]

按监视代理位置筛选响应。

如果希望 XML 源仅显示来自某些监视代理的结果,请以下列方式向请求 URL 添加”&Location”字符串参数:

 http://xmlreporter.dotcom-monitor.com/reporting/xml/responses.aspx?pid=XXXXXXXXXXX&Site=XXXXX&Type=Detail & 位置 ] [agent1] [agent2] …[和位置] [agent5] … 
http://xmlreporter.dotcom-monitor.com/reporting/xml/responses.aspx?pid=XXXXXXXXXXX&Site=XXXXX&Type=Detail    & 位置 ] [agent1] [agent2] ...[和位置] [agent5] ...

代理字符串值的列表:

美国

  • 旧金山
  • IPv6 圣弗朗西斯科
  • 西雅图
  • 达拉斯
  • 丹佛
  • 明尼阿波利斯
  • 迈阿密
  • 蒙特利尔
  • 华盛顿
  • 纽约
  • AWS 美国-东部
  • 布宜诺斯艾利斯
欧洲

  • 伦敦
  • 巴黎
  • 阿姆斯特丹
  • 哥本哈根
  • 法兰克福
  • 华沙
  • 特拉维夫
亚洲、澳大利亚、非洲

  • 孟买
  • 香港
  • 北京
  • 上海
  • 东京
  • 悉尼
  • 布里斯班
  • 约翰内斯堡
  • 选项_注释

包括与设备关联的自定义注释。

  • 选项_请求详细信息

要包括元素级别详细信息(如瀑布图中包含的内容),可以将”选项”标志设置为”请求详细信息”。

包括”扩展 XML 详细信息”。

  • 选项=所有向下百分比

包括摘要的所有百分比。

  • 选项=所有时间

包括所有总结时间,包括停机、停机时间、未定义时间、加权停机时间和加权停机时间。

  • 选项=最新响应

包括分配给所选设备的每个监视位置的最新响应。

  • 数量= < 编号>

仅包括 < > 所选设备的上次响应集数。

  • 详细信息_内容

包括点击详细信息内容。

  • 详细信息_HtmlBody

包括命中细节 HtmlBody

  • 详细信息=通用描述

包括命中详细信息常见描述

  • 详细信息=浏览器操作

包括导航计时,如导航开始/结束、重定向、提取、域查找、请求启动、卸载事件、渲染开始

例子:

https://xmlreporter.dotcom-monitor.com/reporting/xml/responses.aspx?pid=78789A2394764BA880A4DCAC62AAE90D&Site=*&Type=Overall
https://xmlreporter.dotcom-monitor.com/reporting/xml/responses.aspx?pid=78789A2394764BA880A4DCAC62AAE90D&Task=*&Type=Detail
[/su_highlight]
config.aspx - returns sites and tasks configuration information

此基本 URL 用于传递请求中的多个参数,如下文参数列表中所述。

  • https://xmlreporter.dotcom-monitor.com/reporting/xml/config.aspx

此 URL 允许您检索站点的 I 和任务号。

参数:

  • PID= < 帐户 UID>

这是您的帐户全局唯一标识符(帐户 > 集成 > 唯一标识符 (UID)列)。

  • 站点名称 = < 站点 1 > 和.[和网站] < 网站N > 或网站* – 网站列表

这是网站指示列表。 在网络监视器中也称为”设备”。 单击所选设备旁边的操作菜单中的编辑,在设备管理器屏幕上登录到您的帐户时,可以找到单个设备指示。 当下一个屏幕加载时,设备 ID 将位于 URL 中:

https://user.dotcom-monitor.com/Site-Edit.aspx?

id=123456

您还可以使用 XML 接口获取站点 ID。 请参阅上面的 config.aspx 的用法。 您可以在一个请求中输出多个站点。 使用 * 选择所有网站。

  • 任务= < 任务 1 > 和.[和任务] < 任务N > 或任务* – 任务列表

这是任务的 ID,在结构上与站点类似。

单击所选任务旁边的操作菜单中的编辑,在设备管理器屏幕上登录到您的帐户时,可以找到单个任务号。 当下一个屏幕加载时,设备 ID 将位于 URL 中:

https://user.dotcom-monitor.com/task-edit.aspx?

id=123456

您还可以使用 XML 接口获取任务 ID。 请参阅上面的 config.aspx 的用法。 您可以在一个请求中输出多个任务。 使用 * 选择所有任务。

您还可以使用”SiteName”参数的掩码按某些起始模式筛选请求结果:SiteName_em_

  • 类型=任务

包括任务基本信息。

  • 类型=字段

包括任务详细信息。

例子:

https://xmlreporter.dotcom-monitor.com/reporting/xml/config.aspx?pid=78789A2394764BA880A4DCAC62AAE90D&SiteName=em*&Type=Task
https://xmlreporter.dotcom-monitor.com/reporting/xml/config.aspx?pid=78789A2394764BA880A4DCAC62AAE90D&SiteName=*&TaskName=*&Type=Field
XML Response Fields

例子:

<响应> 
<ID > 3424533543 < /ID> 
<名称 > 演示请求 < /名称> 
<URL > http://demo.webportal.com/APIv1/json?userid=test;userweight=22;ACT_DASW < /URL>
<监控-日期-时间 > 3/26/2014 12:38:38 PM < /监控日期-时间> 
<持续时间 > 114 < /持续时间>
<DnsTime > 0 < /Dnstime>
<SSLTime > 0 < /SSLTime> 
<连接时间 > 15 < /连接时间> 
<请求时间 > 0 < /请求时间> 
<第一次数据包时间 > 97 < /第一次数据包时间> 
<下载时间 > 2 < /下载时间> 
<状态 > S < /状态> 
<监控-位置 > FL, 美国 < /监控-位置> 
</响应>
  • 持续时间– 完成任务所占用的总时间(基本 – 以下时间总和)
  • DnsTime – 是将主机名(例如www.google.com)解析为数字 IP 地址(例如 216.239.59.99)所需的时间。
  • SSLTime – 是完成 SSL 握手过程所需的时间。
  • 连接时间– 是创建到 Web 服务器(或代理)的 TCP 连接所需的时间。 保持活动连接通常用于避免重复连接到 Web 服务器的开销。
  • 请求时间– 是向服务器发送 HTTP 请求消息所需的时间,取决于发送到服务器的数据量。 例如,使用 HTTP POST 上传文件会导致发送时间过长
  • 第一包时间– (时间到第一字节)时间经过,以开始接收从远程 Web 服务器接收数据。 换句话说,请求和响应之间的时间第一个字节收到。
  • 下载时间– 是从服务器读取响应消息所花时间。 此值将取决于返回的内容大小、网络带宽以及是否使用了 HTTP 压缩。 换句话说,响应第一个和最后一个字节之间的时间。