On this page
trigger.get
Apraksts
integer/array trigger.get(object parameters)
Šī metode ļauj izgūt trigerus atbilstoši norādītajiem parametriem.
Šī metode ir pieejama jebkura tipa lietotājiem. Tiesības izsaukt šo metodi var atsaukt lietotāja lomas iestatījumos. Plašāka informācija pieejama sadaļā User roles.
Parametri
(object) Parametri, kas definē vēlamo izvadi.
Metode atbalsta šādus parametrus.
| Parameter | Type | Description |
|---|---|---|
| triggerids | ID/array | Atgriezt tikai trigerus ar norādītajiem ID. |
| groupids | ID/array | Atgriezt tikai trigerus, kas pieder hosts vai veidnēm no norādītajām hostu grupām vai veidņu grupām. |
| templateids | ID/array | Atgriezt tikai trigerus, kas pieder norādītajām veidnēm. |
| hostids | ID/array | Atgriezt tikai trigerus, kas pieder norādītajiem hosts. |
| itemids | ID/array | Atgriezt tikai trigerus, kas satur norādītos vienumus. |
| functions | string/array | Atgriezt tikai trigerus, kas izmanto norādītās funkcijas. Skatiet lapu atbalstītā funkcija, lai iegūtu atbalstīto funkciju sarakstu. |
| group | string | Atgriezt tikai trigerus, kas pieder hosts vai veidnēm no hostu grupas vai veidņu grupas ar norādīto nosaukumu. |
| host | string | Atgriezt tikai trigerus, kas pieder hostam ar norādīto tehnisko nosaukumu. |
| inherited | boolean | Ja iestatīts uz true, atgriezt tikai no veidnes mantotos trigerus. |
| templated | boolean | Ja iestatīts uz true, atgriezt tikai trigerus, kas pieder veidnēm. |
| dependent | boolean | Ja iestatīts uz true, atgriezt tikai trigerus, kuriem ir atkarības. Ja iestatīts uz false, atgriezt tikai trigerus, kuriem nav atkarību. |
| monitored | flag | Atgriezt tikai iespējotos trigerus, kas pieder uzraudzītiem hosts un satur tikai iespējotus vienumus. |
| active | flag | Atgriezt tikai iespējotos trigerus, kas pieder uzraudzītiem hosts. |
| maintenance | boolean | Ja iestatīts uz true, atgriezt tikai iespējotos trigerus, kas pieder hostiem tehniskās apkopes režīmā. |
| withUnacknowledgedEvents | flag | Atgriezt tikai trigerus, kuriem ir neapstiprināti notikumi. |
| withAcknowledgedEvents | flag | Atgriezt tikai trigerus, kuriem visi notikumi ir apstiprināti. |
| withLastEventUnacknowledged | flag | Atgriezt tikai trigerus, kuriem pēdējais notikums ir neapstiprināts. |
| skipDependent | flag | Izlaist trigerus problēmas stāvoklī, kas ir atkarīgi no citiem trigeriem. Ņemiet vērā, ka citi trigeri tiek ignorēti, ja tie ir atspējoti, tiem ir atspējoti vienumi vai atspējoti vienumu hosti. |
| lastChangeSince | timestamp | Atgriezt tikai trigerus, kuru stāvoklis ir mainījies pēc norādītā laika. |
| lastChangeTill | timestamp | Atgriezt tikai trigerus, kuru stāvoklis ir mainījies pirms norādītā laika. |
| only_true | flag | Atgriezt tikai trigerus, kas nesen ir bijuši problēmas stāvoklī (ok_period ietvaros). |
| min_severity | integer | Atgriezt tikai trigerus ar smaguma pakāpi, kas ir lielāka vai vienāda ar norādīto smaguma pakāpi. |
| evaltype | integer | Tagu novērtēšanas metode. Iespējamās vērtības: 0 - (noklusējums) And/Or; 2 - Or. |
| tags | array | Atgriezt tikai trigerus ar norādītajiem tagiem. Formāts: [{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...].Tukšs masīvs atgriež visus trigerus. Iespējamās operatora vērtības: 0 - (noklusējums) Contains; 1 - Equals; 2 - Does not contain; 3 - Does not equal; 4 - Exists; 5 - Does not exist. |
| expandComment | flag | Izvērst makro trigera aprakstā. |
| expandDescription | flag | Izvērst makro trigera nosaukumā. |
| expandExpression | flag | Izvērst funkcijas un makro trigera izteiksmē. |
| selectHostGroups | query | Atgriezt hostu grupas, kurām trigeris pieder, hostgroups īpašībā. |
| selectHosts | query | Atgriezt hosts, kurām trigeris pieder, hosts īpašībā. |
| selectItems | query | Atgriezt vienumus, ko satur trigeris, items īpašībā. |
| selectFunctions | query | Atgriezt funkcijas, ko izmanto trigeris, functions īpašībā.Funkciju objekti attēlo funkcijas, kas tiek izmantotas trigera izteiksmē, un tiem ir šādas īpašības: functionid - (ID) funkcijas ID;itemid - (ID) vienuma ID, kas tiek izmantots funkcijā;function - (string) funkcijas nosaukums;parameter - (string) funkcijai nodotais parametrs. Vaicājuma parametrs atgrieztajā virknē tiek aizstāts ar simbolu $. |
| selectDependencies | query | Atgriezt trigerus, no kuriem šis trigeris ir atkarīgs, dependencies īpašībā. |
| selectDiscoveryData | query | Atgriezt discoveryData īpašību ar trigera atklāšanas objekta datiem. Trigera atklāšanas objekts saista atklāto trigeri ar trigera prototipu, no kura tas tika atklāts.Tam ir šādas īpašības: parent_triggerid - (ID) trigera prototipa ID, no kura trigeris tika izveidots;status - (int) trigera atklāšanas statuss:0 - (noklusējums) trigeris ir atklāts, 1 - trigeris vairs nav atklāts; ts_delete - (timestamp) laiks, kad trigeris, kas vairs nav atklāts, tiks dzēsts;ts_disable - (timestamp) laiks, kad trigeris, kas vairs nav atklāts, tiks atspējots;disable_source - (int) indikators, vai trigeris tika atspējots ar LLD noteikumu vai manuāli:0 - (noklusējums) atspējots automātiski, 1 - atspējots ar LLD noteikumu. |
| selectDiscoveryRule | query | Atgriezt zemā līmeņa atklāšanas noteikumu, kas izveidoja trigeri, discoveryRule īpašībā. |
| selectLastEvent | query | Atgriezt pēdējo nozīmīgo trigera notikumu lastEvent īpašībā. |
| selectTags | query | Atgriezt trigera tagus tags īpašībā. |
| selectTemplateGroups | query | Atgriezt veidņu grupas, kurām trigeris pieder, templategroups īpašībā. |
| filter | object | Atgriezt tikai tos rezultātus, kas precīzi atbilst norādītajam filtram. Pieņem objektu, kur atslēgas ir īpašību nosaukumi, bet vērtības ir vai nu viena vērtība, vai vērtību masīvs, ar ko salīdzināt. Nepieciešamības gadījumā neatbalsta text datu tipa īpašības.Atbalsta papildu īpašības: host - trigera hosta tehniskais nosaukums;hostid - trigera hosta ID. |
| limitSelects | integer | Ierobežo ierakstu skaitu, ko atgriež apakšatlases. Attiecas uz šādām apakšatlasēm: selectHosts - rezultāti tiks kārtoti pēc host. |
| sortfield | string/array | Kārtot rezultātu pēc norādītajām īpašībām. Iespējamās vērtības: triggerid, description, status, priority, lastchange, hostname. |
| countOutput | boolean | Šie parametri ir aprakstīti atsauces komentārā. |
| editable | boolean | |
| excludeSearch | boolean | |
| limit | integer | |
| output | query | |
| preservekeys | boolean | |
| search | object | |
| searchByAny | boolean | |
| searchWildcardsEnabled | boolean | |
| sortorder | string/array | |
| startSearch | boolean | |
| selectTriggerDiscovery | query | Atgriezt trigera atklāšanas objektu triggerDiscovery īpašībā. Trigera atklāšanas objekti saista trigeri ar trigera prototipu, no kura tas tika izveidots.Šis vaicājums ir novecojis, lūdzu, izmantojiet selectDiscoveryData tā vietā. |
Atgrieztās vērtības
(integer/array) Atgriež vienu no šīm vērtībām:
- objektu masīvu;
- izgūto objektu skaitu, ja ir izmantots parametrs
countOutput.
Piemēri
Datu izgūšana pēc trigeris ID
Izgūt visus datus un funkcijas, kas izmantotas trigeris "14062".
{
"jsonrpc": "2.0",
"method": "trigger.get",
"params": {
"triggerids": "14062",
"output": "extend",
"selectFunctions": "extend"
},
"id": 1
}
Atbilde:
{
"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
}
Trigeru izgūšana problēmas stāvoklī
Izgūstiet visu trigeru ID, nosaukumu un svarīguma līmeni, kas ir problēmas stāvoklī, un kārtojiet tos pēc svarīguma līmeņa dilstošā secībā.
{
"jsonrpc": "2.0",
"method": "trigger.get",
"params": {
"output": [
"triggerid",
"description",
"priority"
],
"filter": {
"value": 1
},
"sortfield": "priority",
"sortorder": "DESC"
},
"id": 1
}
Atbilde:
{
"jsonrpc": "2.0",
"result": [
{
"triggerid": "13907",
"description": "Zabbix pašuzraudzības procesi ir aizņemti mazāk nekā 100%",
"priority": "4"
},
{
"triggerid": "13824",
"description": "Zabbix atklāšanas procesi ir aizņemti vairāk nekā 75%",
"priority": "3"
}
],
"id": 1
}
Konkrēta trigera iegūšana ar tagiem
Iegūstiet konkrētu trigeri ar tagiem.
{
"jsonrpc": "2.0",
"method": "trigger.get",
"params": {
"output": [
"triggerid",
"description"
],
"selectTags": "extend",
"triggerids": [
"17578"
]
},
"id": 1
}
Atbilde:
{
"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
}
Skatiet arī
Avots
CTrigger::get() failā ui/include/classes/api/services/CTrigger.php.