请求参数描述以提取实时 XML 报告

在本文的相应部分中查找有关对 x
mlreporter.dotcom-monitor.com
的 HTTP 请求参数的规范。

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

查询参数
- PID=<XML Feed UID>
这是 XML 源的帐户唯一标识符。您可以为 XML Feed 创建新的集成，也可以在“管理>集成”下为 XML Feed 集成类型选择现有 UID。

若要提取有关特定部门的报表，请登录到该部门并添加与 XML 源 集成类型的新集成。然后使用此 XML 源 UID 作为 PID 参数中的 XML 源 UID。

例子：
```
https://xmlreporter.dotcom-monitor.com/reporting/xml/Account.aspx?PID=78799A2394884BA880A4DCAC62AAE90D
```
- 输出格式=json
在查询中使用以 JSON 格式拉取报表。

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

查询参数
- PID=<XML Feed UID>
这是 XML 源的帐户唯一标识符。您可以为 XML Feed 创建新的集成，也可以在“管理>集成”下为 XML Feed 集成类型选择现有 UID。

对于 root 帐户，如果需要拉取有关特定部门或多个部门的报告，请创建 XML 源集成并选择“ 允许访问部门的数据 ”选项。将 XML 源（具有对部门数据的访问权限）集成的 UID 与请求参数中的部门参数结合使用。
- 部门=<部门 ID1>&..&部门=<部门 IDN>
仅与启用了对部门数据的访问的 XML 源 UID 结合使用。您可以在“帐户设置部门”>下找到您的部门 ID。

例：

此请求将返回 XML，其中包含按具有指定 ID 的部门细分的所有站点和设备的详细信息：
```
https://xmlreporter.dotcom-monitor.com/reporting/xml/config.aspx?PID=F8F97FD1B7440685F747096B6FFB80&Department=59069&Department=97895&SiteName=*
```
- 标签= < 标签 > 1。•标签= < 标签>
此参数从列表中至少提取一个标签，拉取所有站点和任务。
- 网站名= < 网站名 > 1。。&选址名= < 网站名>
这是Dotcom-Monitor中的站点（所谓的“设备”）名称列表。您可以使用通配符字符（”*”，”？）通过某些名称模式筛选请求结果：
```
SiteName=goo*
```
使用”*”选择所有站点：
```
SiteName=*
```
- 任务= < 任务 > 1。•任务= < 任务>
这是 Dotcom 监视器中监控任务的 ID，其结构与站点参数相似。您可以在一个请求中输出多个任务，并使用通配符字符（”*”，”？）通过某些任务 ID 模式筛选请求结果。

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

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

status_v1.aspx - 设备状态和状态信息
- http://xmlreporter.dotcom-monitor.com/reporting/xml/status_v1.aspx
这将仅返回所请求设备的状态。请参阅我们 wiki 的设备状态说明一文中对设备状态的简要描述。

查询参数
- PID=<XML Feed UID>
这是 XML 源的帐户唯一标识符。您可以为 XML Feed 创建新的集成，也可以在“管理>集成”下为 XML Feed 集成类型选择现有 UID。

对于 root 帐户，如果需要拉取有关特定部门或多个部门的报告，请创建 XML 源集成并选择“ 允许访问部门的数据 ”选项。将此 XML 源的 UID（具有对部门数据的访问权限）集成与请求参数中的部门参数结合使用。
- 部门=<部门 ID1>&..&部门=<部门 IDN>
仅与启用了对部门数据的访问的 XML 源 UID 结合使用。您可以在“帐户设置部门”>下找到您的部门 ID。

例：

此请求将返回 XML，其中包含在部门内创建的具有指定 ID 的站点和设备上的状态：
```
https://xmlreporter.dotcom-monitor.com/reporting/xml/status_v1.aspx?PID=78799A2394884BA880A4DCAC62AAE90D&Department=123777&Site=*
```
- 标签= < 标签 > 1。•标签= < 标签>
此参数从列表中至少提取一个标签，拉取所有站点和任务。
- 站 < 点=站点 > 1。&选 < 址=网站N>
这是 Dotcom 监视器中的站点（所谓的“设备”）ID 或名称的列表。您可以在一个请求中输出多个站点，并使用通配符字符（”*”，”？）以某些模式筛选请求结果：
```
SiteName=123*
```
使用”*”选择所有站点：
```
Site=*
```
单个站点 ID 可在登录设备管理器屏幕上的帐户时找到，只需单击选定设备旁边的操作菜单中的编辑即可找到。当下一个屏幕加载时，站点 ID 将以如下身份出现在 URL 中：
```
https://user.dotcom-monitor.com/Site-Edit.aspx?id=123456
```
您还可以使用 XML 界面获得带有 配置.aspx 请求的站点 ID。
- 输出格式=json
在查询中使用以 JSON 格式拉取报表。

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

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

查询参数
- PID=<XML Feed UID>
这是 XML 源的帐户唯一标识符。您可以为 XML Feed 创建新的集成，也可以在“管理>集成”下为 XML Feed 集成类型选择现有 UID。

