此API用于获取特定时间段内用户请求的监视器或业务组的停机时间数据使用。
XML响应API
http://[ APM Host ]:[ APM Port ]/AppManager/xml/GetDowntimeDetails?apikey=[API Key ]&type=[value]&period=[period]&resourceid=[resourceid]&showFullDetails=true
JSON响应API
http://[ APM Host ]:[ APM Port ]/AppManager/json/GetDowntimeDetails?apikey=[API Key ]&type=[value]&period=[period]&resourceid=[resourceid]&showFullDetails=true
| 字段 | 描述 |
|---|---|
| apikey | 使用管理标签中的生成API密钥选项生成的密钥。 |
| resourceid | 监视器的resourceid，通过它您可以对与该监视器相对应的主机执行ping操作。您可以使用逗号分隔的值来获取多个resourceid的停机时间详细信息。 |
| period | 已请求停机时间详细信息的时间段： 时间段：0 ===>今天 时间段：3 ===>昨天 时间段：6 ===>本周 时间段：1 ===>最近7天 时间段：12 ===>上周 时间段：7 ===>本月 时间段：2 ===>最近30天 时间段：11 ===>上个月 时间段：9 ===>此季度 时间段：8 ===>今年 时间段：5 ===>最近1年 |
| type | Type参数用于列出指定监视器类型中的所有监视器。可能的值可以是Linux，Windows XP，MYSQL-DB服务器，Apache服务器，Url监视器，Tomcat服务器等。 |
| showFullDetails | 可选参数，用于指定用户是否每天需要停机时间详细信息作为响应中的其他数据。值是true或false（默认为false）。 |
XML 输入
http://apm-prod1:9090/AppManager/xml/GetDowntimeDetails?apikey=c4e547c2330e2eb92d3e7af2362da9e9&type=windows&period=6&resourceid=10000135&showFullDetails=true
XML 响应
<AppManager-response uri="/AppManager/xml/GetDowntimeDetails"> <result> <response response-code="4000"> <Monitor AvailabilityMessage="-" AvailabilitySeverity="-"DisplayName="app-centos5-64- 2" DownPercent="0.12" Period="20"ResourceId="10000143" SchedulePercent="0.0"TotalDownTimeInSecs="300" UnmanagePercent="0.0" UpPercent="99.88"/> </response> </result> </AppManager-response>
JSON输入
http://apm-prod1:9090/AppManager/xml/GetDowntimeDetails?apikey=c4e547c2330e2eb92d3e7af2362da9e9&type=windows&period=6&resourceid=10000135&showFullDetails=true
JSON响应
{"response":{"result":[{"AvailabilityMessage":"-","SchedulePercent":"0.0","DisplayName":"appcentos5-64-2","ResourceId":"10000143","UnmanagePercent":"0.0",
"AvailabilitySeverity":"-","TotalDownTimeInSecs":"300","DownPercent":"0.12","UpPercent":"99.88","Period":"20"}],"uri":"/AppManager/json/GetDowntimeDetails"},"response-code":"4000"}
XML 输入
http://localhost:9840/AppManager/xml/GetDowntimeDetails?apikey=91f1aa274abdeea8ef8e49a1e37ce1be&period=20&resourceid=10000110,10000171,10000108&showFullDetails=true
XML 响应
<AppManager-response uri="/AppManager/xml/GetDowntimeDetails">
<result>
<response response-code="4000">
<Monitor AvailabilityMessage="-" AvailabilitySeverity="-" DisplayName="172.24.116.154_PGSQL"
DownPercent="0.0" Period="20" ResourceId="10000108" SchedulePercent="0.0"
TotalDownTimeInSecs="0" UnmanagePercent="0.0" UpPercent="100.0"/>
<Monitor AvailabilityMessage="-" AvailabilitySeverity="-" DisplayName="AppManager Home Page"
DownPercent="0.0" Period="20" ResourceId="10000110" SchedulePercent="0.0"
TotalDownTimeInSecs="0" UnmanagePercent="0.0" UpPercent="100.0"/>
<Monitor AvailabilityMessage="-" AvailabilitySeverity="-" DisplayName="Localhost"
DownPercent="0.0" Period="20" ResourceId="10000171" SchedulePercent="0.0"
TotalDownTimeInSecs="0" UnmanagePercent="0.0" UpPercent="100.0"/>
</response>
</result>
</AppManager-response>
| 字段 | 描述 | ||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| AvailabilityMessage | 资源的当前可用性RCA消息。 | ||||||||||||||||||||||||||||
| SchedulePercent | 资源的计划的总停机时间百分比。 | ||||||||||||||||||||||||||||
| DisplayName | 资源的显示名称。 | ||||||||||||||||||||||||||||
| ResourceId | 监视器的resourceid，通过它您可以对与该监视器相对应的主机执行ping操作。 | ||||||||||||||||||||||||||||
| Unmanage％ | 资源的总非托管停机时间百分比。 | ||||||||||||||||||||||||||||
| TotalDownTimeInSecs | 停机总秒数。 | ||||||||||||||||||||||||||||
| AvailabilitySeverity | 资源的当前可用性严重级别。 | ||||||||||||||||||||||||||||
| DownPercent | 资源的总停机时间百分比。 | ||||||||||||||||||||||||||||
| UpPercent | 资源的总正常运行时间百分比。 | ||||||||||||||||||||||||||||
| Period | 已请求停机时间详细信息的时间段： 时间段：0 ===>今天 时间段：3 ===>昨天 时间段：6 ===>本周 时间段：1 ===>最近7天 时间段：12 ===>上周 时间段：7 ===>本月 时间段：2 ===>最近30天 时间段：11 ===>上个月 时间段：9 ===>此季度 时间段：8 ===>今年 时间段：5 ===>最近1年 |
||||||||||||||||||||||||||||
| Downtimes （仅在要求完整详情时显示） |
|
