使用 XML 报告服务（XRS）

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 > 或网站* – 网站列表

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 压缩。换句话说，响应第一个和最后一个字节之间的时间。

使用 XML 报告服务（XRS）

帐户 UID

UID 部

可用的请求组件

解决方案

特征

公司

帐户 UID

UID 部

可用的请求组件

解决 方案

特征

公司

解决方案