problem.get

Описание

целое число/массив problem.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",  "suppressed": "1",  "severity": "3",  "acknowledges": [  {  "acknowledgeid": "14443",  "userid": "1",  "eventid": "1245463",  "clock": "1472457281",  "message": "problem solved",  "action": "6",  "old_severity": "0",  "new_severity": "0"  }  ],  "tags": [  {  "tag": "test tag",  "value": "test value"  }  ],  "suppression_data": [  {  "maintenanceid": "15",  "suppress_until": "1472511600"  }  ]  }  ],  "id": 1 }

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

Исходный код

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

Documentation