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šāku informāciju skatiet sadaļā Lietotāja lomas.

Parametri

(object) Parametri, kas nosaka vēlamo izvadi.

Metode atbalsta šādus parametrus.

Parametrs Tips Apraksts
triggerids ID/array Atgriež tikai trigerus ar norādītajiem ID.
groupids ID/array Atgriež tikai trigerus, kas pieder hostiem vai veidnēm no norādītajām hostu grupām vai veidņu grupām.
templateids ID/array Atgriež tikai trigerus, kas pieder norādītajām veidnēm.
hostids ID/array Atgriež tikai trigerus, kas pieder norādītajiem hostiem.
itemids ID/array Atgriež tikai trigerus, kas satur norādītos vienumus.
maintenanceids ID/array Atgriež tikai trigerus, kurus ietekmē norādītās uzturēšanas darbības.
functions string/array Atgriež tikai trigerus, kuros tiek izmantotas norādītās funkcijas.

Atbalstīto funkciju sarakstu skatiet lapā Atbalstītās funkcijas.
group string Atgriež tikai trigerus, kas pieder hostiem vai veidnēm no hostu grupas vai veidņu grupas ar norādīto nosaukumu.
host string Atgriež tikai trigerus, kas pieder hostam ar norādīto tehnisko nosaukumu.
inherited boolean Ja iestatīts uz true, atgriež tikai no veidnes mantotos trigerus.
templated boolean Ja iestatīts uz true, atgriež tikai trigerus, kas pieder veidnēm.
dependent boolean Ja iestatīts uz true, atgriež tikai trigerus, kuriem ir atkarības. Ja iestatīts uz false, atgriež tikai trigerus, kuriem nav atkarību.
monitored flag Atgriež tikai iespējotus trigerus, kas pieder uzraudzītiem hostiem un satur tikai iespējotus vienumus.
active flag Atgriež tikai iespējotus trigerus, kas pieder uzraudzītiem hostiem.
maintenance boolean Ja iestatīts uz true, atgriež tikai iespējotus trigerus, kas pieder uzturēšanā esošiem hostiem.
withUnacknowledgedEvents flag Atgriež tikai trigerus, kuriem ir neapstiprināti notikumi.
withAcknowledgedEvents flag Atgriež tikai trigerus, kuriem visi notikumi ir apstiprināti.
withLastEventUnacknowledged flag Atgriež tikai trigerus, kuru pēdējais notikums nav apstiprināts.
skipDependent flag Izlaiž problēmas stāvoklī esošus trigerus, kas ir atkarīgi no citiem trigeriem. Ņemiet vērā, ka pārējie trigeri tiek ignorēti, ja tie ir atspējoti, tiem ir atspējoti vienumi vai tie pieder hostiem ar atspējotiem vienumiem.
lastChangeSince timestamp Atgriež tikai trigerus, kuru stāvoklis ir mainījies pēc norādītā laika.
lastChangeTill timestamp Atgriež tikai trigerus, kuru stāvoklis ir mainījies pirms norādītā laika.
only_true flag Atgriež tikai trigerus, kas nesen ir bijuši problēmas stāvoklī (pēdējā ok_period laikā).
min_severity integer Atgriež tikai trigerus, kuru nopietnības līmenis ir lielāks vai vienāds ar norādīto līmeni.
evaltype integer Tagu novērtēšanas metode.

Iespējamās vērtības:
0 - (noklusējums) And/Or;
2 - Or.
tags array Atgriež 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) Satur;
1 - Ir vienāds ar;
2 - Nesatur;
3 - Nav vienāds ar;
4 - Pastāv;
5 - Nepastāv.
expandComment flag Izvērš makro trigeru aprakstā.
expandDescription flag Izvērš makro trigeru nosaukumā.
expandExpression flag Izvērš funkcijas un makro trigeru izteiksmē.
selectHostGroups query Atgriež hostu grupas, kurām trigeris pieder, rekvizītā hostgroups.
selectHosts query Atgriež hostus, kuriem trigeris pieder, rekvizītā hosts.
selectItems query Atgriež trigerī ietvertos vienumus rekvizītā items.
selectFunctions query Atgriež trigerī izmantotās funkcijas rekvizītā functions.

