[comment]: # translation:outdated
[comment]: # ({9464a98f-9464a98f})
# event.get
[comment]: # ({/9464a98f-9464a98f})
[comment]: # ({46def64c-a2311b6e})
### Описание
`integer/array event.get(параметры объекта)`
Метод позволяет извлекать события в соответствии с заданными параметрами.
::: noteimportant
Этот метод может возвращать события удаленного объекта, если эти события еще не были удалены служебным процессом очистки истории.
:::
::: noteclassic
Этот метод доступен пользователям любого типа.
Разрешения на вызов метода можно отозвать в настройках ролей пользователя.
Дополнительную информацию см. в разделе [Роли пользователей](/manual/web_interface/frontend_sections/users/user_roles).
:::
[comment]: # ({/46def64c-a2311b6e})
[comment]: # ({new-99511e47})
### Параметр
`(объект)` Параметры задают желаемый вывод.
Этот метод поддерживает следующие параметры.
|Параметр|Тип|Описание|
|----------------|------|----------------|
|eventids|строка/массив|Возврат событий только с заданными ID.|
|groupids|строка/массив|Возврат только тех событий, которые созданы объектами принадлежащими заданным группам узлов сети.|
|hostids|строка/массив|Возврат только тех событий, которые созданы объектами принадлежащими заданным узлам сети.|
|objectids|строка/массив|Возврат только тех событий, которые созданы заданными объектами.|
|applicationids|строка/массив|Возврат только тех событий, которые созданы объектами принадлежащими заданным группам элементов данных. Примеряется только, если объектом являются триггер или элемент данных.|
|source|целое число|Возврат событий только с заданным типом.
Обратитесь к [странице объекта события](object#событие) для получения списка поддерживаемых типов событий.
По умолчанию: 0 - события на триггеры.|
|object|целое число|Возврат только тех событий, которые созданы объектами заданного типа.
Обратитесь к [странице объекта события](object#событие) для получения списка поддерживаемых типов объекта.
По умолчанию: 0 - триггер.|
|acknowledged|логический|Если задано равным `true`, получение только подтвержденных событий.|
|suppressed|логический|`true` - возврат только подавленных событий;
`false` - возврат событий в нормальном состоянии.|
|severities|целое число/массив|Возврат событий только с заданными важностями события. Применяется только, если объектом является триггер.|
|evaltype|целое число|Правила поиска тегов.
Возможные значения:
0 - (по умолчанию) И/Или;
2 - Или.|
|tags|объект|Возврат событий только с заданными тегами. Точное соответствие тегу и не зависимый от регистра поиск по значению и оператору.
Формат: `[{"tag": "<тег>", "value": "<значение>", "operator": "<оператор>"}, ...]`.
По всем событиям возвращается пустой массив.
Возможные типы операторов:
0 - (по умолчанию) Содержит;
1 - Равен.|
|eventid\_from|строка|Возврат только тех событий, ID которых больше или равен заданному ID.|
|eventid\_till|строка|Возврат только тех событий, ID которых меньше или равен заданному ID.|
|time\_from|штамп времени|Возврат только тех событий, которые были созданы после или в заданное время.|
|time\_till|штамп времени|Возврат только тех событий, которые были созданы до или в заданное время.|
|value|целое число/массив|Возврат только тех событий, которые имеют заданные значения.|
|selectHosts|запрос|Возврат узлов сети содержащих объект, который создал событие, в свойстве `hosts`. Поддерживается только для событий, которые сформированы триггерами, элементами данных или правилами LLD.|
|selectRelatedObject|запрос|Возврат объекта, который создал событие, в свойстве `relatedObject`. Тип возвращаемого объекта зависит от типа события.|
|select\_alerts|запрос|Возврат оповещений, которые сгенерированы событием, в свойстве `alerts`. Оповещения отсортированы в обратном хронологическом порядке.|
|select\_acknowledges|запрос|Возврат обновлений событий в свойстве `acknowledges`. Обновления событий отсортированы в обратном хронологическом порядке.
Объект обновления события имеет следующие свойства:
`acknowledgeid` - `(строка)` ID подтверждения;
`userid` - `(строка)` ID пользователя, который обновил событие;
`eventid` - `(строка)` ID обновленного события;
`clock` - `(штамп времени)` время, когда событие было обновлено;
`message` - `(строка)` текст сообщения;
`action` - `(целое число)` действие обновления, которое было выполнено, смотрите [event.acknowledge](/ru/manual/api/reference/event/acknowledge);
`old_severity` - `(целое число)` важность события до этого действия обновления;
`new_severity` - `(целое число)` важность события после этого действия обновления;
`alias` - `(строка)` псевдоним пользователя, который обновил событие;
`name` - `(строка)` имя пользователя, который обновил событие;
`surname` - `(строка)` фамилия пользователя, который обновил событие.
Поддерживается `count`.|
|selectTags|запрос|Возврат тегов событий в свойстве `tags`.|
|selectSuppressionData|запрос|Возврат списка обслуживаний в свойстве `suppression_data`:
`maintenanceid` - *(строка)* ID обслуживания;
`suppress_until` - *(целое число)* время, до которого событие подавлено.|
|sortfield|строка/массив|Сортировка результата в соответствии с заданными свойствами.
Возможные значения: `eventid`, `objectid` и `clock`.|
|countOutput|логический|Эти параметры являются общими для всех методов `get` и они описаны в [справочных комментариях](/ru/manual/api/reference_commentary#общие_параметры_get_метода).|
|editable|логический|^|
|excludeSearch|логический|^|
|filter|объект|^|
|limit|целое число|^|
|output|запрос|^|
|preservekeys|логический|^|
|search|объект|^|
|searchByAny|логический|^|
|searchWildcardsEnabled|логический|^|
|sortorder|строка/массив|^|
|startSearch|логический|^|
[comment]: # ({/new-99511e47})
[comment]: # ({7223bab1-7223bab1})
### Возвращаемые значения
`(целое число/массив)` Возвращает одно из следующих:
- массив объектов;
- количество извлеченных объектов, если использовался параметр `countOutput`.
[comment]: # ({/7223bab1-7223bab1})
[comment]: # ({b41637d2-b41637d2})
### Примеры
[comment]: # ({/b41637d2-b41637d2})
[comment]: # ({1ef73364-7bd1e923})
#### Получение событий триггера
Получение последних событий триггера "13926."
[Запрос](/manual/api#выполнение-запросов):
```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
}
```
Ответ:
```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]: # ({8f7c0ccf-adbe5436})
#### Получение событий за период
Получить все события, которые были созданы в период с 9 по 10 октября
2012 года, в обратном хронологическом порядке.
Запрос:
```json
{
"jsonrpc": "2.0",
"method": "event.get",
"params": {
"output": "extend",
"time_from": "1349797228",
"time_till": "1350661228",
"sortfield": ["clock", "eventid"],
"sortorder": "desc"
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}
```
Ответ:
```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",
"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",
"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",
"opdata": "",
"suppressed": "0"
}
],
"id": 1
}
```
[comment]: # ({/8f7c0ccf-adbe5436})
[comment]: # ({c6eb3ba0-c6eb3ba0})
### Смотрите также¶
- [Оповещение](/manual/api/reference/alert/object)
- [Элемент данных](/manual/api/reference/item/object)
- [Узел сети](/manual/api/reference/host/object)
- [LLD правило](/manual/api/reference/discoveryrule/object#lld_rule)
- [Триггер](/manual/api/reference/trigger/object)
[comment]: # ({/c6eb3ba0-c6eb3ba0})
[comment]: # ({f85dc7ca-f85dc7ca})
### Источник
CEvent::get() в *ui/include/classes/api/services/CEvent.php*.
[comment]: # ({/f85dc7ca-f85dc7ca})