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. Ir arī iespējams, ja tas ir norādīts, papildus izgūt nesen atrisinātas problēmas. Periods, kas nosaka, cik sens ir “nesen”, ir definēts sadaļā Administrēšana → Vispārīgi. Problēmas, kas tika atrisinātas pirms šī perioda, netiek glabātas problēmu tabulā. Lai izgūtu problēmas, kas tika atrisinātas vēl senākā pagātnē, izmantojiet metodi event.get.

Šī metode var atgriezt dzēstas entītijas problēmas, ja housekeeper tās vēl nav noņēmis.

Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var atsaukt lietotāju lomu iestatījumos. Plašāku informāciju skatiet sadaļā Lietotāju lomas.

Parametri

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

Metode atbalsta šādus parametrus.

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

Atbalstīto notikumu tipu sarakstu skatiet problēmas notikuma objekta lapā.

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

Atbalstīto objektu tipu sarakstu skatiet problēmas notikuma objekta lapā.

Noklusējums: 0 - trigeris.
acknowledged boolean Ja iestatīts uz true, atgriezt tikai apstiprinātās problēmas.
action integer Atgriezt tikai problēmas, kurām ir veiktas norādītās notikuma atjaunināšanas darbības. Vairākām darbībām izmantojiet jebkuru pieņemamo bitkartes vērtību summu kā bitmasku (piemēram, 34 notikuma apstiprināšanai un apspiešanai).
action_userids ID/array Atgriezt tikai problēmas ar norādītajiem to lietotāju ID, kuri veica problēmas notikuma atjaunināšanas darbības.
suppressed boolean Ja iestatīts uz true, atgriezt tikai apspiestās problēmas.
symptom boolean Ja iestatīts uz true, atgriezt tikai simptomu problēmu notikumus.
severities integer/array Atgriezt tikai problēmas ar norādītajām notikumu nopietnības pakāpēm. Attiecas tikai tad, ja object ir trigeris.
evaltype integer Birkas novērtēšanas metode.

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

Iespējamās operator 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, atgriezt nesenās problēmas, ieskaitot tās, kas atrisinātas ok_period laikā, kā arī visas neatrisinātās problēmas.
Ja iestatīts uz false, atgriezt tikai neatrisinātās problēmas.
eventid_from string Atgriezt tikai problēmas ar ID, kas ir lielāki vai vienādi ar norādīto ID.
eventid_till string Atgriezt tikai problēmas ar ID, kas ir mazāki vai vienādi ar norādīto ID.
time_from timestamp Atgriezt tikai problēmas, kas izveidotas pēc norādītā laika vai tieši tajā.
time_till timestamp Atgriezt tikai problēmas, kas izveidotas pirms norādītā laika vai tieši tajā.
selectAcknowledges query Atgriezt acknowledges īpašību ar problēmas atjauninājumiem. Problēmas atjauninājumi tiek kārtoti apgrieztā 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 nopietnības pakāpe pirms šīs atjaunināšanas darbības;
new_severity - (integer) notikuma nopietnības pakāpe pēc šīs atjaunināšanas darbības;
suppress_until - (timestamp) laiks, līdz kuram notikums būs apspiests;
taskid - (ID) uzdevuma ID, ja pašlaik notikumam tiek mainīts rangs.

Atbalsta count.
selectTags query Atgriezt tags īpašību ar problēmas birkām. Izvades formāts: [{"tag": "<tag>", "value": "<value>"}, ...].
selectSuppressionData query Atgriezt suppression_data īpašību ar aktīvo uzturēšanas periodu un manuālo apspiešanu sarakstu:
maintenanceid - (ID) uzturēšanas perioda ID;
userid - (ID) lietotāja ID, kurš apspieda problēmu;
suppress_until - (integer) laiks, līdz kuram problēma ir apspiesta.
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.
sortfield string/array Kārtot 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 šīm vērtībām:

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

Piemēri

Trigera problēmu notikumu izgūšana

Izgūst 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",
            "opdata": "",
            "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"
                }
            ],
            "suppression_data": [
                {
                    "maintenanceid": "15",
                    "suppress_until": "1472511600",
                    "userid": "0"
                }
            ],
            "suppressed": "1",
            "tags": [
                {
                    "tag": "test-tag",
                    "value": "test-value"
                }
            ]
        }
    ],
    "id": 1
}

Norādītā lietotāja apstiprināto problēmu izgūšana

Lietotāja ar ID=10 apstiprināto problēmu izgūšana

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 aģents uz localhost nav sasniedzams 5 minūtes",
            "acknowledged": "1",
            "severity": "3",
            "cause_eventid": "0",
            "opdata": "",
            "acknowledges": [
                {
                    "userid": "10",
                    "action": "2"
                }
            ],
            "suppressed": "0"
        }
    ],
    "id": 1
}

Skatiet arī

Avots

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