trigger.get

Опис

integer/array trigger.get(object parameters)

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

Параметри

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

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

|Parameter|Type|Description| |--|--|-- ----| |triggerids|ID/array|Враћа само окидаче са датим ID-ијевима.| |groupids|ID/array|Враћа само окидаче који припадају домаћинима или шаблонима из датих група домаћина или група шаблона.| |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": "<tag>", "value": "<value>", "operator": "<operator>"}, ...].
Празан низ враћа све окидаче.

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

Објекти функције представљају функције које се користе у изразу окидача и имају следећа својства:
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|Ови параметри су описани у референтном коментару.| |editable|boolean|^| |excludeSearch|boolean|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^| |selectGroups
(застарело)|query|Ово параметар је застарео, уместо тога користите selectHostGroups или selectTemplateGroups.
Враћа групе домаћина и групе шаблона којима окидач припада у својству groups.|

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

(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",  "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.