problem.get

Apraksts

integer/array problem.get(object parameters)

Metode ļauj izgūt problēmas atbilstoši norādītajiem parametriem.

Šī metode ir paredzēta neatrisinātu problēmu izgūšanai. Ja tas ir norādīts, ir iespējams papildus izgūt arī nesen atrisinātas problēmas. Periods, kas nosaka, cik sena ir "nesen", ir definēts sadaļā Administrēšana > Vispārīgi. Problēmas, kas tika atrisinātas pirms šī perioda, netiek saglabātas problēmu tabulā. Lai izgūtu problēmas, kas tika atrisinātas senāk, izmantojiet event.get metodi.

Šī metode var atgriezt dzēsta objekta problēmas, ja šīs problēmas vēl nav noņēmis housekeeper.

Šī 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 definē vēlamo izvadi.

Metode atbalsta šādus parametrus.

Parameter Type Description
eventids ID/array Atgriež tikai problēmas ar norādītajiem ID.
groupids ID/array Atgriež tikai problēmas, ko izveidojuši objekti, kas pieder norādītajām hostu grupām.
hostids ID/array Atgriež tikai problēmas, ko izveidojuši objekti, kas pieder norādītajiem hostiem.
objectids ID/array Atgriež tikai problēmas, ko izveidojuši norādītie objekti.
source integer Atgriež tikai problēmas ar norādīto tipu.

Skatiet problēmas notikuma objekta lapu, lai iegūtu atbalstīto notikumu tipu sarakstu.

Noklusējums: 0 - problēma, ko izveidojis trigeris.
object integer Atgriež tikai problēmas, ko izveidojuši norādītā tipa objekti.

Skatiet problēmas notikuma objekta lapu, lai iegūtu atbalstīto objektu tipu sarakstu.

Noklusējums: 0 - trigeris.
acknowledged boolean Ja iestatīts uz true, atgriež tikai apstiprinātas problēmas.
action integer Atgriež tikai problēmas, kurām ir veikta norādītā notikuma atjaunināšanas darbība. Vairākām darbībām izmantojiet jebkuru pieņemamu bitkartes vērtību summu kā bitmasku (piemēram, 34 apstiprināšanai un notikuma slāpēšanai).
action_userids ID/array Atgriež tikai problēmas ar norādītajiem lietotāju ID, kuri veica problēmas notikuma atjaunināšanas darbības.
suppressed boolean Ja iestatīts uz true, atgriež tikai slāpētas problēmas.
symptom boolean Ja iestatīts uz true, atgriež tikai simptomu problēmu notikumus.
severities integer/array Atgriež tikai problēmas ar norādītajām notikumu smaguma pakāpēm. Attiecas tikai tad, ja object ir triggeris.
evaltype integer Tagu novērtēšanas metode.

