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=78799A2394884BA880A4DCAC62AAE90D  =57628  | 

帐户 UID

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

可用的请求组件

帐户.aspx - 返回帐户包利用率
  • http://xmlreporter.dotcom-monitor.com/reporting/xml/Account.aspx

这将返回所选帐户的利用历史记录,并列出解决方案的细目。 该报告包括关于包容量和每个包的使用资源的信息。 对于根帐户,将包括部门包利用率。

参数:

  • PID= <帐户 UID>

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

例子:

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

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

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

参数:

  • PID= <ID>

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

  • Site=<Site1>&..&Site=<SiteN> OR Site=* – Sites list

这是网站指示列表。 在网络监视器中也称为”设备”。 单击所选设备旁边的操作菜单中的编辑,在设备管理器屏幕上登录到您的帐户时,可以找到单个设备指示。 加载下一个屏幕时,设备 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=78799A2394884BA880A4DCAC62AAE90D&Site=*

responses.aspx - returns responses information
  • http://xmlreporter.dotcom-monitor.com/reporting/xml/responses.aspx

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

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

参数:

  • PID=<Account UID>

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

  • Site=<Site1>&..&Site=<SiteN> OR Site=* – Sites list

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

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

id=123456

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

  • Task=<Task1>&..&Task=<TaskN> OR Task=* – Tasks list

这是任务的 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 的响应时:

  • 类型=总体

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

  • 类型=小时

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

  • 类型=天

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

  • 类型=周

包括指定期间按周汇总。

  • 类型 =季度

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 源仅显示来自某些监视代理的结果,请以下列方式向请求 URL 添加”&Location”字符串参数:

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

[/]
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=78799A2394884BA880A4DCAC62AAE90D&SiteName=em*&Type=Task
https://xmlreporter.dotcom-monitor.com/reporting/xml/config.aspx?pid=78799A2394884BA880A4DCAC62AAE90D&SiteName=*&Type=Task&Type=Field

XML Response Fields

例子:

<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。