problem.get

Описание

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

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

Этим метод необходим для получения нерешённых проблем. Также имеется возможность, если задано, дополнительно получить недавно решённые проблемы. Период, который определяет на сколько времени решённые проблемы могут быть "недавними" определяется в АдминистрированиеОбщие. Проблемы, которые решены до этого периода не сохраняются в таблице проблем. Для получения проблем, которые были решены ранее, используйте event.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.