[comment]: # ({48cd3524-48cd3524}) # problem.get [comment]: # ({/48cd3524-48cd3524}) [comment]: # ({c91e55ea-a18b2713}) ### Описание `integer/array problem.get(object parameters)` Метод позволяет получать проблемы в соответствии с заданными параметрами. Этот метод предназначен для получения нерешенных проблем. При необходимости также можно дополнительно получать недавно решенные проблемы. Период, определяющий, насколько "недавно" — это недавно, задается в разделе *Администрирование* → *[Общие настройки](/manual/web_interface/frontend_sections/administration/general#trigger-displaying-options)*. Проблемы, которые были решены раньше этого периода, не хранятся в таблице проблем. Чтобы получить проблемы, решенные более давно, используйте метод [`event.get`](/manual/api/reference/event/get). ::: noteimportant Этот метод может возвращать проблемы удаленной сущности, если эти проблемы еще не были удалены housekeeper. ::: ::: noteclassic Этот метод доступен пользователям любого типа. Разрешения на вызов метода можно отозвать в настройках роли пользователя. См. [Роли пользователей](/manual/web_interface/frontend_sections/users/user_roles) для получения дополнительной информации. ::: [comment]: # ({/c91e55ea-a18b2713}) [comment]: # ({ec05f91b-98f39c6a}) ### Параметры `(object)` Параметры, определяющие требуемый результат. Метод поддерживает следующие параметры. |Parameter|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |eventids|ID/array|Возвращать только проблемы с указанными ID.| |groupids|ID/array|Возвращать только проблемы, созданные объектами, которые принадлежат указанным группам узлов сети.| |hostids|ID/array|Возвращать только проблемы, созданные объектами, которые принадлежат указанным узлам сети.| |objectids|ID/array|Возвращать только проблемы, созданные указанными объектами.| |source|integer|Возвращать только проблемы с указанным типом.

