使用 XML 报告服务（XRS）工具

Dotcom-Monitor 允许您通过实时监控统计数据或自定义信息向第三方软件、Web 应用程序或实时仪表板发送数据。此实时报告数据可以包括：

关于 Dotcom 监控帐户利用率的统计数据（每个解决方案已使用和可用资源）。
一个或一组监视设备的状态和状态。
收到的一组或一组指定设备的响应详细信息。响应信息请求可以使用多个请求参数高度定制到必要的详细信息级别。
监控设备和任务配置数据。

要发布按要求实时报告，Dotcom 监控器使用 XML 报告服务框架。查找相应的请求组件描述，以提取必要的实时 XML 报告类型：

帐户.aspx - 帐户包利用
- http://xmlreporter.dotcom-monitor.com/reporting/xml/Account.aspx
此 URL 将返回所选帐户的使用历史记录，并列出解决方案的细目。该报告包括关于包容量和每个包的使用资源的信息。对于根帐户，将包括部门包利用率。

参数：
- PID=< 帐户 UID>
这是您的帐户全球唯一标识符（配置 > 集成 > 唯一标识符（UID）列）。

例子：
```
https://xmlreporter.dotcom-monitor.com/reporting/xml/Account.aspx?PID=78799A2394884BA880A4DCAC62AAE90D
```

配置.aspx - 网站和任务配置信息
此基础 URL 允许您检索站点和任务详细信息。
- https://xmlreporter.dotcom-monitor.com/reporting/xml/config.aspx
使用此基础 URL，您可以传递请求中的多个参数，如下所示的参数列表中所示。

参数：
- PID=< 帐户 UID>
这是您的帐户全球唯一标识符（配置 > 集成 > 唯一标识符（UID）列）。
- 标签= < 标签 > 1。•标签= < 标签>
此参数从列表中至少提取一个标签，拉取所有站点和任务。
- 网站名= < 网站名 > 1。。&选址名= < 网站名>
这是 Dotcom 监视器中的站点名称列表（称为”设备”）。您可以使用通配符字符（”*”，”？）通过某些名称模式筛选请求结果：
```
SiteName=goo*
```
使用”*”选择所有站点：
```
SiteName=*
```
- 任务= < 任务 > 1。•任务= < 任务>
这是 Dotcom 监视器中监控任务的 ID，其结构与站点参数相似。您可以在一个请求中输出多个任务，并使用通配符字符（”*”，”？）通过某些任务 ID 模式筛选请求结果。

使用”*”来选择所有任务：
```
Task=*
```
单击所选任务旁边的操作菜单中的编辑，在设备管理器屏幕上登录到您的帐户时，可以找到单个任务号。当下一个屏幕加载时，任务 ID 将因此在 URL 中：
```
https://user.dotcom-monitor.com/task-edit.aspx?id=123456
```
您还可以使用 XML 界面获得配置 .aspx 请求的任务 ID。
- 类型=任务
包括任务基本信息。
- 类型=字段
包括任务详细信息。

例子：
```
https://xmlreporter.dotcom-monitor.com/reporting/xml/config.aspx?pid=78799A2394884BA880A4DCAC62AAE90D&SiteName=my*&Type=Task
https://xmlreporter.dotcom-monitor.com/reporting/xml/config.aspx?pid=78799A2394884BA880A4DCAC62AAE90D&SiteName=*&Type=Task&Type=Field
```

状态.aspx - 设备状态和状态信息
- http://xmlreporter.dotcom-monitor.com/reporting/xml/status.aspx
这只会返回状态：向上/向下/延迟，以及请求设备的”活动/延迟/无任务”状态。

参数：
- PID=< 帐户 UID>
这是您的帐户全球唯一标识符（配置 > 集成 > 唯一标识符（UID）列）。
- 标签= < 标签 > 1。•标签= < 标签>
此参数从列表中至少提取一个标签，拉取所有站点和任务。
- 站 < 点=站点 > 1。&选 < 址=网站N>
这是 Dotcom 监视器中的站点（称为”设备”）ID 或名称列表。您可以在一个请求中输出多个站点，并使用通配符字符（”*”，”？）以某些模式筛选请求结果：
```
SiteName=123*
```
使用”*”选择所有站点：
```
Site=*
```
单个站点 ID 可在登录设备管理器屏幕上的帐户时找到，只需单击选定设备旁边的操作菜单中的编辑即可找到。当下一个屏幕加载时，站点 ID 将以如下身份出现在 URL 中：
```
https://user.dotcom-monitor.com/Site-Edit.aspx?id=123456
```
您还可以使用 XML 界面获得带有 配置.aspx 请求的站点 ID。

