Obtenga la API de detalles de tiempo de inactividad


Esta API se utiliza para obtener el uso de datos de tiempo de inactividad de un monitor o un grupo de monitores solicitado por el usuario durante un período de tiempo específico.

Sintaxis

API para respuesta XML

http: // [APM Host]: [APM Port] / AppManager / xml / GetDowntimeDetails? apikey = [API Key] & type = [value] & period = [period] & resourceid = [resourceid] & showFullDetails = true

API para respuesta JSON

http: // [APM Host]: [APM Port] / AppManager / json / GetDowntimeDetails? apikey = [API Key] & type = [value] & period = [period] & resourceid = [resourceid] & showFullDetails = true

Solicitar parámetros

Campo Descripción
Clave API La clave generada mediante la   opción Generar clave de API en la pestaña "Administrador".
resourceid El ID de recurso del monitor, mediante el cual puede hacer ping al host correspondiente al monitor. Puede obtener detalles del tiempo de inactividad para varios identificadores de recursos mediante el uso de valores separados por comas.
período

El período para el que se han solicitado los detalles del tiempo de inactividad:

Periodo: 0 ===> Hoy

Periodo: 3 ===> Ayer

Periodo: 6 ===> Esta semana

Periodo: 1 ===> Últimos 7 días

Periodo: 12 ===> Semana pasada

Periodo: 7 ===> Este mes

Periodo: 2 ===> Últimos 30 días

Periodo: 11 ===> Último mes

Periodo: 9 ===> Este trimestre

Periodo: 8 ===> Este año

Periodo: 5 ===> Último 1 año

tipo El parámetro Tipo se utiliza para enumerar todos los monitores en un tipo de monitor específico. Los valores posibles pueden ser Linux, Windows XP, MYSQL-DB-server, Apache-server, UrlMonitor, Tomcat-server, etc.
showFullDetails Un parámetro opcional que se utiliza para especificar si el usuario necesita detalles del tiempo de inactividad a diario como datos adicionales en respuesta. Los valores son verdaderos o falsos (falso dy predeterminado).

Ejemplos de

Entrada XML

http: // apm-prod1: 9090 / AppManager / xml / GetDowntimeDetails? apikey = c4e547c2330e2eb92d3e7af2362da9e9 & type = windows & period = 6 & resourceid = 10000135 & showFullDetails = true

Respuesta 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- respuesta>

Entrada JSON

http: // apm-prod1: 9090 / AppManager / xml / GetDowntimeDetails? apikey = c4e547c2330e2eb92d3e7af2362da9e9 & type = windows & period = 6 & resourceid = 10000135 & showFullDetails = true

Respuesta 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 "}," código de respuesta ":" 4000 "}

Uso de múltiples identificadores de recursos

Entrada XML

http: // localhost: 9840 / AppManager / xml / GetDowntimeDetails? apikey = 91f1aa274abdeea8ef8e49a1e37ce1be & period = 20 & resourceid = 10000110,10000171,10000108 & showFullDetails = true


Respuesta 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 = " Página de inicio de AppManager "
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 >

Parámetros de respuesta

Campo Descripción
Disponibilidad Mensaje El mensaje RCA de disponibilidad actual del recurso.
SchedulePercent El porcentaje total de tiempo de inactividad programado del recurso.
Nombre para mostrar El nombre para mostrar del recurso.
ResourceId El ID de recurso del monitor, mediante el cual puede hacer ping al host correspondiente al monitor.
UnmanagePercent El porcentaje total de tiempo de inactividad no administrado del recurso.
TotalDownTimeInSecs El número total de segundos de tiempo de inactividad.
Disponibilidad Severidad La gravedad de la disponibilidad actual del recurso.
DownPercent El porcentaje de tiempo de inactividad total del recurso.
UpPercent El porcentaje de tiempo de actividad total del recurso.
Período

El período para el que se han solicitado los detalles del tiempo de inactividad:

Periodo: 0 ===> Hoy

Periodo: 3 ===> Ayer

Periodo: 6 ===> Esta semana

Periodo: 1 ===> Últimos 7 días

Periodo: 12 ===> Semana pasada

Periodo: 7 ===> Este mes

Periodo: 2 ===> Últimos 30 días

Periodo: 11 ===> Último mes

Periodo: 9 ===> Este trimestre

Periodo: 8 ===> Este año

Periodo: 5 ===> Último 1 año

Tiempos de inactividad (se muestran solo cuando se solicitan para FullDetails)
Campo Descripción
Fecha Representa la fecha para la que se calculan los siguientes detalles
DownPercent Porcentaje de tiempo de inactividad arriba para el campo de fecha anterior
SchedulePercent Porcentaje de tiempo de inactividad programado arriba para el campo de fecha anterior
UpPercent Porcentaje de disponibilidad arriba para el campo de fecha anterior
UnmanagePercent Porcentaje no administrado arriba para el campo de fecha anterior
DowntimeSummary
(Aparece solo si hay un tiempo de inactividad en esa fecha)
Campo Descripción
DownTimeMillis Tiempo de inactividad total en milisegundos
ex: 1342381696674
UpTime Formateado Hora en la que el recurso subió después de estar inactivo durante un período.
Ej .: 3:28:42 PM
Falta del tiempo Formateado Hora a la que se redujo el recurso.
Ej .: 1:18:17 AM
TotalDownTime Tiempo de inactividad total en horas, minutos y segundos, por
ejemplo: 14 horas 10 minutos 25 segundos
ReasonID Id. De motivo para el motivo de tiempo de inactividad mencionado a continuación. (-1 si no hay información disponible para el tiempo de inactividad)
Downtime_Reason Se produjo el motivo del tiempo de inactividad.
Ej: La interrupción se debe a la fuente de alimentación.

No hay información disponible. : si no se menciona ninguna razón