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 ставке која се користи у функцији;
name - (string) име функције (враћа се као својство function);
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|^| |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.