trigger.get

Опис

integer/array trigger.get(object parameters)

Метода омогућава преузимање тригера према датим параметрима.

Параметри

(object) Параметри који дефинишу жељени излаз.

Метод подржава следеће параметре.

|templateids|ID/array|Врати само окидаче који припадају датим шаблонима.| |hostids|ID/array|Врати само окидаче који припадају датим домаћинима.| |itemids|ID/array|Врати само окидаче који садрже дате ставке.| |functions|string/array|Врати само окидаче који користе дате функције.

Погледајте страницу подржана функција за листу подржаних функција.| |group|string|Врати само окидаче који припадају домаћинима или шаблонима из групе домаћина или групе шаблона са датим именом.| |host|string|Врати само окидаче који припадају домаћину са датим техничким именом.| |inherited|boolean|Ако је постављено на true врати само окидаче наслеђене из шаблона.| |templated|boolean|Ако је постављено на true враћа само окидаче који припадају шаблонима.| |dependent|boolean| Ако је подешено на true, враћају се само покретачи који имају зависности. Ако је подешено на false, враћају само окидаче који немају зависности.| |monitored|flag|Врати само омогућене окидаче који припадају надгледаним домаћинима и садрже само омогућене ставке.| |active|flag|Врати само омогућене окидаче који припадају надгледаним домачинима.| |maintenance|boolean|Ако је постављено на true враћа само омогућене окидаче који припадају домаћинима у одржавању.| |withUnacknowledgedEvents|flag|Врати само окидаче који имају непризнате догађаје.| |withAcknowledgedEvents|flag|Врати само окидаче са свим потврђеним догађајима.| |withLastEventUnacknowledged|flag|Врати само последњи догађај који није потврђен.| |skipDependent|flag|Прескочи окидаче у стању проблема који зависе од других окидача. Имајте на уму да се други окидачи занемарују ако су онемогућени, имају онемогућене ставке или онемогућене домаћине ставки.| |lastChangeSince|timestamp|Врати само окидаче који су променили стање након датог времена.|

|lastChangeTill|timestamp|Врати само окидаче који су променили своје стање пре датог времена.|

|only_true|flag|Врати само окидаче који су недавно били у проблемском стању.| |min_severity|integer|Повратак само покреће са озбиљношћу већом или једнаком од дате озбиљности.| |evaltype|integer|Правила за претрагу ознака.

Могуће вредности:
0 - (подразумевано) И/Или;
2 - Или.| |tags|array|Врати само окидаче са датим ознакама. Тачно подударање по ознаци и претрага која се разликује од великих или малих слова по вредности ознаке у зависности од вредности оператора.
Формат: [{"ознака": "<tag>", "вредност": "<value>", " оператор": "<operator>"}, ...].
Празан низ враћа све покретаче.

Могући типови оператора:
0 - (подразумевано) Свиђа ми се;
1 – Једнако;<бр>2 – Не свиђа;
3 – Није једнако;
4 – Постоји;
5 – Не постоји.| |expandComment|flag|Прошири макрое у опис окидача.| |expandDescription|flag|Прошири макрое у имену окидача.| |expandExpression|flag|Прошири функције и макрое у окидачу израз.| |selectHostGroups|query|Врати групе домаћина којима окидач припада у својству hostgroups property.| |selectHosts|query|Врати хостове које окидач припада у хостс својство.| |selectItems|query|Врати ставке које садржи окидач у својству items.| |selectFunctions|query|Врати функције које се користе у окидачу у својства функције.

Објекти функције представљају функције које се користе у изразу окидача и имају следећа својства:
functionid - (ID) ID функције;<бр>itemid - (ID) ID ставке која се користи у функцији;
function - (string) име функције;
parameter - (string) параметар прослеђен функцији. Параметар упита је замењен симболом $ у враћеном низу.| |selectDependencies|query|Повратни окидачи од којих зависи окидач у својству dependencies.| |selectDiscoveryRule|query|Врати правило откривања ниског нивоа који је креирао окидач у својству discoveryRule.| |selectLastEvent|query|Врати последњи значајан догађај окидача у lastEvent.| |selectTags|query|Врати ознаке окидача у својству tags .| |selectTemplateGroups|query|Врати групе шаблона којима окидач припада у templategroups.| |selectTriggerDiscovery|query|Врати објекат за откривање окидача у својству triggerDiscovery. Објекти откривања окидача повезују окидач са прототипом окидача од којег је креиран.

Има следећа својства:
parent_triggerid - (ID) ID прототипа окидача из којег је окидач је креиран;
status - (int) статус откривања окидача:
0 - (подразумевано) окидач је откривен,
1 - окидач је више није откривено;
ts_delete - (timestamp) време када ће окидач који више није откривен ће бити избрисан;
ts_disable - (timestamp) време када окидач који више није откривен ће бити онемогућен;
disable_source - (int) индикатор да ли је окидач онемогућен LLD правилом или ручно:
0 - (подразумевано) онемогућено аутоматски,
1 - онемогућено LLD правилом.| |filter|object|Врати само оне резултате који се тачно подударају са датим филтером.

Прихвата објекат, где су кључеви имена својстава, а вредности су или једна вредност или низ вредности за подударање.

Не подржава својства text тип податка.

Подржава додатна својства:
host - техничко име домаћина којем окидач припада;
hostid - ID домаћина којем окидач припада.| |limitSelects|integer|Ограничава број записа које враћају подизбори.

Односи се на следеће подселектује:
selectHosts - резултати ће бити сортирани по host.| |sortfield|string/array|Сортирање резултат према датим својствима.

Могуће вредности: triggerid, description, status, priority, lastchange, hostname.| |countOutput|boolean|Ови параметри који су заједнички за све методе get су детаљно описани у референтном коментару страница.| |editable|boolean|^| |excludeSearch|boolean|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|

Повратне вредности

(integer/array) Враћа или:

• низ објеката;
• број преузетих објеката, ако је коришћен параметар countOutput.

Примери

Преузимање података помоћу ID-ија окидача

Преузми све податке и функције које се користе у окидачу „14062“.

Захтев:

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

Одговор:

{
     "jsonrpc": "2.0",
     "result": [
     {
     "triggerid": "14062",
     "expression": "{13513}<10m",
     "description": "{HOST.NAME} has been restarted (uptime < 10m)",
     "url": "",
     "status": "0",
     "value": "0",
     "priority": "2",
     "lastchange": "0",
     "comments": "The host uptime is less than 10 minutes",
     "error": "",
     "templateid": "10016",
     "type": "0",
     "state": "0",
     "flags": "0",
     "recovery_mode": "0",
     "recovery_expression": "",
     "correlation_mode": "0",
     "correlation_tag": "",
     "manual_close": "0",
     "opdata": "",
     "event_name": "",
     "uuid": "",
     "url_name": "",
     "functions": [
     {
     "functionid": "13513",
     "itemid": "24350",
     "triggerid": "14062",
     "parameter": "$",
     "function": "last"
     }
     ]
     }
     ],
     "id": 1
}

Преузимање окидача у проблемском стању

Преузми ID, назив и озбиљност свих окидача у стању проблема и сортирај их по озбиљности у опадајућем редоследу.

Захтев:

{
     "jsonrpc": "2.0",
     "method": "trigger.get",
     "params": {
     "output": [
     "triggerid",
     "description",
     "priority"
     ],
     "filter": {
     "value": 1
     },
     "sortfield": "priority",
     "sortorder": "DESC"
     },
     "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"
     ]
     },
     "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() in ui/include/classes/api/services/CTrigger.php.