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ējotus trigerus, kas pieder uzraudzītiem hosts un satur tikai iespējotus vienumus.
active flag Atgriezt tikai iespējotus trigerus, kas pieder uzraudzītiem hosts.
maintenance boolean Ja iestatīts uz true, atgriezt tikai iespējotus 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ī.
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 Atzīmju 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ītajām atzīmēm.
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 trigeris aprakstā.
expandDescription flag Izvērst makro trigeris nosaukumā.
expandExpression flag Izvērst funkcijas un makro trigeris 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 trigeris 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 trigeris atklāšanas objekta datiem. Trigeris atklāšanas objekts saista atklāto trigeris ar trigeris prototipu, no kura tas tika atklāts.

Tam ir šādas īpašības:
parent_triggerid - (ID) trigeris prototipa ID, no kura trigeris ir izveidots;
status - (int) trigeris 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 trigeris, discoveryRule īpašībā.
selectLastEvent query Atgriezt pēdējo nozīmīgo trigeris notikumu lastEvent īpašībā.
selectTags query Atgriezt trigeris atzīmes 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.

Neatbalsta text datu tipa īpašības.

Atbalsta papildu īpašības:
host - hosta tehniskais nosaukums, kuram pieder trigeris;
hostid - hosta ID, kuram pieder trigeris.
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 trigeris atklāšanas objektu triggerDiscovery īpašībā. Trigeris atklāšanas objekti saista trigeris ar trigeris 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".

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",
                    "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 iegūšana ar tagiem

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

Skatiet arī

Avots

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