对于 root 帐户，如果需要拉取有关特定部门或多个部门的报告，请创建 XML 源集成并选择“ 允许访问部门的数据 ”选项。将此 XML 源的 UID（具有对部门数据的访问权限）集成与请求参数中的部门参数结合使用。
- 部门=<部门 ID1>&..&部门=<部门 IDN>
仅与启用了对部门数据的访问的 XML 源 UID 结合使用。您可以在“帐户设置部门”>下找到您的部门 ID。

例：

此请求将返回 XML，其中包含在部门内创建的具有指定 ID 的站点和设备上的状态：
```
https://xmlreporter.dotcom-monitor.com/reporting/xml/status.aspx?PID=78799A2394884BA880A4DCAC62AAE90D&Department=123777&Site=*
```
- 标签= < 标签 > 1。•标签= < 标签>
此参数从列表中至少提取一个标签，拉取所有站点和任务。
- 站 < 点=站点 > 1。&选 < 址=网站N>
这是 Dotcom 监视器中的站点（所谓的“设备”）ID 或名称的列表。您可以在一个请求中输出多个站点，并使用通配符字符（”*”，”？）以某些模式筛选请求结果：
```
SiteName=123*
```
使用”*”选择所有站点：
```
Site=*
```
单个站点 ID 可在登录设备管理器屏幕上的帐户时找到，只需单击选定设备旁边的操作菜单中的编辑即可找到。当下一个屏幕加载时，站点 ID 将以如下身份出现在 URL 中：
```
https://user.dotcom-monitor.com/Site-Edit.aspx?id=123456
```
您还可以使用 XML 界面获得带有 配置.aspx 请求的站点 ID。
- 输出格式=json
在查询中使用以 JSON 格式拉取报表。

例子：
```
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=<XML Feed UID>
这是 XML 源的帐户唯一标识符。您可以为 XML Feed 创建新的集成，也可以在“管理>集成”下为 XML Feed 集成类型选择现有 UID。

对于 root 帐户，如果需要拉取有关特定部门或多个部门的报告，请创建 XML 源集成并选择“ 允许访问部门的数据 ”选项。将此 XML 源的 UID（可访问部门的数据）集成与请求参数中的部门参数结合使用。
- 部门=<部门 ID1>&..&部门=<部门 IDN>
仅与启用部门数据的 XML 源 UID 结合使用。您可以在“帐户设置部门”>下找到您的部门 ID。

例：

此请求将返回 XML，其中包含在部门内创建的所有站点和设备上具有指定 ID 的所有站点和设备的摘要数据：
```
https://xmlreporter.dotcom-monitor.com/reporting/xml/responses.aspx?pid=78799A2394884BA880A4DCAC62AAE90D&Department=123777&Site=*&Type=Overall
```
- 标签= < 标签 > 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 的响应时：
- 类型=总体
这将提供摘要数据，例如正常运行时间/停机时间、成功次数、故障次数、性能数据和标准偏差。
- 类型=小时
此参数将响应聚合为一小时长周期，并显示每小时的统计信息。
- 类型=天
包括指定时间段内按天数计算的摘要。
- 类型=周
包括指定时间段内按周列出的摘要。
- 类型 =季度
此参数将期间分为 3 个月（季度）期间，每个 “</摘要> … </摘要>“ 元素表示在 3 个月内计算的统计数据。
- 类型=月
指定期间按月汇总。
- 类型 =年份
年份 = 指定期间的年汇总。
- 类型=详细信息
它提供请求期间的原始数据。原始数据仅提供过去 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>
这提供了根据筛选器规则筛选数据的能力。

登录到您的帐户时，可以在“设备管理器”屏幕的导航菜单中的“管理”、“过滤器”下找到单个过滤器 ID。单击过滤器时，您将在编辑页面的 URL 中看到 ID：
```
https://user.dotcom-monitor.com/Filter-Edit.aspx?id=123456
```
- 计划程序*< 计划ID>
这提供了在特定时间段内排除数据的能力。

登录到您的帐户时，可以在“设备管理器”屏幕的导航菜单中的“管理”、“计划”下找到各个计划 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]...
```
有关代理的字符串值，请查看我们网站上“网络位置 IP 地址”表的“XML 字符串”列。
- 选项_注释
包括与设备关联的自定义注释。
- 选项_请求详细信息
若要包括元素级详细信息（包含在瀑布图中），可以将“选项”标志设置为“请求详细信息”。

包括”扩展 XML 详细信息”。
- 选项=所有向下百分比
包括摘要的所有百分比。
- 选项=所有时间
包括所有总结时间，包括停机、停机时间、未定义时间、加权停机时间和加权停机时间。
- 选项=最新响应
包括分配给所选设备的每个监视位置的最新响应。
- 数量=< 编号>
仅 <包括所选设备的设置数量的> 最后响应。
- 详细信息_内容
包括命中细节内容。
- Details=HtmlBody
包括命中细节 HtmlBody
- 详细信息=通用描述
包括命中详细信息常见描述
- 详细信息=浏览器操作
包括导航正时（如导航开始/结束、重定向、取取、域查找、请求启动、卸载事件、渲染启动）。
- 输出格式=json
在查询中使用以 JSON 格式拉取报表。