例子：
```
https://xmlreporter.dotcom-monitor.com/reporting/xml/status.aspx?pid=78799A2394884BA880A4DCAC62AAE90D&Site=*
```

响应.aspx - 响应信息
- http://xmlreporter.dotcom-monitor.com/reporting/xml/responses.aspx
此基本 URL 用于传递请求中的多个参数，如下文参数列表中所述。

请务必删除参数之间的任何空格。否则，XML 源将忽略这些参数。

参数：
- PID=< 帐户 UID>
这是您的帐户全球唯一标识符（配置 > 集成 > 唯一标识符（UID） 列）。
- 标签= < 标签 > 1。•标签= < 标签>
此参数从列表中至少提取一个标签，拉取所有站点和任务。
- 站 < 点=站点 > 1。&选 < 址=网站N>
这是 Dotcom 监视器中的站点（称为”设备”）ID 或名称列表。您可以在一个请求中输出多个站点，并使用通配符字符（”*”，”？）以某些模式筛选请求结果：
```
SiteName=123*
```
使用”*”选择所有站点：
```
Site=*
```
单个站点 ID 可在登录设备管理器屏幕上的帐户时找到，只需单击选定设备旁边的操作菜单中的编辑即可找到。当下一个屏幕加载时，站点 ID 将以如下身份出现在 URL 中：
```
https://user.dotcom-monitor.com/Site-Edit.aspx?id=123456
```
您还可以使用 XML 界面获得带有 配置.aspx 请求的站点 ID。
- 任务= < 任务 > 1。•任务= < 任务>
这是 Dotcom 监视器中监控任务的 ID，其结构与站点参数相似。您可以在一个请求中输出多个任务，并使用通配符字符（”*”，”？）通过某些任务 ID 模式筛选请求结果。

使用”*”来选择所有任务：
```
Task=*
```
单击所选任务旁边的操作菜单中的编辑，在设备管理器屏幕上登录到您的帐户时，可以找到单个任务号。当下一个屏幕加载时，任务 ID 将因此在 URL 中：
```
https://user.dotcom-monitor.com/task-edit.aspx?id=123456
```
您还可以使用 XML 界面获得配置 .aspx 请求的任务 ID。

可以使用 &将几个可选参数追加到 URL 中，尤其是在轮询具有http://xmlreporter.dotcom-monitor.com/reporting/xml/responses.aspx基本 URL 的响应时：
- 类型=总体
这将提供汇总数据，如起伏/停机时间、成功次数、失败次数、性能数据和标准偏差。
- 类型=小时
此参数将响应聚合为一小时长周期，并显示每小时的统计信息。
- 类型=天
包括指定期间按天数的摘要。
- 类型=周
包括指定期间按周汇总。
- 类型 =季度
This parameter breaks a period into a 3-month (Quarter) period and each “</Summary> … </Summary>” element represents statistical data calculated over 3-month period.
- 类型=月
指定期间按月汇总。
- 类型 =年份
年份 = 指定期间的年汇总。
- 类型=详细信息
它提供请求期间的原始数据。原始数据仅提供过去 6 个月的数据。
- Startofweek=<Monday>
允许用户转移业务周的开始日。例如，您可以将开始一天设置为星期日，如在美国（开始周+星期日），也可以将星期一（周开始=星期一）设置为星期一（周开始=星期一）
- From=<DateAndTime>
这指定报告的开始日期和时间。

对于 美国日期和时间格式， 请使用斜线 “MM/DD/Y H：M：S AM（下午）
对于 欧盟日期和时间格式，请使用破折号 “YY-MM-DD H：M：S”
- To=<DateAndTime>
这指定报告的结束日期和时间。
对于 美国日期和时间格式， 请使用斜线 “MM/DD/Y H：M：S AM（下午）”
对于 欧盟日期和时间格式，请使用破折号 “YY-MM-DD H：M：S”
美国格式：
```
http://xmlreporter.dotcom-monitor.com/reporting/xml/responses.aspx?pid=78799A2394884BA880A4DCAC62AAE90D&Site=70795&Type=overall&from=09/13/2012&to=09/13/2012
```
欧盟格式：
```
http://xmlreporter.dotcom-monitor.com/reporting/xml/responses.aspx?pid=78799A2394884BA880A4DCAC62AAE90D&Site=59106&Type=Detail&from=2012-03-04 15:20:30&to=2012-03-05 15:20:30
```
- 类型 = 一天中小时
This parameter gives responses containing 24 numbered pieces, where each “</Summary> … </Summary>” element matches one exact hour in a day. 统计值（如平均响应时间、响应时间 STDDev、停机时间百分比等）反映在指定时间段内计算的平均值（例如，一周期间）。此参数便于分析小时负载。

