целое число/массив 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 | целое число | Возврат только тех триггеров, у которых важность больше или равна заданной важности. |
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 | целое число | |
output | запрос | |
preservekeys | флаг | |
search | объект | |
searchByAny | логический | |
searchWildcardsEnabled | логический | |
sortorder | строка/массив | |
startSearch | флаг |
(целое число/массив)
Возвращает либо:
countOutput
.Получение всех данных и функций, которые используются в триггере "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/include/classes/api/services/CTrigger.php.