GET /alerts
Obtiene la lista de alertas presentes
| GET /alerts.json | Obtiene todas las alertas |
| GET /alerts/22.json GET /alerts.json?id=22 |
Obtiene la alerta cuyo id es el 22. |
| GET /alerts.json?deviceip=178.33.211.248 | Obtiene las alertas que cumplen los criterios de filtrado especificados. En este caso las alertas cuyo dispositivo tiene la ip 178.33.211.248 |
Parámetros
| Nombre | Tipo | Necesario | Valor por defecto | Descrpción |
|---|---|---|---|---|
| id | Entero | No | Ninguno | Identificador de la alerta. |
| ack | Entero | No | Ninguno | Indica si tiene ack la alerta (0:no | 1:verde | 2:azul | 3:rojo | 4:naranja 5:amarillo). |
| cause | Texto | No | Ninguno | Causa de la alerta. |
| counter | Entero | No | Ninguno | Número fallos seguidos que se ha dado la alerta. |
| critic | Entero | No | Ninguno | Criticidad del dispositivo sobre el que se da la alerta. |
| date | Entero | No | Ninguno | Fecha en formato timestamp desde que ocurre la alerta. |
| devicedomain | Texto | No | Ninguno | Dominio del dispositivo sobre el que se da la alerta. |
| deviceip | Texto | No | Ninguno | Dirección IP del dispositivo sobre el que se da la alerta. |
| devicename | Texto | No | Ninguno | Nombre del dispositivo sobre el que se da la alerta. |
| event | Texto | No | Ninguno | Evento de la alerta. |
| lastupdate | Texto | No | Ninguno | Fecha en formato humano de la última verificación realizada sobre la alerta. |
| severity | Entero | No | Ninguno | Severidad de la alerta (1:roja | 2:naranja | 3:amarilla | 4:azul). |
| ticket | Entero | No | Ninguno | Identificador del ticket asociado a la alerta (0:sin ticket). |
| type | Texto | No | Ninguno | Tipo de la alerta (snmp | latency | xagent | snmp-trap | syslog | email | api). |
Códigos de respuesta
| Código | Descripción |
|---|---|
| 200 | Resultado correcto |
| 400 | Error en la petición. |
| 401 | Error de autenticación. |
| 403 | Error por falta de permisos. |
| 500 | Error interno del servidor |
Valor devuelto
Devuelve un vector de datos codificado en json.
[{"id":"54","ack":"0","ticket":"0","severity":"2","critic":"50","type":"xagent","date":"1449857857","devicename":"srvest008","devicedomain":"s30labs.com","deviceip":"178.33.211.248","cause":"PROBLEMA CON LOS ANCLAJES","counter":"3916","event":"Ejecutado script: control_totem.pl (RC=0) RCSTR=[OK] Metrica: RESUMEN ESTADO DE ANCLAJES | v1: OK = 5 | v2: Total = 8 | v3: Vandalizados = 2 | v4: NOK = 1 | **ALERTA (v1<[LEVEL1]) (5 < 7)**","lastupdate":"2015-12-14 12:32:42"}]
Los campos se corresponden con los parámetros especificados previamente.
Ejemplos
cnm@cnm-devel:/opt/cnm/onm/api# curl -ki -H "Authorization: 32c47fc221f9b5c0c7b7b500a6e08c83" "https://localhost/onm/api/1.0/alerts.json"
HTTP/1.1 200 OK
Date: Thu, 13 Feb 2014 17:20:42 GMT
Server: Apache/2.2.16 (Debian) PHP/5.3.3-7 with Suhosin-Patch proxy_html/3.0.1
mod_ssl/2.2.16 OpenSSL/0.9.8o mod_perl/2.0.4 Perl/v5.10.1
X-Powered-By: PHP/5.3.3-7
Expires: Thu, 19 Nov 1981 08:52:00 GMT
Cache-Control: no-store, no-cache, must-revalidate, post-check=0, pre-check=0
Pragma: no-cache
:
Vary: Accept-Encoding
Content-Length: 798
Content-Type: text/html; charset=utf-8
[{"id":"54","ack":"0","ticket":"0","severity":"2","critic":"50","type":"xagent","date":"1449857857","devicename":"srvest008","devicedomain":"s30labs.com","deviceip":"178.33.211.248","cause":"PROBLEMA CON LOS ANCLAJES","counter":"3917","event":"Ejecutado script: control_totem.pl (RC=0) RCSTR=[OK] Metrica: RESUMEN ESTADO DE ANCLAJES | v1: OK = 5 | v2: Total = 8 | v3: Vandalizados = 2 | v4: NOK = 1 | **ALERTA (v1<[LEVEL1]) (5 < 7)**","lastupdate":"2015-12-14 12:33:42"},{"id":"37","ack":"0","ticket":"0","severity":"4","critic":"50","type":"snmp","date":"1449619697","devicename":"cnm-demo","devicedomain":"s30labs.com","deviceip":"178.33.211.251","cause":"TRAFICO EN INTERFAZ ","counter":"1349","event":"sin datos OID ifInOctets ifOutOctets (U) (C)","lastupdate":"2015-12-14 12:30:42"}]