此类型仅适用于较长或等于 1 天的报告期。
- 类型 = 状态更改
计算每个块的统计信息，该数据对应于状态更改后的时间长度。 This parameter will make “</Summary> … </Summary>” elements display periods in the same way as in “Uptime/Downtime periods” section of any online report.
- 类型 = 周日
This parameter provides a response containing seven (7) numbered pieces, where each “</Summary> … </Summary>” element matches one exact day in a week. 统计值（如平均响应时间、响应时间 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 Feed 仅显示某些监控代理的结果，请以以下方式将”位置“字符串参数添加到请求 URL 中：

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

代理字符串值的列表：

美国

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

欧洲

伦敦
巴黎
阿姆斯特丹
哥本哈根
法兰克福
华沙
特拉维夫

亚洲、澳大利亚、非洲

孟买
香港
北京
上海
东京
悉尼
布里斯班
约翰内斯堡

选项_注释

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

选项_请求详细信息

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

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

选项=所有向下百分比

包括摘要的所有百分比。

选项=所有时间

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

选项=最新响应

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

数量=< 编号>

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

详细信息_内容

包括点击详细信息内容。

详细信息_HtmlBody

包括命中细节 HtmlBody

详细信息=通用描述

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

详细信息=浏览器操作

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

例子：

https://xmlreporter.dotcom-monitor.com/reporting/xml/responses.aspx?pid=78799A2394884BA880A4DCAC62AAE90D&Site=*&Type=Overall
https://xmlreporter.dotcom-monitor.com/reporting/xml/responses.aspx?pid=78799A2394884BA880A4DCAC62AAE90D&Task=*&Type=Detail

[/]

XML 报告服务（XRS）是一项免费的按需服务，通过 HTTP 请求提供数据。 XML 源以自定义格式为 Web 应用程序和网站提供受监视的设备信息。用例示例包括：ISP 通过网站为客户提供独立的停机时间、性能和最新的服务状态;或数据中心将监视数据与其内部应用程序集成。

通过向具有有效参数
的 xmlreporter.dotcom-monitor.com
发送格式正确的 HTTP （S） GET 请求，您将收到带有所请求数据的 XML 文档（参见文章相应部分中请求参数的规格）。您可以根据需要处理来自 XML 文档的数据。可能性包括将数据导入另一个系统、SQL 数据库、仪表板，或将其发布到 Microsoft Excel 中。

与 Dotcom-Monitor 可共享仪表板和其他类型的内置报告相反，使用 XML Feed，您只能在支持 XML 数据源的其他类型的第三方应用程序中提取您想要处理或在仪表板上看到的参数。例如，您可以从 Dotcom-Monitor 帐户创建特定设备的 Web 性能可视化，并提供最大可用的详细信息级别。灵活的 XRS 框架仅允许您提取对项目最重要的指标。大量 XML Feed 请求参数可用于自定义您的请求 – 您可以选择是想从帐户接收有关监控设备的简短摘要，还是希望获得每个监控设备的整体数据。让我们仔细看看您的数据有多详细。您可以配置接收请求：

汇总数据，如起伏/停机时间、成功次数、失败次数、性能数据和标准偏差。
具有所请求期间（截至过去 6 个月）的原始数据的高详细报告。
响应数据汇总成一小时。
响应数据汇总成 24 小时长的周期，持续一段时间。
指定期间的每周摘要。
3个月期间计算的统计数据。
特定期间按月汇总。
在指定期限内按年汇总。

此外，使用请求参数，您可以指定报告的开始和结束日期和时间。要执行小时和每日负载（平均响应时间、响应时间 STDev、停机时间百分比等）的分析，您可以提取一份报告，其中平均值在指定期间计算（例如一周期间）。

