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>", "вредност": "<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|^| |selectGroups
(deprecated)|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",
            "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.