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.