如果您曾经在 Dotcom-Monitor 中为监控设备提取在线报告，您可能会发现使用其”上时间/停机时间”图表很方便。使用 XRS 框架，您还可以收到 XML 报告，其中设备统计数据按上行时间和停机时间段细分。

您还可以将 Dotcom 监控过滤器（配置 > 过滤器）应用到报告中的数据中。使用 > Dotcom-Monitor 帐户中创建的附表（配置附表），您只能发布在特定调度器中指定的期间内收到的结果。

此外，您只能在选择时提取成功或仅失败的响应，通过监控 XML Feed 报告中的位置来筛选报告统计数据等。请参阅本文相应部分中所有可用参数的描述。

将 HTTP 请求配置为 XML 源

XML 源请求是带有多个 GET 参数的 URL，由”&”符号隔开。

XML 请求由以下项组成：
[base_url_address] + [unique_account_uid] + [Site_id] + [parameter1]&[parameter2]…

示例请求：
https://xmlreporter.dotcom-monitor.com/reporting/xml/responses.aspx？皮德+4229AF4F0FB545AEA75EAF2013E51BB7 •网站+12345 和类型=整体 https://xmlreporter.dotcom-monitor.com/reporting/xml/responses.aspx @pid=78799A2394884BA880A4DCAC62AAE90D =57628 |

帐户 UID

要创建 XML 请求，您需要将帐户唯一标识符（UID）用作请求参数 [unique_account_uid] . 当在 > > XML 源集成类型的”配置集成“”唯一标识符（UID）下登录到您的帐户时，可以找到此 ID。

对 XML 馈送请求数量的限制

向 XML 报告服务请求的最大数量为每 10 秒 1 次。

如果您在 10 秒内提交多个请求，XRS 将返回 XML 文档，下一个允许的请求时间如下：

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

XML Response Fields

在本节中，您可以从 Dotcom-监视器 XML 源中查找某些字段上的描述：

<Response> 
<ID>3424533543</ID> 
<Name>Demo request</Name> 
<URL>http://demo.webportal.com/APIv1/json?userid=test;userweight=22;ACT=DASW</URL>
<Monitoring-Date-Time>3/26/2014 12:38:38 PM</Monitoring-Date-Time> 
<Duration>114</Duration>
<DnsTime>0</DnsTime>
<SSLTime>0</SSLTime> 
<ConnectionTime>15</ConnectionTime> 
<RequestTime>0</RequestTime> 
<FirstPacketTime>97</FirstPacketTime> 
<DownloadTime>2</DownloadTime> 
<Status>S</Status> 
<Monitoring-Location>FL, USA</Monitoring-Location> 
</Response>

持续时间 – 完成任务的总时间（基本上 – 以下时间的总和）
DNSTime – 是将主机名（例如www.google.com）解析到数字 IP 地址（例如 216.239.59.99）所需的时间。
SSLTime – 是完成 SSL 握手过程所需的时间。
连接时间– 是创建到 Web 服务器（或代理）的 TCP 连接所需的时间。保持活动连接通常用于避免重复连接到 Web 服务器的开销。
请求时间– 是向服务器发送 HTTP 请求消息所需的时间，取决于发送到服务器的数据量。例如，使用 HTTP POST 上传文件会导致发送时间过长。
第一包时间– （时间到第一字节）时间经过，以开始接收从远程 Web 服务器接收数据。换句话说，请求和响应之间的时间第一个字节收到。
下载时间– 是从服务器读取响应消息所花时间。此值将取决于返回的内容大小、网络带宽以及是否使用了 HTTP 压缩。换句话说，响应第一个和最后一个字节之间的时间。

UID 部

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

使用 XML 报告服务（XRS）工具

帐户.aspx - 帐户包利用

配置.aspx - 网站和任务配置信息

状态.aspx - 设备状态和状态信息

响应.aspx - 响应信息

将 HTTP 请求配置为 XML 源

帐户 UID

对 XML 馈送请求数量的限制

XML Response Fields

解决方案

特征

公司

帐户.aspx - 帐户包利用

配置.aspx - 网站和任务配置信息

状态.aspx - 设备状态和状态信息

响应.aspx - 响应信息

将 HTTP 请求配置为 XML 源

帐户 UID

对 XML 馈送请求数量的限制

XML Response Fields

解决 方案

特征

公司

解决方案