trigger.get

Описание

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

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

Параметры

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

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

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

Обратитесь к странице поддерживаемых функций триггеров для получения списка поддерживаемых функций.
group строка Возврат только тех триггеров, которые принадлежат узлам сети из группы узлов сети с заданным именем.
host строка Возврат только тех триггеров, которые принадлежат узлу сети с заданным именем.
inherited логический Если задано значение true, возвращать только те триггеры, которые унаследованы из шаблона.
templated логический Если задано значение true, возвращать только те триггеры, которые принадлежат шаблонам.
monitored флаг Возврат только активированных триггеров, которые принадлежат узлам сети под наблюдением и содержат только активированные элементы данных.
active флаг Возврат только активированных триггеров, которые принадлежат узлам сети под наблюдением.
maintenance логический Если задано значение true, возвращать только активированные триггера, которые принадлежат узлам сети в обслуживании.
withUnacknowledgedEvents флаг Возврат только тех триггеров, у которых имеются неподтвержденные события.
withAcknowledgedEvents флаг Возврат только тех триггеров, все события которых подтверждены.
withLastEventUnacknowledged флаг Возврат только тех триггеров, последние события которых неподтверждены.
skipDependent флаг Пропуск триггеров в состоянии проблема, которые зависят от других триггеров. Обратите внимание, что другие триггеры игнорируется, если они деактивированы или имеют деактивированные элементы данных или деактивированные узлы сети элементов данных.
lastChangeSince штамп времени Возврат только тех триггеров, которые изменили своё состояние после заданного времени.
lastChangeTill штамп времени Возврат только тех триггеров, которые изменили своё состояние до заданного времени.
only_true флаг Возврат только тех триггеров, которые недавно были в состоянии проблема.
min_severity целое число Возврат только тех триггеров, у которых важность больше или равна заданной важности.
expandData флаг Возврат дополнительных данных о первом узле сети из выражения триггера.

Добавление следующих свойств каждому триггеру:
hostname - (строка) видимое имя узла сети;
host - (строка) техническое имя узла сети;
hostid - (строка) ID узла сети.
expandComment флаг Раскрытие макросов в описании к триггеру.
expandDescription флаг Раскрытие макросов в имени триггера.
expandExpression флаг Раскрытие функций и макросов в выражении триггера.
selectGroups запрос Возврат групп узлов сети, которым принадлежит триггер, в свойстве groups.
selectHosts запрос Возврат узлов сети, которым принадлежит триггер, в свойстве hosts.
selectItems запрос Возврат элементов данных, которые содержатся в выражении триггера, в свойстве items.
selectFunctions запрос Возврат функций, которые используются в триггере, в свойстве functions.

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

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

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

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

Возможные значения: triggerid, description, status, priority, lastchange и hostname.
countOutput флаг Эти параметры являются общими для всех методов get и они описаны в справочных комментариях.
editable логический
excludeSearch флаг
limit целое число
nodeids строка/массив
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": [
               {
                   "functions": [
                       {
                           "functionid": "13513",
                           "itemid": "24350",
                           "function": "diff",
                           "parameter": "0"
                       }
                   ],
                   "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"
               }
           ],
           "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
       }

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

Исходный код

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