Список поддерживаемых типов событий см. на [странице объекта события проблемы](object#problem).

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

Список поддерживаемых типов объектов см. на [странице объекта события проблемы](object#problem).

По умолчанию: 0 - триггер.| |acknowledged|boolean|Если задано `true`, возвращать только подтвержденные проблемы.| |action|integer|Возвращать только проблемы, для которых были выполнены указанные [действия обновления события](/manual/api/reference/event/acknowledge#parameters). Для нескольких действий используйте битовую маску как сумму любых допустимых значений bitmap (например, 34 для подтверждения и подавления события).| |action_userids|ID/array|Возвращать только проблемы с указанными ID пользователей, выполнивших действия обновления события проблемы.| |suppressed|boolean|Если задано `true`, возвращать только подавленные проблемы.| |symptom|boolean|Если задано `true`, возвращать только события проблем-симптомов.| |severities|integer/array|Возвращать только проблемы с указанными уровнями важности события. Применяется только если object - триггер.| |evaltype|integer|Метод [оценки тегов](/manual/web_interface/frontend_sections/monitoring/problems#using-filter).

Возможные значения:
0 - *(по умолчанию)* И;
2 - ИЛИ.| |tags|array|Возвращать только проблемы с указанными тегами.
Формат: `[{"tag": "", "value": "", "operator": ""}, ...]`.
Пустой массив возвращает все проблемы.

Возможные значения [оператора](/manual/web_interface/frontend_sections/monitoring/problems#using-filter):
0 - *(по умолчанию)* Содержит;
1 - Равно;
2 - Не содержит;
3 - Не равно;
4 - Существует;
5 - Не существует.| |recent|boolean|Если задано `true`, возвращать недавние проблемы, включая те, что были решены в пределах [`ok_period`](/manual/api/reference/settings/object), а также любые нерешенные проблемы.
Если задано `false`, возвращать только нерешенные проблемы.| |eventid\_from|string|Возвращать только проблемы с ID больше или равным указанному ID.| |eventid\_till|string|Возвращать только проблемы с ID меньше или равным указанному ID.| |time\_from|timestamp|Возвращать только проблемы, созданные после указанного времени или в указанное время.| |time\_till|timestamp|Возвращать только проблемы, созданные до указанного времени или в указанное время.| |selectAcknowledges|query|Возвращать свойство `acknowledges` с обновлениями проблемы. Обновления проблемы сортируются в обратном хронологическом порядке.

Объект обновления проблемы имеет следующие свойства:
`acknowledgeid` - `(ID)` ID обновления;
`userid` - `(ID)` ID пользователя, который обновил событие;
`eventid` - `(ID)` ID обновленного события;
`clock` - `(timestamp)` время обновления события;
`message` - `(string)` текст сообщения;
`action` - `(integer)`тип действия обновления (см. [`event.acknowledge`](/manual/api/reference/event/acknowledge));
`old_severity` - `(integer)` уровень важности события до этого действия обновления;
`new_severity` - `(integer)` уровень важности события после этого действия обновления;
`suppress_until` - `(timestamp)` время, до которого событие будет подавлено;
`taskid` - `(ID)` ID задачи, если текущее событие находится в процессе изменения ранга.

Поддерживает `count`.| |selectTags|query|Возвращать свойство [`tags`](/manual/api/reference/problem/object#problem-tag) с тегами проблемы. Формат вывода: `[{"tag": "", "value": ""}, ...]`.| |selectSuppressionData|query|Возвращать свойство `suppression_data` со списком активных обслуживаний и ручных подавлений:
`maintenanceid` - `(ID)` ID обслуживания;
`userid` - `(ID)` ID пользователя, который подавил проблему;
`suppress_until` - `(integer)` время, до которого проблема подавлена.| |filter|object|Возвращать только те результаты, которые точно соответствуют указанному фильтру.

Принимает объект, где ключи - это имена свойств, а значения - либо одно значение, либо массив значений, с которыми выполняется сравнение.

Не поддерживает свойства с [типом данных](/manual/api/reference_commentary#data-types) `text`.| |sortfield|string/array|Сортировать результат по указанным свойствам.

Возможные значения: `eventid`.| |countOutput|boolean|Эти параметры описаны в [справочном комментарии](/manual/api/reference_commentary#common-get-method-parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^| [comment]: # ({/ec05f91b-98f39c6a}) [comment]: # ({7223bab1-7223bab1}) ### Возвращаемые значения `(целое число/массив)` Возвращает либо: - · массив объектов; - · количество извлеченных объектов, если использовался параметр `countOutput`. [comment]: # ({/7223bab1-7223bab1}) [comment]: # ({b41637d2-b41637d2}) ### Примеры [comment]: # ({/b41637d2-b41637d2}) [comment]: # ({9d82627b-4d83529d}) #### Получение событий проблем триггера Получить недавние события из триггера "15112." [Запрос](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "problem.get", "params": { "output": "extend", "selectAcknowledges": "extend", "selectTags": "extend", "selectSuppressionData": "extend", "objectids": "15112", "recent": true, "sortfield": ["eventid"], "sortorder": "DESC" }, "id": 1 } ``` Ответ: ```json { "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", "cause_eventid": "0", "opdata": "", "acknowledges": [ { "acknowledgeid": "14443", "userid": "1", "eventid": "1245463", "clock": "1472457281", "message": "problem solved", "action": "6", "old_severity": "0", "new_severity": "0", "suppress_until": "1472511600", "taskid": "0" } ], "suppression_data": [ { "maintenanceid": "15", "suppress_until": "1472511600", "userid": "0" } ], "suppressed": "1", "tags": [ { "tag": "test-tag", "value": "test-value" } ] } ], "id": 1 } ``` [comment]: # ({/9d82627b-4d83529d}) [comment]: # ({36151502-by}) #### Получение проблем, подтвержденных указанным пользователем Получение проблем, подтвержденных пользователем с ID=10 [Запрос](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "problem.get", "params": { "output": "extend", "action": 2, "action_userids": [10], "selectAcknowledges": ["userid", "action"], "sortfield": ["eventid"], "sortorder": "DESC" }, "id": 1 } ``` Ответ: ```json { "jsonrpc": "2.0", "result": [ { "eventid": "1248566", "source": "0", "object": "0", "objectid": "15142", "clock": "1472457242", "ns": "209442442", "r_eventid": "1245468", "r_clock": "1472457285", "r_ns": "125644870", "correlationid": "0", "userid": "10", "name": "Zabbix agent on localhost is unreachable for 5 minutes", "acknowledged": "1", "severity": "3", "cause_eventid": "0", "opdata": "", "acknowledges": [ { "userid": "10", "action": "2" } ], "suppressed": "0" } ], "id": 1 } ``` [comment]: # ({/36151502-by}) [comment]: # ({f5742bff-c6eb3ba0}) ### См. также - [Оповещение](/manual/api/reference/alert/object) - [Элемент данных](/manual/api/reference/item/object) - [Узел сети](/manual/api/reference/host/object) - [Правило LLD](/manual/api/reference/discoveryrule/object#lld-rule) - [Триггер](/manual/api/reference/trigger/object) [comment]: # ({/f5742bff-c6eb3ba0}) [comment]: # ({15f9267d-15f9267d}) ### Источник CEvent::get() в *ui/include/classes/api/services/CProblem.php*. [comment]: # ({/15f9267d-15f9267d})