[comment]: # translation:outdated [comment]: # ({9464a98f-9464a98f}) # event.get [comment]: # ({/9464a98f-9464a98f}) [comment]: # ({120724de-a2311b6e}) ### Опис `integer/array event.get(object parameters)` Метод дозволяє отримувати події за заданими параметрами. ::: noteimportant Цей метод може повертати події видаленої сутності, якщо ці події ще не були видалені службою очистки історії. ::: ::: noteclassic Цей спосіб доступний користувачам будь-якого типу. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. [Ролі користувача](/manual/web_interface/frontend_sections/administration/user_roles) для отримання додаткової інформації. ::: [comment]: # ({/120724de-a2311b6e}) [comment]: # ({f6a98b91-99511e47}) ### Параметри `(object)` Параметри, що визначають бажаний результат. Метод підтримує такі параметри. |Параметр|[Тип](/manual/api/reference_commentary#data_types)|Опис| |--|--|------| |eventids|рядок/масив|Повертати лише події з указаними ідентифікаторами.| |groupids|string/array|Повертати лише події, створені об’єктами, які належать до вказаних груп хостів.| |hostids|рядок/масив|Повертати лише події, створені об'єктами, які належать даним хостам.| |objectids|string/array|Повертає лише події, створені вказаними об’єктами.| |source|integer|Повертати лише події вказаного типу.

Перегляньте [сторінку об’єкта події](object#event), щоб переглянути список підтримуваних типів подій.

За замовчуванням: 0 - запускати події.| |object|integer|Повертати лише події, створені об’єктами заданого типу.

Перегляньте [сторінку об’єкта події](object#event), щоб переглянути список підтримуваних типів об’єктів.

За замовчуванням : 0 - тригер.| |acknowledged|boolean|Якщо встановлено значення `true` повертає лише підтверджені події.| |suppressed|boolean|`true` - повертає лише пригнічені події;
`false` - повертає події в нормальному стані.| |серйозності|ціле число/масив|Повертати лише події із заданим рівнем серйозності. Застосовується, лише якщо об’єкт є тригером.| |evaltype|integer|Правила пошуку тегів.

Можливі значення:
0 - (за замовчуванням) And/Or;
2 - Or.| |теги|масив об'єктів|Повертати лише події з заданими тегами. Точна відповідність за тегом і пошук без урахування регістру за значенням і оператором.
Формат: `[{"tag": "", "value": "", "operator": " "}, ...]`.
Порожній масив повертає всі події.

Можливі типи операторів:
0 - (за замовчуванням) Подібно;
1 - Дорівнює;
2 - Не схоже;
3 - Не дорівнює
4 - Існує;
5 - Не існує.| |eventid\_from|рядок|Повертати лише події з ідентифікаторами, більшими або рівними вказаному ідентифікатору.| |eventid\_till|рядок|Повертати лише події з ідентифікаторами, меншими або рівними вказаному ідентифікатору.| |time\_from|timestamp|Повертати лише події, які були створені після або в заданий час.| |time\_till|timestamp|Повертати лише події, які були створені до або в заданий час.| |problem\_time\_from|timestamp|Повертає лише події, які були у стані проблеми, починаючи з `problem_time_from`. Застосовується, лише якщо джерелом є тригерна подія, а об’єктом є тригер. Обов’язковий, якщо вказано `problem_time_till`.| |problem\_time\_till|timestamp|Повертає лише події, які були в проблемному стані до `problem_time_till`. Застосовується, лише якщо джерелом є тригерна подія, а об’єктом є тригер. Обов’язковий, якщо вказано `problem_time_from`.| |значення|ціле число/масив|Повертати лише події із заданими значеннями.| |selectHosts|запит|Повертає властивість [hosts](/manual/api/reference/host/object) із хостами, що містять об’єкт, який створив подію. Підтримується лише для подій, створених тригерами, елементами або правилами LLD.| |selectRelatedObject|запит|Повернути властивість `relatedObject` з об’єктом, який створив подію. Тип об'єкта, що повертається, залежить від типу події.| |select\_alerts|query|Повернути властивість [alerts](/manual/api/reference/alert/object) із сповіщеннями, створеними подією. Сповіщення сортуються у зворотному хронологічному порядку.| |select\_acknowledges|query|Повертає властивість `acknowledges` з оновленнями подій. Оновлення подій сортуються у зворотному хронологічному порядку.

Об’єкт оновлення подій має такі властивості:
`acknowledgeid` - `(рядок)` ідентифікатор підтвердження;
`userid` - `(рядок) ` ID користувача, який оновив подію;
`eventid` - `(рядок)` ID оновленої події;
`clock` - `(timestamp)` час оновлення події;
`message` - `(рядок)` текст повідомлення;
`action` - `(ціле число)` оновлення дії, яка була виконана див. [event.acknowledge](/manual/api/reference/event/acknowledge);
`old_severity` - серйозність події `(ціле)` до цієї дії оновлення;
`new_severity` - серйозність події `(ціле)` після цієї дії оновлення;
`ім'я користувача` - `(рядок)` ім'я користувача, який оновив подію;
`name` - `(рядок)` ім'я користувача, який оновив подію;
`прізвище` - `(рядок)` прізвище користувача, який оновив подію .

Підтримує `count`.| |selectTags|запит|Повернути властивість [tags](/manual/api/reference/event/object#Event_tag) із тегами подій.| |selectSuppressionData|запит|Повертає властивість `suppression_data` зі списком обслуговування:
`maintenanceid` - `(рядок)` ID обслуговування;
`suppress_until` - `(ціле)` час до події придушується.| |sortfield|string/array|Відсортуйте результат за заданими властивостями.

Можливі значення: `eventid`, `objectid` і `clock`.| |countOutput|boolean|Ці параметри, які є спільними для всіх методів `get`, детально описано на сторінці [довідковий коментар](/manual/api/reference_commentary#common_get_method_parameters).| |редагований|логічний|^| |excludeSearch|boolean|^| |фільтр|об'єкт|^| |ліміт|ціле|^| |вивід|запит|^| |preservekeys|boolean|^| |пошук|об'єкт|^| |searchByAny|логічний|^| |увімкнено знаки підстановки|логічний|^| |порядок сортування|рядок/масив|^| |почати пошук|логічний|^| [comment]: # ({/f6a98b91-99511e47}) [comment]: # ({7223bab1-7223bab1}) ### Повернуті значення `(integer/array)` Повертає або: - масив об'єктів; - кількість отриманих об'єктів, якщо використовувався параметр `countOutput`. [comment]: # ({/7223bab1-7223bab1}) [comment]: # ({b41637d2-b41637d2}) ### Приклади [comment]: # ({/b41637d2-b41637d2}) [comment]: # ({8b2331e9-7bd1e923}) #### Отримання тригерних подій Отримати останні події з тригера "13926." Запит: ```json { "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 } ``` Відповідь: ```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", "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 } ``` [comment]: # ({/8b2331e9-7bd1e923}) [comment]: # ({dc3a7eb7-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]: # ({/dc3a7eb7-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})