Iespējamās vērtības:
0 - (noklusējums) Un/Or;
2 - Or.
tags array Atgriež tikai problēmas ar norādītajiem tagiem.
Formāts: [{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...].
Tukšs masīvs atgriež visas problēmas.

Iespējamās operatora vērtības:
0 - (noklusējums) Satur;
1 - Vienāds ar;
2 - Nesatur;
3 - Nav vienāds ar;
4 - Eksistē;
5 - Neeksistē.
recent boolean Ja iestatīts uz true, atgriež nesenās problēmas, tostarp tās, kas atrisinātas ok_period laikā, kā arī visas neatrisinātās problēmas.
Ja iestatīts uz false, atgriež tikai neatrisinātās problēmas.
eventid_from string Atgriež tikai problēmas ar ID, kas ir lielāks vai vienāds ar norādīto ID.
eventid_till string Atgriež tikai problēmas ar ID, kas ir mazāks vai vienāds ar norādīto ID.
time_from timestamp Atgriež tikai problēmas, kas izveidotas pēc norādītā laika vai tā laikā.
time_till timestamp Atgriež tikai problēmas, kas izveidotas pirms norādītā laika vai tā laikā.
selectAcknowledges query Atgriež acknowledges īpašību ar problēmas atjauninājumiem. Problēmas atjauninājumi ir sakārtoti dilstošā hronoloģiskā secībā.

Problēmas atjauninājuma objektam ir šādas īpašības:
acknowledgeid - (ID) atjauninājuma ID;
userid - (ID) lietotāja ID, kurš atjaunināja notikumu;
eventid - (ID) atjauninātā notikuma ID;
clock - (timestamp) laiks, kad notikums tika atjaunināts;
message - (string) ziņojuma teksts;
action - (integer) atjaunināšanas darbības tips (skatiet event.acknowledge);
old_severity - (integer) notikuma smaguma pakāpe pirms šīs atjaunināšanas darbības;
new_severity - (integer) notikuma smaguma pakāpe pēc šīs atjaunināšanas darbības;
suppress_until - (timestamp) laiks, līdz kuram notikums tiks slāpēts;
taskid - (ID) uzdevuma ID, ja pašreizējais notikums tiek pakļauts prioritātes maiņai;
maintenanceid - (ID) apkopes ID.

Atbalsta count.
selectTags query Atgriež tags īpašību ar problēmas tagiem. Izvades formāts: [{"tag": "<tag>", "value": "<value>"}, ...].
selectSuppressionData query Atgriež suppression_data īpašību ar aktīvo apkopju un manuālo slāpēšanu sarakstu:
maintenanceid - (ID) apkopes ID;
userid - (ID) lietotāja ID, kurš slāpēja problēmu;
suppress_until - (integer) laiks, līdz kuram problēma ir slāpēta.
filter object Atgriež 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, pret ko salīdzināt.

Neatbalsta text datu tipa īpašības.
sortfield string/array Kārto rezultātu pēc norādītajām īpašībām.

Iespējamās vērtības: eventid.
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

Atgrieztās vērtības

(integer/array) Atgriež vienu no šiem:

  • objektu masīvu;
  • izgūto objektu skaitu, ja ir izmantots parametrs countOutput.

Piemēri

Trigeru problēmu notikumu izgūšana

Izgūstiet nesenos notikumus no trigera "15112."

Pieprasījums:

{
    "jsonrpc": "2.0",
    "method": "problem.get",
    "params": {
        "output": "extend",
        "selectAcknowledges": "extend",
        "selectTags": "extend",
        "selectSuppressionData": "extend",
        "objectids": "15112",
        "recent": true,
        "sortfield": ["eventid"],
        "sortorder": "DESC"
    },
    "id": 1
}

Atbilde:

{
    "jsonrpc": "2.0",
    "result": [
        {
            "eventid": "1245463",
            "source": "0",
            "object": "0",
            "objectid": "15112",
            "clock": "1472457242",
            "ns": "209442442",
            "r_eventid": "1245468",
            "r_clock": "1472457285",
            "r_ns": "125644870",
            "correlationid": "0",
            "userid": "1",
            "name": "Zabbix aģents uz localhost nav sasniedzams 5 minūtes",
            "acknowledged": "1",
            "severity": "3",
            "cause_eventid": "0",
            "suppressed": "1",
            "acknowledges": [
                {
                    "acknowledgeid": "14443",
                    "userid": "1",
                    "eventid": "1245463",
                    "clock": "1472457281",
                    "message": "problēma atrisināta",
                    "action": "6",
                    "old_severity": "0",
                    "new_severity": "0",
                    "suppress_until": "1472511600",
                    "taskid": "0",
                    "maintenanceid": "0"
                }
            ],
            "opdata": "",
            "suppression_data": [
                {
                    "maintenanceid": "15",
                    "suppress_until": "1472511600",
                    "userid": "0"
                }
            ],
            "tags": [
                {
                    "tag": "test-tag",
                    "value": "test-value"
                }
            ],
            "urls": []
        }
    ],
    "id": 1
}

To retrieve problems acknowledged by specified user

Problēmu izgūšana, ko apstiprinājis lietotājs ar ID=10

Pieprasījums:

{
    "jsonrpc": "2.0",
    "method": "problem.get",
    "params": {
        "output": "extend",
        "action": 2,
        "action_userids": [10],
        "selectAcknowledges": ["userid", "action"],
        "sortfield": ["eventid"],
        "sortorder": "DESC"
    },
    "id": 1
}

Atbilde:

{
    "jsonrpc": "2.0",
    "result": [
        {
            "eventid": "1248566",
            "source": "0",
            "object": "0",
            "objectid": "15142",
            "clock": "1472457242",
            "ns": "209442442",
            "r_eventid": "1245468",
            "r_clock": "1472457285",
            "r_ns": "125644870",
            "correlationid": "0",
            "userid": "10",
            "name": "Zabbix agent on localhost is unreachable for 5 minutes",
            "acknowledged": "1",
            "severity": "3",
            "cause_eventid": "0",
            "suppressed": "0",
            "acknowledges": [
                {
                    "acknowledgeid": "9",
                    "userid": "10",
                    "action": "2"
                }
            ],
            "opdata": "",
            "urls": []
        }
    ],
    "id": 1
}

Skatiet arī

Avots

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