[comment]: # ({9464a98f-9464a98f})
# event.get

[comment]: # ({/9464a98f-9464a98f})

[comment]: # ({5c3d7ad5-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 por el housekeeper todavía.
:::

::: noteclassic
Este método está disponible para usuarios de cualquier tipo.
Los permisos para llamar al método pueden ser revocados en la configuración del rol de usuario.
Consulte [Roles de usuario](/manual/web_interface/frontend_sections/users/user_roles) para más información.
:::

[comment]: # ({/5c3d7ad5-a2311b6e})

[comment]: # ({ce6c21ca-99511e47})
### Parámetros

`(object)` 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|ID/array|Devolver solo los eventos con los IDs indicados.|
|groupids|ID/array|Devolver solo los eventos creados por objetos que pertenezcan a los grupos de host indicados.|
|hostids|ID/array|Devolver solo los eventos creados por objetos que pertenezcan a los hosts indicados.|
|objectids|ID/array|Devolver solo los eventos creados por los objetos indicados.|
|source|integer|Devolver solo los eventos del tipo indicado.<br><br>Consulte la [página del objeto event](object#event) para ver la lista de tipos de eventos soportados.<br><br>Por defecto: 0 - eventos de trigger.|
|object|integer|Devolver solo los eventos creados por objetos del tipo indicado.<br><br>Consulte la [página del objeto event](object#event) para ver la lista de tipos de objetos soportados.<br><br>Por defecto: 0 - trigger.|
|acknowledged|boolean|Si se establece en `true`, devuelve solo los eventos reconocidos.|
|action|integer|Devolver solo los eventos para los que se han realizado las [acciones de actualización de eventos](/manual/api/reference/event/acknowledge#parameters) indicadas. Para varias acciones, utilice la suma de cualquier valor de bitmap aceptable como máscara de bits (por ejemplo, 34 para reconocer y suprimir el evento).|
|action_userids|ID/array|Devolver solo los eventos con los IDs de usuario indicados que realizaron las acciones de actualización de eventos.|
|suppressed|boolean|Si se establece en `true`, devuelve solo los eventos suprimidos.|
|symptom|boolean|Si se establece en `true`, devuelve solo los eventos de síntoma.|
|severities|integer/array|Devolver solo los eventos con las severidades de evento indicadas. Solo se aplica si el objeto es trigger.|
|trigger_severities|integer/array|Devolver solo los eventos con las severidades de trigger indicadas. Solo se aplica si el objeto es trigger.|
|evaltype|integer|[Método de evaluación](/manual/web_interface/frontend_sections/monitoring/problems#using-filter) de etiquetas.<br><br>Valores posibles:<br>0 - *(por defecto)* And/Or;<br>2 - Or.|
|tags|array|Devolver solo los eventos con las etiquetas indicadas.<br>Formato: `[{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...]`.<br>Un array vacío devuelve todos los eventos.<br><br>Valores posibles de [operator](/manual/web_interface/frontend_sections/monitoring/problems#using-filter):<br>0 - *(por defecto)* Contiene;<br>1 - Igual;<br>2 - No contiene;<br>3 - No es igual;<br>4 - Existe;<br>5 - No existe.|
|eventid\_from|string|Devolver solo los eventos con IDs mayores o iguales al ID indicado.|
|eventid\_till|string|Devolver solo los eventos con IDs menores o iguales al ID indicado.|
|time\_from|timestamp|Devolver solo los eventos creados en o después del momento indicado.|
|time\_till|timestamp|Devolver solo los eventos creados en o antes del momento indicado.|
|problem\_time\_from|timestamp|Devuelve solo los eventos que estuvieron en estado de problema desde `problem_time_from` independientemente de su estado actual. Solo se aplica cuando la fuente es un evento de trigger y el objeto es un trigger. Este parámetro es obligatorio si se especifica `problem_time_till`.|
|problem\_time\_till|timestamp|Devuelve solo los eventos que estuvieron en estado de problema hasta `problem_time_till` independientemente de su estado actual. Solo se aplica cuando la fuente es un evento de trigger y el objeto es un trigger. Este parámetro es obligatorio si se especifica `problem_time_from`.|
|value|integer/array|Devolver solo los eventos con los valores indicados.|
|selectAcknowledges|query|Devuelve una propiedad `acknowledges` con las actualizaciones de eventos. Las actualizaciones de eventos se ordenan en orden cronológico inverso.<br><br>El objeto de actualización de evento tiene las siguientes propiedades:<br>`acknowledgeid` - `(ID)` ID del reconocimiento;<br>`userid` - `(ID)` ID del usuario que actualizó el evento;<br>`clock` - `(timestamp)` momento en que se actualizó el evento;<br>`message` - `(string)` texto del mensaje;<br>`action` - `(integer)` acción de actualización que se realizó, ver [`event.acknowledge`](/manual/api/reference/event/acknowledge);<br>`old_severity` - `(integer)` severidad del evento antes de esta acción de actualización;<br>`new_severity` - `(integer)` severidad del evento después de esta acción de actualización;<br>`suppress_until` - `(timestamp)` momento hasta el que el evento estará suprimido;<br>`taskid` - `(ID)` ID de la tarea si el evento actual está experimentando un cambio de rango;<br>`username` - `(string)` nombre de usuario del usuario que actualizó el evento;<br>`name` - `(string)` nombre del usuario que actualizó el evento;<br>`surname` - `(string)` apellido del usuario que actualizó el evento.<br><br>Soporta `count`.|
|selectAlerts|query|Devuelve una propiedad [`alerts`](/manual/api/reference/alert/object) con las alertas generadas por el evento. Las alertas se ordenan en orden cronológico inverso.|
|selectHosts|query|Devuelve una propiedad [`hosts`](/manual/api/reference/host/object) con los hosts que contienen el objeto que creó el evento. Solo se admite para eventos generados por triggers, items 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.|
|selectSuppressionData|query|Devuelve una propiedad `suppression_data` con la lista de mantenimientos activos y supresiones manuales:<br>`maintenanceid` - `(ID)` ID del mantenimiento;<br>`userid` - `(ID)` ID del usuario que suprimió el evento;<br>`suppress_until` - `(integer)` momento hasta el que el evento estará suprimido.|
|selectTags|query|Devuelve una propiedad [`tags`](/manual/api/reference/event/object#event-tag) con las etiquetas del evento.|
|filter|object|Devuelve solo aquellos resultados que coincidan exactamente con el filtro indicado.<br><br>Acepta un objeto, donde las claves son nombres de propiedades y los valores son un único valor o un array de valores con los que comparar.<br><br>No admite propiedades del tipo de datos `text` [data type](/manual/api/reference_commentary#data-types).|
|sortfield|string/array|Ordena el resultado por las propiedades indicadas.<br><br>Valores posibles: `eventid`, `objectid`, `clock`.<br><br>Valores posibles cuando se usa junto con `groupBy`: `objectid`.<br><br>Valores posibles cuando se usa junto con `countOutput` y `groupBy`: `objectid`, `rowscount`.|
|groupBy|string/array|Agrupa los resultados por las propiedades indicadas. Las propiedades especificadas se devolverán en los resultados.<br><br>Valores posibles: `objectid`.|
|countOutput|boolean|Estos parámetros se describen en el [comentario de referencia](/manual/api/reference_commentary#common-get-method-parameters).|
|editable|boolean|^|
|excludeSearch|boolean|^|
|limit|integer|^|
|output|query|^|
|preservekeys|boolean|^|
|search|object|^|
|searchByAny|boolean|^|
|searchWildcardsEnabled|boolean|^|
|sortorder|string/array|^|
|startSearch|boolean|^|

[comment]: # ({/ce6c21ca-99511e47})

[comment]: # ({e9f1f4d9-7223bab1})
### Valores de retorno

`(integer/array)` Devuelve:

- un array de objetos;
- el número de objetos recuperados, si se ha utilizado el parámetro `countOutput`, pero no se ha utilizado el parámetro `groupBy`;
- un array de objetos con resultados de agregación, si se ha utilizado el parámetro `groupBy`.

[comment]: # ({/e9f1f4d9-7223bab1})

[comment]: # ({b41637d2-b41637d2})
### Ejemplos

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({70ce5d87-7bd1e923})
#### Recuperar eventos de disparadores

Recuperar los eventos más recientes del disparador "22395".

[Solicitud](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "event.get",
    "params": {
        "output": "extend",
        "selectAcknowledges": "extend",
        "selectSuppressionData": "extend",
        "selectTags": "extend",
        "objectids": "22395",
        "sortfield": ["clock", "eventid"],
        "sortorder": "DESC"
    },
    "id": 1
}
```

Respuesta:

```json
{
    "jsonrpc": "2.0",
    "result": [
        {
            "eventid": "20",
            "source": "0",
            "object": "0",
            "objectid": "22395",
            "clock": "1728658089",
            "value": "0",
            "acknowledged": "0",
            "ns": "461809482",
            "name": "El promedio de carga es demasiado alto (carga por CPU superior a 1.5 durante 5m)",
            "severity": "0",
            "r_eventid": "0",
            "c_eventid": "0",
            "correlationid": "0",
            "userid": "0",
            "cause_eventid": "0",
            "acknowledges": [],
            "opdata": "Promedios de carga(1m 5m 15m): (1.6328 3.0522 2.2515), # de CPUs: 2",
            "suppression_data": [],
            "suppressed": "0",
            "tags": [
                {
                    "tag": "scope",
                    "value": "capacity"
                },
                {
                    "tag": "scope",
                    "value": "performance"
                },
                {
                    "tag": "component",
                    "value": "cpu"
                },
                {
                    "tag": "class",
                    "value": "os"
                },
                {
                    "tag": "target",
                    "value": "linux"
                }
            ],
            "urls": []
        },
        {
            "eventid": "4",
            "source": "0",
            "object": "0",
            "objectid": "22395",
            "clock": "1728657737",
            "value": "1",
            "acknowledged": "1",
            "ns": "460759366",
            "name": "El promedio de carga es demasiado alto (carga por CPU superior a 1.5 durante 5m)",
            "severity": "3",
            "r_eventid": "20",
            "c_eventid": "0",
            "correlationid": "0",
            "userid": "0",
            "cause_eventid": "0",
            "acknowledges": [
                {
                    "acknowledgeid": "1",
                    "userid": "1",
                    "clock": "1728657938",
                    "message": "Entorno de pruebas. Por favor, ignore esta alerta.",
                    "action": "38",
                    "old_severity": "0",
                    "new_severity": "0",
                    "suppress_until": "1728744338",
                    "taskid": "0",
                    "username": "Admin",
                    "name": "Zabbix",
                    "surname": "Administrator"
                }
            ],
            "opdata": "Promedios de carga(1m 5m 15m): (1.6328 3.0522 2.2515), # de CPUs: 2",
            "suppression_data": [
                {
                    "maintenanceid": "0",
                    "suppress_until": "1728744338",
                    "userid": "1"
                }
            ],
            "suppressed": "1",
            "tags": [
                {
                    "tag": "scope",
                    "value": "capacity"
                },
                {
                    "tag": "scope",
                    "value": "performance"
                },
                {
                    "tag": "component",
                    "value": "cpu"
                },
                {
                    "tag": "class",
                    "value": "os"
                },
                {
                    "tag": "target",
                    "value": "linux"
                }
            ],
            "urls": []
        }
    ],
    "id": 1
}
```

[comment]: # ({/70ce5d87-7bd1e923})

[comment]: # ({c27f3195-adbe5436})
#### Recuperar eventos por periodo de tiempo

Recuperar todos los eventos que se han creado entre el 17 y el 18 de octubre de 2012, en orden cronológico inverso.

[Solicitud](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "event.get",
    "params": {
        "output": "extend",
        "time_from": "1350432000",
        "time_till": "1350518400",
        "sortfield": ["clock", "eventid"],
        "sortorder": "DESC"
    },
    "id": 1
}
```

Respuesta:

```json
{
    "jsonrpc": "2.0",
    "result": [
        {
            "eventid": "20617",
            "source": "0",
            "object": "0",
            "objectid": "14282",
            "clock": "1350477816",
            "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",
            "urls": []
        },
        {
            "eventid": "20616",
            "source": "0",
            "object": "0",
            "objectid": "14281",
            "clock": "1350477814",
            "value": "0",
            "acknowledged": "0",
            "ns": "0",
            "name": "Zabbix trapper processes more than 75% busy",
            "severity": "0",
            "r_eventid": "0",
            "c_eventid": "0",
            "correlationid": "0",
            "userid": "0",
            "cause_eventid": "0",
            "opdata": "",
            "suppressed": "0",
            "urls": []
        },
        {
            "eventid": "20615",
            "source": "0",
            "object": "0",
            "objectid": "14281",
            "clock": "1350477541",
            "value": "1",
            "acknowledged": "0",
            "ns": "0",
            "name": "Zabbix trapper processes more than 75% busy",
            "severity": "3",
            "r_eventid": "20616",
            "c_eventid": "0",
            "correlationid": "0",
            "userid": "0",
            "cause_eventid": "0",
            "opdata": "",
            "suppressed": "0",
            "urls": []
        }
    ],
    "id": 1
}
```

[comment]: # ({/c27f3195-adbe5436})

[comment]: # ({9d95bc7c-by})
#### Recuperar eventos reconocidos por un usuario especificado

Recuperar eventos reconocidos por el usuario con ID=10

[Solicitud](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "event.get",
    "params": {
        "output": "extend",
        "action": 2,
        "action_userids": [10],
        "selectAcknowledges": ["userid", "action"],
        "sortfield": ["eventid"],
        "sortorder": "DESC"
    },
    "id": 1
}
```

Respuesta:

```json
{
    "jsonrpc": "2.0",
    "result": [
        {
            "eventid": "503",
            "source": "0",
            "object": "0",
            "objectid": "23162",
            "clock": "1747212236",
            "value": "1",
            "acknowledged": "1",
            "ns": "413470863",
            "name": "Number of installed packages has been changed",
            "severity": "2",
            "r_eventid": "0",
            "c_eventid": "0",
            "correlationid": "0",
            "userid": "0",
            "cause_eventid": "0",
            "acknowledges": [
                {
                    "userid": "10",
                    "action": "2"
                }
            ],
            "opdata": "",
            "suppressed": "0",
            "urls": []
        }
    ],
    "id": 1
}
```

[comment]: # ({/9d95bc7c-by})

[comment]: # ({dda34e08-5c2aeeb7})
#### Recuperar los triggers principales con el recuento de eventos de problema

Recuperar los 5 triggers principales que tienen las severidades "Warning", "Average", "High" o "Disaster", junto con el número de eventos de problema dentro de un período de tiempo especificado.

[Solicitud](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "event.get",
    "params": {
        "countOutput": true,
        "groupBy": "objectid",
        "source": 0,
        "object": 0,
        "value": 1,
        "time_from": 1672531200,
        "time_till": 1677628800,
        "trigger_severities": [2, 3, 4, 5],
        "sortfield": ["rowscount"],
        "sortorder": "DESC",
        "limit": 5
    },
    "id": 1
}
```

Respuesta:

```json
{
    "jsonrpc": "2.0",
    "result": [
        {
            "objectid": "232124",
            "rowscount": "27"
        },
        {
            "objectid": "29055",
            "rowscount": "23"
        },
        {
            "objectid": "253731",
            "rowscount": "18"
        },
        {
            "objectid": "254062",
            "rowscount": "11"
        },
        {
            "objectid": "23216",
            "rowscount": "7"
        }
    ],
    "id": 1
}
```

[comment]: # ({/dda34e08-5c2aeeb7})

[comment]: # ({ac13b9c8-c6eb3ba0})
### Véase también

- [Alerta](/manual/api/reference/alert/object#alert)
- [Métrica](/manual/api/reference/item/object#item)
- [Equipo](/manual/api/reference/host/object#host)
- [Regla LLD](/manual/api/reference/discoveryrule/object#lld-rule)
- [Servicio](/manual/api/reference/service/object#service)
- [Disparador](/manual/api/reference/trigger/object#trigger)

[comment]: # ({/ac13b9c8-c6eb3ba0})

[comment]: # ({f85dc7ca-f85dc7ca})
### Fuente

CEvent::get() en *ui/include/classes/api/services/CEvent.php*.

[comment]: # ({/f85dc7ca-f85dc7ca})