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 року, у зворотному хронологічному порядку.