This is a translation of the original English documentation page. Help us make it better.

event.get

Опис

integer/array event.get(object parameters)

Метод дозволяє отримувати події за заданими параметрами.

Цей метод може повертати події видаленої сутності, якщо ці події ще не були видалені службою очистки історії.

Цей спосіб доступний користувачам будь-якого типу. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. Ролі користувача для отримання додаткової інформації.

Параметри

(object) Параметри, що визначають бажаний результат.

Метод підтримує такі параметри.

Параметр Тип Опис
eventids рядок/масив Повертати лише події з указаними ідентифікаторами.
groupids string/array Повертати лише події, створені об’єктами, які належать до вказаних груп хостів.
hostids рядок/масив Повертати лише події, створені об'єктами, які належать даним хостам.
objectids string/array Повертає лише події, створені вказаними об’єктами.
source integer Повертати лише події вказаного типу.

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

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

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

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

Можливі значення:
0 - (за замовчуванням) And/Or;
2 - Or.
теги масив об'єктів Повертати лише події з заданими тегами. Точна відповідність за тегом і пошук без урахування регістру за значенням і оператором.
Формат: [{"tag": "<tag>", "value": "<value>", "operator": "<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 із хостами, що містять об’єкт, який створив подію. Підтримується лише для подій, створених тригерами, елементами або правилами LLD.
selectRelatedObject запит Повернути властивість relatedObject з об’єктом, який створив подію. Тип об'єкта, що повертається, залежить від типу події.
select_alerts query Повернути властивість alerts із сповіщеннями, створеними подією. Сповіщення сортуються у зворотному хронологічному порядку.
select_acknowledges query Повертає властивість acknowledges з оновленнями подій. Оновлення подій сортуються у зворотному хронологічному порядку.

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

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

Можливі значення: eventid, objectid і clock.
countOutput boolean Ці параметри, які є спільними для всіх методів get, детально описано на сторінці довідковий коментар.
редагований логічний
excludeSearch boolean
фільтр об'єкт
ліміт ціле
вивід запит
preservekeys boolean
пошук об'єкт
searchByAny логічний
увімкнено знаки підстановки логічний
порядок сортування рядок/масив
почати пошук логічний

Повернуті значення

(integer/array) Повертає або:

  • масив об'єктів;
  • кількість отриманих об'єктів, якщо використовувався параметр countOutput.

Приклади

Отримання тригерних подій

Отримати останні події з тригера "13926."

Запит:

{
           "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
       }

Відповідь:

{
           "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
       }

Отримання подій за періодом часу

Отримати всі події, які були створені між 9 і 10 жовтня 2012 року, у зворотному хронологічному порядку.

Запит:

{
           "jsonrpc": "2.0",
           "method": "event.get",
           "params": {
               "output": "extend",
               "time_from": "1349797228",
               "time_till": "1350661228",
               "sortfield": ["clock", "eventid"],
               "sortorder": "desc"
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Відповідь:

{
           "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
       }

Дивись також

Джерело

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