problem.get

Описание

integer/array problem.get(параметры объекта)

Метод позволяет извлекать задачи по заданным параметры.

Этот метод предназначен для извлечения нерешенных проблем. Также возможно, если указано, для дополнительного получения недавно решенных проблем. период, который определяет, сколько лет «недавно», определяется в Администрация → Общие. Проблемы, которые были решены до этого периода, не сохраняются в таблице проблем. Чтобы получить проблемы, которые были решены ранее, используйте метод event.get.

Этот метод может вернуть проблемы удаленной сущности, если эти проблемы еще не были удалены обслуживающим процессом.

Этот метод доступен пользователям любого типа. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе Роли пользователей.

Параметры

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

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

Параметр	Тип	Описание
eventids	строка/массив	Возврат проблем только с заданными ID.
groupids	строка/массив	Возврат только тех проблем, которые созданы объектами принадлежащими заданным группам узлов сети.
hostids	строка/массив	Возврат только тех проблем, которые созданы объектами принадлежащими заданным узлам сети.
objectids	строка/массив	Возврат только тех проблем, которые созданы заданными объектами.
applicationids	строка/массив	Возврат только тех проблем, которые созданы объектами принадлежащими заданным группам элементов данных. Применяется только, если объектом являются триггер или элемент данных.
source	целое число	Возврат проблем только с заданным типом. Обратитесь к странице объекта события о проблеме для получения списка поддерживаемых типов событий. По умолчанию: 0 - проблема с триггеров.
object	целое число	Возврат только тех проблем, которые созданы объектами заданного типа. Обратитесь к странице объекта события о проблеме для получения списка поддерживаемых типов объекта. По умолчанию: 0 - триггер.
acknowledged	логический	`true` - возврат только подтвержденных проблем; `false` - только неподтвержденные.
severities	целое число/массив	Возврат проблем только с заданными важностями событий. Применяется только, если объектом является триггер.
evaltype	целое число	Правила поиска тегов. Возможные значения: 0 - (по умолчанию) И/Или; 2 - Или.
tags	массив объектов	Возврат проблем только с заданными тегами. Точное соответствие тегу и не зависимый от регистра поиск по значению и оператору. Формат: `[{"tag": "<тег>", "value": "<значение>", "operator": "<оператор>"}, ...]`. По всем проблемам возвращается пустой массив. Возможные типы операторов: 0 - (по умолчанию) Содержит; 1 - Равен.
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` - `(строка)` текст сообщения; `action` - `(целое число)` действие обновления, которое было выполнено, смотрите event.acknowledge; `old_severity` - `(целое число)` важность события до этого действия обновления; `new_severity` - `(целое число)` важность события после этого действия обновления; Поддерживается `count`.
selectTags	запрос	Возврат тегов проблем. Формат вывода: `[{"tag": "<тег>", "value": "<значение>"}, ...]`.
selectSuppressionData	запрос	Возврат списка обслуживаний в свойстве `suppression_data`: `maintenanceid` - (строка) ID обслуживания; `suppress_until` - (целое число) время, до которого проблема подавлена.
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",
               "selectSuppressionData": "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",
                   "name": "Zabbix agent on localhost is unreachable for 5 minutes",
                   "acknowledged": "1",
                   "severity": "3",
                   "opdata": "",
                   "acknowledges": [
                       {
                           "acknowledgeid": "14443",
                           "userid": "1",
                           "eventid": "1245463",
                           "clock": "1472457281",
                           "message": "problem solved",
                           "action": "6",
                           "old_severity": "0",
                           "new_severity": "0"
                       }
                   ],
                   "suppression_data": [
                       {
                           "maintenanceid": "15",
                           "suppress_until": "1472511600"
                       }
                   ],
                   "suppressed": "1",
                   "tags": [
                       {
                           "tag": "test tag",
                           "value": "test value"
                       }
                   ]
               }
           ],
           "id": 1
       }

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

Источник

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

Documentation