Funkciju objekti attēlo trigeru izteiksmē izmantotās funkcijas, un tiem ir šādi rekvizīti:
functionid - (ID) funkcijas ID;
itemid - (ID) funkcijā izmantotā vienuma ID;
function - (string) funkcijas nosaukums;
parameter - (string) funkcijai nodotais parametrs. Atgrieztajā virknē vaicājuma parametrs tiek aizstāts ar simbolu $.
selectDependencies query Atgriež trigerus, no kuriem trigeris ir atkarīgs, rekvizītā dependencies.
selectDiscoveryData query Atgriež rekvizītu discoveryData ar trigeru atklāšanas objekta datiem. Trigeru atklāšanas objekts sasaista atklāto trigeri ar trigeru prototipu, no kura tas tika atklāts.

Tam ir šādi rekvizīti:
parent_triggerid - (ID) trigeru prototipa ID, no kura tika izveidots trigeris;
status - (int) trigeru atklāšanas statuss:
0 - (noklusējums) trigeris ir atklāts,
1 - trigeris vairs nav atklāts;
ts_delete - (timestamp) laiks, kad vairs neatklātais trigeris tiks dzēsts;
ts_disable - (timestamp) laiks, kad vairs neatklātais trigeris tiks atspējots;
disable_source - (int) indikators, kas norāda, vai trigeri atspējoja LLD noteikums vai manuāli:
0 - (noklusējums) atspējots automātiski,
1 - atspējojis LLD noteikums.
selectDiscoveryRule query Atgriež zemā līmeņa atklāšanas noteikumu, kas izveidoja trigeri, rekvizītā discoveryRule.
selectLastEvent query Atgriež pēdējo nozīmīgo trigeru notikumu rekvizītā lastEvent.
selectTags query Atgriež trigeru tagus rekvizītā tags.
inheritedTags boolean Atgriež trigerus, kuriem norādītie tags ir arī veidnē, hostā vai saistītajās veidnēs.

Iespējamās vērtības:
true - veidnēm, hostam vai saistītajām veidnēm arī jābūt norādītajiem tagiem;
false - (noklusējums) veidņu, hosta vai saistīto veidņu tagi tiek ignorēti.
selectInheritedTags query Atgriež inheritedTags rekvizītu ar tagiem, kas mantoti no veidnēm, saistītajām veidnēm un hostiem, kā arī no vienumiem, uz kuriem ir atsauces trigeru vai atkopšanas izteiksmēs.
selectTemplateGroups query Atgriež veidņu grupas, kurām trigeris pieder, rekvizītā templategroups.
filter object Atgriež tikai tos rezultātus, kas precīzi atbilst norādītajam filtram.

Pieņem objektu, kurā atslēgas ir rekvizītu nosaukumi, bet vērtības ir viena vērtība vai vērtību masīvs, ar ko veikt salīdzināšanu.

Neatbalsta text datu tipa rekvizītus.

Atbalsta papildu rekvizītus:
host - hosta, kuram pieder trigeris, tehniskais nosaukums;
hostid - hosta, kuram pieder trigeris, ID.
limitSelects integer Ierobežo apakšatlases atgriezto ierakstu skaitu.

Attiecas uz šādām apakšatlasēm:
selectHosts - rezultāti tiks kārtoti pēc host.
sortfield string/array Kārto rezultātu pēc norādītajiem rekvizītiem.

Iespējamās vērtības: triggerid, description, status, priority, lastchange, hostname.
countOutput boolean Šie parametri ir aprakstīti atsauces komentāros.
editable boolean
excludeSearch boolean
limit integer
output query
preservekeys boolean
search object
searchByAny boolean
searchWildcardsEnabled boolean
sortorder string/array
startSearch boolean
selectTriggerDiscovery query Atgriež trigeru atklāšanas objektu rekvizītā triggerDiscovery. Trigeru atklāšanas objekti sasaista trigeri ar trigeru prototipu, no kura tas tika izveidots.

Šis vaicājums ir novecojis; tā vietā izmantojiet selectDiscoveryData.

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 trigera ID

Izgūstiet visus datus un funkcijas, kas tiek izmantotas trigerī "14062".

Pieprasījums:

{
    "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",
                    "triggerid": "14062",
                    "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ā.

Pieprasījums:

{
    "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 ar tagiem izgūšana

Izgūstiet konkrētu trigeri ar tagiem.

Pieprasījums:

{
    "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\")}",
                    "automatic": "1"
                },
                {
                    "tag": "error",
                    "value": "",
                    "automatic": "1"
                }
            ]
        }
    ],
    "id": 1
}

Skatiet arī

Avots

CTrigger::get() failā ui/include/classes/api/services/CTrigger.php.