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

另请参阅：

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

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

要发布按要求实时报告，Dotcom 监控器使用 XML 报告服务框架。

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

通过使用有效参数向
xmlreporter.dotcom-monitor.com
发送格式正确的 HTTP（S） GET 请求，您将收到包含所请求数据的 XML 文档。请参阅请求参数说明以拉取实时 XML 报告一文中的请求参数规范。

您可以根据需要处理来自 XML 文档的数据。可能性包括将数据导入另一个系统、SQL 数据库、仪表板，或将其发布到 Microsoft Excel 中。

将 HTTP 请求配置为 XML 源

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

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

示例请求：
https://xmlreporter.dotcom-monitor.com/reporting/xml/responses.aspx ？PID=4229AF4F0FB545AEA75EAF2013E51BB7 & Site=12345& Type=Total https://xmlreporter.dotcom-monitor.com/reporting/xml/responses.aspx ？PID=78799A2394884BA880A4DCAC62AAE90D & Site=57628& Type=Detail&location=NY， USA

帐户 UID

首先，要创建 XML 请求，您需要将帐户唯一标识符（帐户 UID）用作 [account_uid] 在请求参数中。

若要为 XML 源创建 帐户 UID ，请执行以下操作：

登录到您的 Dotcom 监视器根帐户。
转到管理 > 集成， 然后单击 新建集成。
在“ 添加集成 ”窗口中，选择 “XML 源”。
单击 创建集成。
使用为 XML 源集成类型添加的 UID 作为要 mlreporter.dotcom-monitor.com
的请求中的帐户 UID。

如何将部门的数据输出到 XML 源

如果您在帐户中创建了部门，则可以配置 XML 源以提供有关特定部门或多个特定部门的报告。有两种方法可以创建对部门的 XML 请求。

访问权限仅限于特定 Dotcom 监视器部门帐户的用户
只能拉取分配部门的 XML 报告。登录部门帐户后，您可以像往常一样为您的部门创建 帐户 UID 。只需将部门的此 UID 用作所有 xmlreporter.dotcom-monitor.com

请求中的帐户 UID。

有权访问根 Dotcom 监视器帐户的用户
可以使用启用了部门数据访问权限的帐户 UID 以及 xmlreporter.dotcom-monitor.com 请求中的部门帐户 ID 从帐户 中提取特定部门或多个特定部门的数据
：

https://xmlreporter.dotcom-monitor.com/reporting/xml/config.aspx?PID=<Account UID with access to department's data>&Department=<Department Account ID>

各个 部门帐户 ID 分配给每个部门，当登录到帐户设置 > 部门下的 root 帐户时，可以找到该 ID 。

若要为有权访问部门数据的 XML 源创建 帐户 UID ，请执行以下操作：

登录到您的 Dotcom 监视器根帐户。
转到 Manage > 集成，然后单击 新建集成。
在“ 添加集成 ”窗口中，选择“ XML 源”， 选择“ 允许访问部门的数据”。
单击 创建集成。
使用 XML 源（有权访问部门数据）集成类型的 UID 作为请求中的帐户 UID。

例子

此请求将返回 XML，其中包含按具有指定 ID 的部门细分的所有站点和设备的详细信息：

https://xmlreporter.dotcom-monitor.com/reporting/xml/config.aspx?PID=F8F97FD1B7440685F747096B6FFB80&Department=59069&Department=97895&SiteName=*

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

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

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

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

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

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

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