Documentation

Sidebar

Zabbix Summit 2022
View presentations

problem.get

Описание

целое число/массив problem.get(объект параметры)

Этот метод позволяет получать проблемы в соответствии с заданными параметрами.

Параметры

(объект) Параметры задают желаемый вывод.

Этот метод поддерживает следующие параметры.

Параметр Тип Описание
eventids строка/массив Возврат проблем только с заданными ID.
groupids строка/массив Возврат только тех проблем, которые созданы объектами принадлежащими заданным группам узлов сети.
hostids строка/массив Возврат только тех проблем, которые созданы объектами принадлежащими заданным узлам сети.
objectids строка/массив Возврат только тех проблем, которые созданы заданными объектами.
applicationids строка/массив Возврат только тех проблем, которые созданы объектами принадлежащими заданным группам элементов данных. Применяется только, если объектом являются триггер или элемент данных.
source целое число Возврат проблем только с заданным типом.

Обратитесь к странице объекта события о проблеме для получения списка поддерживаемых типов событий.

По умолчанию: 0 - проблема с триггеров.
object целое число Возврат только тех проблем, которые созданы объектами заданного типа.

Обратитесь к странице объекта события о проблеме для получения списка поддерживаемых типов объекта.

По умолчанию: 0 - триггер.
acknowledged логический true - возврат только подтвержденных проблем;
false - только неподтвержденные.
severities целое число/массив Возврат проблем только с заданными важностями триггера. Применяется только, если объектом является триггер.
tags массив объектов Возврат проблем только с заданными тегами. Точное соответствие тегу и не зависимый от регистра поиск по значению.
Формат: [{"tag": "<тег>", "value": "<значение>"}, ...].
По всем проблемам возвращается пустой массив.
recent строка true - возврат ПРОБЛЕМА и недавно РЕШЁННЫХ проблем (зависит от Отображать триггеры в состоянии ОК в течении N секунд)
По умолчанию: false - только НЕРЕШЕННЫЕ проблемы
eventid_from строка Возврат только тех проблем, ID которых больше или равен заданному ID.
eventid_till строка Возврат только тех проблем, ID которых меньше или равен заданному ID.
time_from штамп времени Возврат только тех проблем, которые были созданы после или в заданное время.
time_till штамп времени Возврат только тех проблем, которые были созданы до или в заданное время.
selectAcknowledges запрос Возврат подтверждений проблемы в свойстве acknowledges. Подтверждения отсортированы в обратном хронологическом порядке.

Объект подтверждения проблемы имеет следующие свойства:
acknowledgeid - (строка) ID подтверждения;
userid - (строка) ID пользователя, который подтвердил событие;
eventid - (строка) ID подтвержденного события;
clock - (штамп времени) время, когда событие было подтверждено;
message - (строка) текст сообщения подтверждения.

Поддерживается count.
selectTags запрос Возврат тегов проблем. Формат вывода: [{"tag": "<тег>", "value": "<значение>"}, ...].
sortfield строка/массив Сортировка результата в соответствии с заданными свойствами.

Возможные значения: eventid.
countOutput флаг Эти параметры являются общими для всех методов get и они описаны в справочных комментариях.
editable логический
excludeSearch флаг
filter объект
limit целое число
output запрос
preservekeys флаг
search объект
searchByAny логический
searchWildcardsEnabled логический
sortorder строка/массив
startSearch флаг

Возвращаемые значения

(целое число/массив) Возвращает либо:

  • массив объектов;
  • количество найденных объектов, если используется параметр countOutput.

Примеры

Получение событий о проблемах на триггеры

Получение недавних событий с триггера "15112."

Запрос:

{
           "jsonrpc": "2.0",
           "method": "problem.get",
           "params": {
               "output": "extend",
               "selectAcknowledges": "extend",
               "selectTags": "extend",
               "objectids": "15112",
               "recent": "true",
               "sortfield": ["eventid"],
               "sortorder": "DESC"
           },
           "auth": "67f45d3eb1173338e1b1647c4bdc1916",
           "id": 1
       }

Ответ:

{
           "jsonrpc": "2.0",
           "result": [
               {
                   "eventid": "1245463",
                   "source": "0",
                   "object": "0",
                   "objectid": "15112",
                   "clock": "1472457242",
                   "ns": "209442442",
                   "r_eventid": "1245468",
                   "r_clock": "1472457285",
                   "r_ns": "125644870",
                   "correlationid": "0",
                   "userid": "1",
                   "acknowledges": [
                       {
                           "acknowledgeid": "14443",
                           "userid": "1",
                           "eventid": "1245463",
                           "clock": "1472457281",
                           "message": "problem solved",
                           "action": "1"
                       }
                   ],
                   "tags": [
                       {
                           "tag": "test tag",
                           "value": "test value"
                       }
                   ]
               }
           ],
           "id": 1
       }

Смотрите также

Исходный код

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