trigger.get

Описание

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

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

Параметры

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

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

Параметр Тип Описание
triggerids строка/массив Возврат триггеров только с заданными ID.
groupids строка/массив Возврат только тех триггеров, которые принадлежат узлам сети из заданных групп узлов сети.
templateids строка/массив Возврат только тех триггеров, которые принадлежат заданным шаблонам.
hostids строка/массив Возврат только тех триггеров, которые принадлежат заданным узлам сети.
itemids строка/массив Возврат только тех триггеров, которые содержат заданные элементы данных.
applicationids строка/массив Возврат только тех триггеров, которые содержат элементы данных из заданных групп элементов данных.
functions строка/массив Возврат только тех триггеров, которые используют заданные функции.

Обратитесь к странице поддерживаемых функций триггеров для получения списка поддерживаемых функций.
group строка Возврат только тех триггеров, которые принадлежат узлам сети из группы узлов сети с заданным именем.
host строка Возврат только тех триггеров, которые принадлежат узлу сети с заданным именем.
inherited логический Если задано значение true, возвращать только те триггеры, которые унаследованы из шаблона.
templated логический Если задано значение true, возвращать только те триггеры, которые принадлежат шаблонам.
dependent логический Если задано значение true, возвращать только те триггеры, у которых имеются зависимости. Если задано значением false, возвращать только те триггеры у которых нет зависимостей.
monitored флаг Возврат только активированных триггеров, которые принадлежат узлам сети под наблюдением и содержат только активированные элементы данных.
active флаг Возврат только активированных триггеров, которые принадлежат узлам сети под наблюдением.
maintenance логический Если задано значение true, возвращать только активированные триггера, которые принадлежат узлам сети в обслуживании.
withUnacknowledgedEvents флаг Возврат только тех триггеров, у которых имеются неподтвержденные события.
withAcknowledgedEvents флаг Возврат только тех триггеров, все события которых подтверждены.
withLastEventUnacknowledged флаг Возврат только тех триггеров, последние события которых неподтверждены.
skipDependent флаг Пропуск триггеров в состоянии проблема, которые зависят от других триггеров. Обратите внимание, что другие триггеры игнорируется, если они деактивированы или имеют деактивированные элементы данных или деактивированные узлы сети элементов данных.
lastChangeSince штамп времени Возврат только тех триггеров, которые изменили своё состояние после заданного времени.
lastChangeTill штамп времени Возврат только тех триггеров, которые изменили своё состояние до заданного времени.
only_true флаг Возврат только тех триггеров, которые недавно были в состоянии проблема.
min_severity целое число Возврат только тех триггеров, у которых важность больше или равна заданной важности.
expandComment флаг Раскрытие макросов в описании к триггеру.
expandDescription флаг Раскрытие макросов в имени триггера.
expandExpression флаг Раскрытие функций и макросов в выражении триггера.
selectGroups запрос Возврат групп узлов сети, которым принадлежит триггер, в свойстве groups.
selectHosts запрос Возврат узлов сети, которым принадлежит триггер, в свойстве hosts.
selectItems запрос Возврат элементов данных, которые содержатся в выражении триггера, в свойстве items.
selectFunctions запрос Возврат функций, которые используются в триггере, в свойстве functions.

Объект функции представляет собой функции, которые используются в выражении триггера, и имеет следующие свойства:
functionid - (строка) ID функции;
itemid - (строка) ID элемента данных, который используется в функции;
function - (строка) имя функции;
parameter - (строка) переданный параметр в функцию.
selectDependencies запрос Возврат триггеров, от которых зависит триггер, в свойстве dependencies.
selectDiscoveryRule запрос Возврат правила низкоуровневого правила обнаружения, которое создало триггер.
selectLastEvent запрос Возврат последнего значимого события триггера в свойстве lastEvent.
selectTags запрос Возврат тегов триггера в свойстве tags.
selectTriggerDiscovery запрос Возврат объекта обнаружения триггеров в свойстве triggerDiscovery. Объекты обнаружения триггеров ссылаются от триггера к прототипу триггеров, с которого этот триггер был создан.

Этот параметр имеет следующие свойства:
parent_triggerid - (строка) ID прототипа триггеров с которого был создан триггер.
filter объект Возврат только тех результатов, которые в точности соответствуют заданному фильтру.

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

Поддерживает дополнительные фильтры:
host - техническое имя узла сети, которому принадлежит триггер;
hostid - ID узла сети, которому принадлежит триггер.
limitSelects целое число Ограничение количества записей, возвращаемых подзапросами.

Применимо только к следующим подзапросам:
selectHosts - результаты сортируются по host.
sortfield строка/массив Сортировка результата в соответствии с заданными свойствами.

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

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

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

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

Примеры

Получение данных по ID триггера

Получение всех данных и функций, которые используются в триггере "14062".

Запрос:

{
           "jsonrpc": "2.0",
           "method": "trigger.get",
           "params": {
               "triggerids": "14062",
               "output": "extend",
               "selectFunctions": "extend"
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Ответ:

{
           "jsonrpc": "2.0",
           "result": [
               {
                   "triggerid": "14062",
                   "expression": "{13513}>0",
                   "description": "/etc/passwd has been changed on {HOST.NAME}",
                   "url": "",
                   "status": "0",
                   "value": "0",
                   "priority": "2",
                   "lastchange": "0",
                   "comments": "",
                   "error": "",
                   "templateid": "10016",
                   "type": "0",
                   "state": "0",
                   "flags": "0",
                   "recovery_mode": "0",
                   "recovery_expression": "",
                   "correlation_mode": "0",
                   "correlation_tag": "",
                   "manual_close": "0",
                   "opdata": "",
                   "functions": [
                       {
                           "functionid": "13513",
                           "itemid": "24350",
                           "triggerid": "14062",
                           "parameter": "0",
                           "function": "diff"
                       }
                   ]
               }
           ],
           "id": 1
       }

Получение триггеров в состоянии проблема

Получение ID, имени и важности всех триггеров в состоянии проблема и сортировка их по важности в порядке убывания.

Запрос:

{
           "jsonrpc": "2.0",
           "method": "trigger.get",
           "params": {
               "output": [
                   "triggerid",
                   "description",
                   "priority"
               ],
               "filter": {
                   "value": 1
               },
               "sortfield": "priority",
               "sortorder": "DESC"
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Ответ:

{
           "jsonrpc": "2.0",
           "result": [
               {
                   "triggerid": "13907",
                   "description": "Zabbix self-monitoring processes < 100% busy",
                   "priority": "4"
               },
               {
                   "triggerid": "13824",
                   "description": "Zabbix discoverer processes more than 75% busy",
                   "priority": "3"
               }
           ],
           "id": 1
       }

Получение заданного триггера с тегами

Получение заданного триггера с тегами.

Запрос:

{
           "jsonrpc": "2.0",
           "method": "trigger.get",
           "params": {
               "output": [
                   "triggerid",
                   "description"
               ],
               "selectTags": "extend",
               "triggerids": [
                   "17578"
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Ответ:

{
           "jsonrpc": "2.0",
           "result": [
               {
                   "triggerid": "17370",
                   "description": "Service status",
                   "tags": [
                       {
                           "tag": "service",
                           "value": "{{ITEM.VALUE}.regsub(\"Service (.*) has stopped\", \"\\1\")}"
                       },
                       {
                           "tag": "error",
                           "value": ""
                       }
                   ]
               }
           ],
           "id": 1
       }

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

Исходный код

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