GET /alerts

Contents[Hide]

Obtiene la lista de las alertas existentes en el sistema.


 

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

 

1. Parámetros 

NombreTipoNecesarioValor por defectoDescrpció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).


2. Códigos de respuesta

 

CódigoDescripció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

 

3. 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.

4. 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"}]

 

 

 

 

 

Iniciar sesión

Back to Top