例子：
```
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
```

通知日志 - 设备/任务警报通知历史记录
- http://xmlreporter.dotcom-monitor.com/reporting/xml/NotificationLog.aspx
此基本 URL 用于传递请求中的多个参数，如下文参数列表中所述。

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

查询参数
- PID=<XML Feed UID>
这是 XML 源的帐户唯一标识符。您可以为 XML Feed 创建新的集成，也可以在“管理>集成”下为 XML Feed 集成类型选择现有 UID。
- 网站名= < 网站名 > 1。。&选址名= < 网站名>
使用此参数可以在 Dotcom-Monitor 中传递设备名称或要接收其通知日志的设备列表。您可以使用通配符（“*”， “？”）按名称模式筛选请求结果：
```
SiteName=goo*
```
使用“*”从您的Dotcom-Monitor帐户接收所有设备的通知日志：
```
SiteName=*
```
对于 root 帐户，如果需要拉取有关特定部门或多个部门的报告，请创建 XML 源集成并选择“ 允许访问部门的数据 ”选项。将 XML 源（具有对部门数据的访问权限）集成的 UID 与请求参数中的部门参数结合使用。
- 部门=<部门 ID1>&..&部门=<部门 IDN>
仅与启用了对部门数据的访问的 XML 源 UID 结合使用。您可以在“帐户设置部门”>下找到您的部门 ID。

例：

此请求将返回 XML，其中包含按具有指定 ID 的部门细分的所有站点和设备的详细信息：
```
https://xmlreporter.dotcom-monitor.com/reporting/xml/NotificationLog.aspx?PID=F8F97FD1B7440685F747096B6FFB80&Department=59069&Department=97895&SiteName=*
```
- 任务= < 任务 > 1。•任务= < 任务>
这是 Dotcom-Monitor 中监视任务的 ID，其结构类似于 SiteName 参数。您可以在一个请求中拉取多个任务的通知日志，并使用通配符（“*”， “？”）按任务 ID 模式筛选请求结果。

使用”*”来选择所有任务：
```
Task=*
```
单击所选任务旁边的操作菜单中的编辑，在设备管理器屏幕上登录到您的帐户时，可以找到单个任务号。当下一个屏幕加载时，任务 ID 将因此在 URL 中：
```
https://user.dotcom-monitor.com/task-edit.aspx?id=123456
```
您还可以使用 XML 界面获得配置 .aspx 请求的任务 ID。
- 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/NotificationLog.aspx?pid=78799A2394884BA880A4DCAC62AAE90D&SiteName=70795&from=05/13/2022&to=06/13/2022
```
欧盟格式：
```
http://xmlreporter.dotcom-monitor.com/reporting/xml/NotificationLog.aspx?pid=78799A2394884BA880A4DCAC62AAE90D&SiteName=59106&from=2022-03-04 15:20:30&to=2022-03-05 15:20:30
```
- 输出格式=json
在查询中使用以 JSON 格式拉取报表。

示例请求：
```
https://xmlreporter.dotcom-monitor.com/reporting/xml/NotificationLog.aspx?PID=D90A483EE45AD97A4B2FE49878235&SiteName=*&from=06/20/2022&to=06/21/2022
```

代理.aspx - 具有地理坐标的监视位置列表
- http://xmlreporter.dotcom-monitor.com/reporting/xml/agents.aspx
此 URL 将返回帐户中可用的监视位置列表，包括专用代理。该报告包括有关位置名称、描述和地理坐标的信息。

查询参数
- PID=<XML Feed UID>
这是 XML 源的帐户唯一标识符。您可以为 XML Feed 创建新的集成，也可以在“管理>集成”下为 XML Feed 集成类型选择现有 UID。

示例请求：
```
https://xmlreporter.dotcom-monitor.com/reporting/xml/agents.aspx?PID=78799A2394884BA880A4DCAC62AAE90D
```
- 部门=<部门 ID1>&..&部门=<部门 IDN>
如果您的帐户包含部门，您可以在报告中包括特定部门或多个部门专门使用的私人代理列表。为此：
1. 创建一个新的 XML 源集成，并激活“ 允许访问部门的数据 ”选项。
2. 在 PID 参数中使用 XML 源的 UID （有权访问部门数据）。
3. 在部门查询参数中指定部门 ID。您可以在“帐户设置>部门”下找到您的部门 ID。
- 输出格式=json
在查询中使用以 JSON 格式拉取报表。

示例请求：

此请求将返回 XML，其中包含公司主帐户和具有指定 ID 的部门使用的所有监视代理的详细信息：
```
https://xmlreporter.dotcom-monitor.com/reporting/xml/agents.aspx?PID=F8F97FD1B7440685F747096B6FFB80&Department=59069&Department=97895
```
示例报告：

帐户.aspx - 帐户包利用

查询参数

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

查询参数

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

查询参数

过时！status.aspx - 设备状态和状态信息

查询参数

响应.aspx - 响应信息

查询参数

通知日志 - 设备/任务警报通知历史记录

查询参数

代理.aspx - 具有地理坐标的监视位置列表

查询参数