[comment]: # ({9464a98f-9464a98f})
# event.get
[comment]: # ({/9464a98f-9464a98f})
[comment]: # ({46def64c-a2311b6e})
### Descripción
`integer/array event.get(object parameters)`
El método permite recuperar eventos de acuerdo con los parámetros dados.
::: noteimportant
Este método puede devolver eventos de una entidad eliminada.
si estos eventos no han sido eliminados todavía por las
tareas de limpieza.
:::
::: noteclassic
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](/manual/web_interface/frontend_sections/users/user_roles)
para más información.
:::
[comment]: # ({/46def64c-a2311b6e})
[comment]: # ({e1d18a4f-99511e47})
### Parámetros
`(objeto)` Parámetros que definen la salida deseada.
El método admite los siguientes parámetros.
|Parámetro|[Tipo](/manual/api/reference_commentary#data_types)|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 equipos dados.|
|hostids|cadena/matriz|Devuelve solo eventos creados por objetos que pertenecen a los equipos dados.|
|objectids|cadena/matriz|Devuelve solo eventos creados por los objetos dados.|
|source|entero|Devuelve solo eventos con el tipo dado.
Consulte la [página de objeto de evento](objeto#evento) para obtener una lista de los tipos de eventos admitidos.
Valor predeterminado: 0 - desencadenar eventos.|
|object|entero|Devuelve solo eventos creados por objetos del tipo dado.
Consulte la [página de objeto de evento](objeto#evento) para obtener una lista de los tipos de objetos admitidos.
Predeterminado : 0 - iniciador.|
|acknowledged|booleano|Si se establece en "verdadero", devuelve solo eventos reconocidos.|
|suppressed|booleano|`true` - devuelve solo eventos suprimidos;
`false` - devuelve eventos en el estado normal.|
|symptom|booleano|`true` - devuelve solo eventos de síntomas;
`false` - devuelve solo eventos de causa.|
|severities|entero/matriz|Devuelve solo eventos con gravedades de evento determinadas. Se aplica sólo si el objeto es el desencadenante.|
|evaltype|entero|Reglas para la búsqueda de etiquetas.
Valores posibles:
0 - (predeterminado) Y/O;
2 - O.|
|tags|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": "", "value": "", "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.|
|time\_from|marca de tiempo|Devuelve solo los eventos que se han creado después o en el momento dado.|
|time\_till|marca de tiempo|Devuelve solo los eventos que se han creado antes o en el momento dado.|
|problem\_time\_from|marca de tiempo|Devuelve solo eventos que estaban en el 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`.|
|value|entero/matriz|Devuelve solo eventos con los valores dados.|
|selectHosts|query|Devuelve una propiedad [hosts](/manual/api/reference/host/object) con equipos 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](/manual/api/reference/alert/object) 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;
`suppress_until` - `(timestamp)` tiempo hasta que el evento sea suprimido;
`taskid` - `(string)` ID de la tarea si el evento actual está experimentando un cambio de clasificació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 "recuento".|
|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 activos y supresiones manuales:
`maintenanceid` - `(string)` ID del mantenimiento;
`userid` - `(string)` ID del usuario que suprimió el evento;
`suppress_until` - `(entero)` tiempo hasta que se suprime el evento.|
|sortfield|string/array|Ordena el resultado según las propiedades dadas.
Valores posibles: `eventid`, `objectid`, `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](/manual/api/reference_commentary#common_get_method_parameters).|
|editable|booleano|^|
|excludeSearch|booleano|^|
|filter|objeto|^|
|limit|entero|^|
|output|consulta|^|
|preservekeys|booleano|^|
|search|objeto|^|
|searchByAny|booleano|^|
|searchWildcardsEnabled|booleano|^|
|sortorder|cadena/matriz|^|
|startSearch|booleano|^|
[comment]: # ({/e1d18a4f-99511e47})
[comment]: # ({7223bab1-7223bab1})
### Valores de retorno
`(entero/matriz)` Devuelve:
- una matriz de objetos;
- el recuento de objetos recuperados, si el parámetro `countOutput`
ha sido usado.
[comment]: # ({/7223bab1-7223bab1})
[comment]: # ({b41637d2-b41637d2})
### Ejemplos
[comment]: # ({/b41637d2-b41637d2})
[comment]: # ({1ef73364-7bd1e923})
#### Recuperando eventos desencadenantes
Recupere los últimos eventos del activador "13926".
[Solicitud](/manual/api#performing-requests):
```json
{
"jsonrpc": "2.0",
"method": "event.get",
"params": {
"output": "extend",
"select_acknowledges": "extend",
"selectTags": "extend",
"selectSuppressionData": "extend",
"objectids": "13926",
"sortfield": ["clock", "eventid"],
"sortorder": "DESC"
},
"id": 1
}
```
Respuesta:
```json
{
"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",
"cause_eventid": "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",
"suppress_until": "1472511600",
"taskid": "0",
"username": "Admin",
"name": "Zabbix",
"surname": "Administrator"
}
],
"suppression_data": [
{
"maintenanceid": "15",
"suppress_until": "1472511600",
"userid": "0"
}
],
"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",
"cause_eventid": "0",
"opdata": "",
"acknowledges": [],
"suppression_data": [],
"suppressed": "0",
"tags": []
}
],
"id": 1
}
```
[comment]: # ({/1ef73364-7bd1e923})
[comment]: # ({fe090ec0-adbe5436})
#### Recuperar eventos por período de tiempo
Recupera todos los eventos que se han creado entre el 9 y 10 de octubre,
2012, en orden cronológico inverso.
[Solicitud](/manual/api#performing-requests):
```json
{
"jsonrpc": "2.0",
"method": "event.get",
"params": {
"output": "extend",
"time_from": "1349797228",
"time_till": "1350661228",
"sortfield": ["clock", "eventid"],
"sortorder": "desc"
},
"id": 1
}
```
Respuesta:
```json
{
"jsonrpc": "2.0",
"result": [
{
"eventid": "20616",
"source": "0",
"object": "0",
"objectid": "14282",
"clock": "1350477814",
"value": "1",
"acknowledged": "0",
"ns": "0",
"name": "Less than 25% free in the history cache",
"severity": "3",
"r_eventid": "0",
"c_eventid": "0",
"correlationid": "0",
"userid": "0",
"cause_eventid": "0",
"opdata": "",
"suppressed": "0"
},
{
"eventid": "20617",
"source": "0",
"object": "0",
"objectid": "14283",
"clock": "1350477814",
"value": "0",
"acknowledged": "0",
"ns": "0",
"name": "Zabbix trapper processes more than 75% busy",
"severity": "3",
"r_eventid": "0",
"c_eventid": "0",
"correlationid": "0",
"userid": "0",
"cause_eventid": "0",
"opdata": "",
"suppressed": "0"
},
{
"eventid": "20618",
"source": "0",
"object": "0",
"objectid": "14284",
"clock": "1350477815",
"value": "1",
"acknowledged": "0",
"ns": "0",
"name": "High ICMP ping loss",
"severity": "3",
"r_eventid": "0",
"c_eventid": "0",
"correlationid": "0",
"userid": "0",
"cause_eventid": "0",
"opdata": "",
"suppressed": "0"
}
],
"id": 1
}
```
[comment]: # ({/fe090ec0-adbe5436})
[comment]: # ({c6eb3ba0-c6eb3ba0})
### Ver también
- [Alerta](/manual/api/reference/alert/object)
- [Métrica](/manual/api/reference/item/object)
- [Equipo](/manual/api/reference/host/object)
- [Regla LLD](/manual/api/reference/discoveryrule/object#lld_rule)
- [Iniciador](/manual/api/reference/trigger/object)
[comment]: # ({/c6eb3ba0-c6eb3ba0})
[comment]: # ({f85dc7ca-f85dc7ca})
### Fuente
CEvent::get() en *ui/include/classes/api/services/CEvent.php*.
[comment]: # ({/f85dc7ca-f85dc7ca})