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 Atgriezt tikai trigerus ar norādītajiem ID.
groupids ID/array Atgriezt tikai trigerus, kas pieder hostiem 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 hostiem.
itemids ID/array Atgriezt tikai trigerus, kas satur norādītos vienumus.
maintenanceids ID/array Atgriezt tikai trigerus, kurus ietekmē norādītās uzturēšanas darbības.
functions string/array Atgriezt tikai trigerus, kuros tiek izmantotas norādītās funkcijas.

Atbalstīto funkciju sarakstu skatiet lapā atbalstītās funkcijas.
group string Atgriezt tikai trigerus, kas pieder hostiem 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ējotus trigerus, kas pieder uzraudzītiem hostiem un satur tikai iespējotus vienumus.
active flag Atgriezt tikai iespējotus trigerus, kas pieder uzraudzītiem hostiem.
maintenance boolean Ja iestatīts uz true, atgriezt tikai iespējotus trigerus, kas pieder uzturēšanā esošiem hostiem.
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, kuru pēdējais notikums nav apstiprināts.
skipDependent flag Izlaist trigerus problēmas stāvoklī, 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 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ī (pēdējā ok_period laikā).
min_severity integer Atgriezt 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 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) Satur;
1 - Ir vienāds ar;
2 - Nesatur;
3 - Nav vienāds ar;
4 - Pastāv;
5 - Nepastāv.
expandComment flag Izvērst makro trigeru aprakstā.
expandDescription flag Izvērst makro trigeru nosaukumā.
expandExpression flag Izvērst funkcijas un makro trigeru izteiksmē.
selectHostGroups query Atgriezt hostu grupas, kurām trigeris pieder, hostgroups īpašībā.
selectHosts query Atgriezt hostus, kuriem trigeris pieder, hosts īpašībā.
selectItems query Atgriezt trigerī ietvertos vienumus items īpašībā.
selectFunctions query Atgriezt trigerī izmantotās funkcijas functions īpašībā.

Funkciju objekti attēlo trigeru izteiksmē izmantotās funkcijas, un tiem ir šādas īpašības:
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 Atgriezt trigerus, no kuriem trigeris ir atkarīgs, dependencies īpašībā.
selectDiscoveryData query Atgriezt discoveryData īpašību 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 šādas īpašības:
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ē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 trigeru notikumu lastEvent īpašībā.
selectTags query Atgriezt trigeru tagus tags īpašībā.
inheritedTags boolean Atgriezt 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 Atgriezt inheritedTags īpašību ar tagiem, kas mantoti no veidnēm, saistītajām veidnēm un hostiem, kā arī no vienumiem, uz kuriem ir atsauce trigeru vai atkopšanas izteiksmēs.
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 viena vērtība vai vērtību masīvs, ar ko veikt salīdzināšanu.

Neatbalsta text datu tipa īpašības.

Atbalsta papildu īpašības:
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ā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 uzziņas 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 Atgriezt trigeru atklāšanas objektu triggerDiscovery īpašībā. 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.