event.get

Descripción

integer/array event.get(object parameters)

El método permite recuperar eventos de acuerdo con los parámetros dados.

Este método puede devolver eventos de una entidad eliminada. si estos eventos no han sido eliminados todavía por las tareas de limpieza.

Este método está disponible para usuarios de cualquier tipo. Los `ermisos para llamar al método se pueden revocar en la configuración de roles de usuario. Ver Roles de usuario para más información.

Parámetros

(objeto) Parámetros que definen la salida deseada.

El método admite los siguientes parámetros.

Parámetro	Tipo	Descripción
eventids	cadena/matriz	Devuelve solo eventos con los ID proporcionados.
groupids	cadena/matriz	Devuelve solo eventos creados por objetos que pertenecen a los grupos de hosts dados.
hostids	cadena/matriz	Devuelve solo eventos creados por objetos que pertenecen a los hosts dados.
objectids	cadena/matriz	Devuelve solo eventos creados por los objetos dados.
fuente	integer	Devuelve solo eventos con el tipo dado. Consulte la página de objeto de evento para obtener una lista de los tipos de eventos admitidos. Valor predeterminado: 0 - desencadenar eventos.
objeto	entero	Devuelve solo eventos creados por objetos del tipo dado. Consulte la página de objeto de evento para obtener una lista de los tipos de objetos admitidos. Predeterminado : 0 - disparador.
reconocido	booleano	Si se establece en "verdadero", devuelve solo eventos reconocidos.
suprimido	booleano	`true` - devuelve solo eventos suprimidos; `false` - devuelve eventos en el estado normal.
severidades	integer/array	Devuelve solo eventos con gravedades de evento determinadas. Se aplica sólo si el objeto es el desencadenante.
evaltype	integer	Reglas para la búsqueda de etiquetas. Valores posibles: 0 - (predeterminado) Y/O; 2 - O.
etiquetas	matriz de objetos	Devuelve solo eventos con etiquetas dadas. Coincidencia exacta por etiqueta y búsqueda que no distingue entre mayúsculas y minúsculas por valor y operador. Formato: `[{"tag": "<tag>", "value": "<value>", "operator": "<operator> "}, ...]`. Una matriz vacía devuelve todos los eventos. Tipos de operadores posibles: 0 - (predeterminado) Me gusta; 1 - Igual; 2 - No me gusta; 3 - No es igual 4 - Existe; 5 - No existe.
eventid_from	string	Devuelve solo eventos con ID mayores o iguales al ID proporcionado.
eventid_till	string	Devuelve solo eventos con ID menores o iguales al ID proporcionado.
hora_desde	marca de tiempo	Devuelve solo los eventos que se han creado después o en el momento dado.
time_till	timestamp	Devuelve solo los eventos que se han creado antes o en el momento dado.
problem_time_from	timestamp	Devuelve solo eventos que estaban en estado de problema comenzando con `problem_time_from`. Se aplica solo si la fuente es un evento desencadenante y el objeto es un desencadenante. Obligatorio si se especifica `problem_time_till`.
problem_time_till	marca de tiempo	Devuelve solo eventos que estaban en estado de problema hasta `problem_time_till`. Se aplica solo si la fuente es un evento desencadenante y el objeto es un desencadenante. Obligatorio si se especifica `problem_time_from`.
valor	entero/matriz	Devuelve solo eventos con los valores dados.
selectHosts	query	Devuelve una propiedad hosts con hosts que contienen el objeto que creó el evento. Solo se admite para eventos generados por activadores, elementos o reglas LLD.
selectRelatedObject	query	Devuelve una propiedad `relatedObject` con el objeto que creó el evento. El tipo de objeto devuelto depende del tipo de evento.
select_alerts	query	Devuelve una propiedad alerts con alertas generadas por el evento. Las alertas se clasifican en orden cronológico inverso.
select_acknowledges	query	Devuelve una propiedad `acknowledges` con actualizaciones de eventos. Las actualizaciones de eventos se ordenan en orden cronológico inverso. El objeto de actualización de eventos tiene las siguientes propiedades: `acknowledgeid` - `(string)` ID de reconocimiento; `userid` - `(string)` `ID del usuario que actualizó el evento;`eventid`-`(string)`ID del evento actualizado;`clock`-`(timestamp)`hora en que se actualizó el evento;`message`-`(string)`texto del mensaje;`action`-`(integer)`acción de actualización que se realizó ver [event.acknowledge](/manual/api/reference/event/acknowledge);`old_severity`-`(integer)`gravedad del evento antes de esta acción de actualización;`new_severity`-`(integer)`gravedad del evento después de esta acción de actualización;`username`-`(string)`nombre de usuario del usuario que actualizó el evento;`nombre`-`(cadena)`nombre del usuario que actualizó el evento;`apellido`-`(cadena)`apellido del usuario que actualizó el evento . Admite`count`.\| \|selectTags\|query\|Devuelve una propiedad [tags](/manual/api/reference/event/object#Event_tag) con etiquetas de evento.\| \|selectSuppressionData\|query\|Devuelve una propiedad`suppression_data`con la lista de mantenimientos:`maintenanceid`-`(string)`ID del mantenimiento;`suppress_until`-`(integer)`tiempo hasta el evento está suprimido.\| \|sortfield\|string/array\|Ordena el resultado según las propiedades dadas. Los valores posibles son:`eventid`,`objectid`y`clock`.\| \|countOutput\|boolean\|Estos parámetros, que son comunes para todos los métodos`get`, se describen en detalle en la página comentario de referencia.
editable	booleano
excluirBuscar	booleano
filtro	objeto
límite	entero
salida	consulta
preservekeys	booleano
buscar	objeto
searchByAny	booleano
searchWildcardsEnabled	booleano
clasificación	cadena/matriz
iniciarBuscar	booleano

Valores de retorno

(entero/matriz) Devuelve:

una matriz de objetos;
el recuento de objetos recuperados, si el parámetro countOutput ha sido usado.

Ejemplos

Recuperando eventos de iniciador

Recupere los últimos eventos del iniciador "13926".

Solicitud:

{
           "jsonrpc": "2.0",
           "method": "event.get",
           "params": {
               "output": "extend",
               "select_acknowledges": "extend",
               "selectTags": "extend",
               "selectSuppressionData": "extend",
               "objectids": "13926",
               "sortfield": ["clock", "eventid"],
               "sortorder": "DESC"
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Respuesta:

{
           "jsonrpc": "2.0",
           "result": [
               {
                   "eventid": "9695",
                   "source": "0",
                   "object": "0",
                   "objectid": "13926",
                   "clock": "1347970410",
                   "value": "1",
                   "acknowledged": "1",
                   "ns": "413316245",
                   "name": "MySQL is down",
                   "severity": "5",
                   "r_eventid": "0",
                   "c_eventid": "0",
                   "correlationid": "0",
                   "userid": "0",
                   "opdata": "",
                   "acknowledges": [
                       {
                           "acknowledgeid": "1",
                           "userid": "1",
                           "eventid": "9695",
                           "clock": "1350640590",
                           "message": "Problem resolved.\n\r----[BULK ACKNOWLEDGE]----",
                           "action": "6",
                           "old_severity": "0",
                           "new_severity": "0",
                           "username": "Admin",
                           "name": "Zabbix",
                           "surname": "Administrator"
                       }
                   ],
                   "suppression_data": [
                       {
                           "maintenanceid": "15",
                           "suppress_until": "1472511600"
                       }
                   ],
                   "suppressed": "1",
                   "tags": [
                       {
                           "tag": "service",
                           "value": "mysqld"
                       },
                       {
                           "tag": "error",
                           "value": ""
                       }
                   ]
               },
               {
                   "eventid": "9671",
                   "source": "0",
                   "object": "0",
                   "objectid": "13926",
                   "clock": "1347970347",
                   "value": "0",
                   "acknowledged": "0",
                   "ns": "0",
                   "name": "Unavailable by ICMP ping",
                   "severity": "4",
                   "r_eventid": "0",
                   "c_eventid": "0",
                   "correlationid": "0",
                   "userid": "0",
                   "opdata": "",
                   "acknowledges": [],
                   "suppression_data": [],
                   "suppressed": "0",
                   "tags": []
               }
           ],
           "id": 1
       }

Recuperar eventos por período de tiempo

Recupera todos los eventos que se han creado entre el 9 y 10 de octubre de 2012, en orden cronológico inverso.