problem.get

Beschreibung

integer/array problem.get(object parameters)

Die Methode ermöglicht das Abrufen von Problemen anhand der angegebenen Parameter.

Diese Methode dient zum Abrufen nicht gelöster Probleme. Falls angegeben, ist es außerdem möglich, zusätzlich kürzlich gelöste Probleme abzurufen. Der Zeitraum, der bestimmt, wie alt "kürzlich" ist, wird unter Administration → Allgemein definiert. Probleme, die vor diesem Zeitraum gelöst wurden, werden nicht in der Problem-Tabelle gespeichert. Um Probleme abzurufen, die weiter in der Vergangenheit gelöst wurden, verwenden Sie die Methode event.get.

Diese Methode kann Probleme einer gelöschten Entität zurückgeben, wenn diese Probleme vom Housekeeper noch nicht entfernt wurden.

Diese Methode ist für Benutzer aller Typen verfügbar. Die Berechtigung zum Aufruf der Methode kann in den Einstellungen der Benutzerrolle widerrufen werden. Weitere Informationen finden Sie unter Benutzerrollen.

Parameter

(object) Parameter, die die gewünschte Ausgabe definieren.

Die Methode unterstützt die folgenden Parameter.

Parameter Type Beschreibung
eventids ID/array Gibt nur Probleme mit den angegebenen IDs zurück.
groupids ID/array Gibt nur Probleme zurück, die von Objekten erstellt wurden, die zu den angegebenen Host-Gruppen gehören.
hostids ID/array Gibt nur Probleme zurück, die von Objekten erstellt wurden, die zu den angegebenen Hosts gehören.
objectids ID/array Gibt nur Probleme zurück, die von den angegebenen Objekten erstellt wurden.
source integer Gibt nur Probleme mit dem angegebenen Typ zurück.

Eine Liste der unterstützten Ereignistypen finden Sie auf der Seite Problemereignisobjekt.

Standard: 0 - Problem, das durch einen Auslöser erstellt wurde.
object integer Gibt nur Probleme zurück, die von Objekten des angegebenen Typs erstellt wurden.

Eine Liste der unterstützten Objekttypen finden Sie auf der Seite Problemereignisobjekt.

Standard: 0 - Auslöser.
acknowledged boolean Wenn auf true gesetzt, werden nur bestätigte Probleme zurückgegeben.
action integer Gibt nur Probleme zurück, für die die angegebenen Ereignisaktualisierungsaktionen durchgeführt wurden. Verwenden Sie bei mehreren Aktionen die Summe beliebiger zulässiger Bitmap-Werte als Bitmaske (zum Beispiel 34 für Bestätigen und Unterdrücken des Ereignisses).
action_userids ID/array Gibt nur Probleme mit den angegebenen IDs von Benutzern zurück, die die Aktualisierungsaktionen des Problemereignisses durchgeführt haben.
suppressed boolean Wenn auf true gesetzt, werden nur unterdrückte Probleme zurückgegeben.
symptom boolean Wenn auf true gesetzt, werden nur Symptom-Problemereignisse zurückgegeben.
severities integer/array Gibt nur Probleme mit den angegebenen Ereignisschweregraden zurück. Gilt nur, wenn object ein Auslöser ist.
evaltype integer Tag-Auswertungsmethode.

Mögliche Werte:
0 - (Standard) Und/Oder;
2 - Oder.
tags array Gibt nur Probleme mit den angegebenen Tags zurück.
Format: [{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...].
Ein leeres Array gibt alle Probleme zurück.

Mögliche Werte für operator:
0 - (Standard) Enthält;
1 - Entspricht;
2 - Enthält nicht;
3 - Entspricht nicht;
4 - Existiert;
5 - Existiert nicht.
recent boolean Wenn auf true gesetzt, werden aktuelle Probleme zurückgegeben, einschließlich derjenigen, die innerhalb von ok_period behoben wurden, sowie aller ungelösten Probleme.
Wenn auf false gesetzt, werden nur ungelöste Probleme zurückgegeben.
eventid_from string Gibt nur Probleme mit IDs zurück, die größer oder gleich der angegebenen ID sind.
eventid_till string Gibt nur Probleme mit IDs zurück, die kleiner oder gleich der angegebenen ID sind.
time_from timestamp Gibt nur Probleme zurück, die nach oder zum angegebenen Zeitpunkt erstellt wurden.
time_till timestamp Gibt nur Probleme zurück, die vor oder zum angegebenen Zeitpunkt erstellt wurden.
selectAcknowledges query Gibt eine acknowledges-Eigenschaft mit den Problemaktualisierungen zurück. Problemaktualisierungen werden in umgekehrter chronologischer Reihenfolge sortiert.

Das Problemaktualisierungsobjekt hat die folgenden Eigenschaften:
acknowledgeid - (ID) ID der Aktualisierung;
userid - (ID) ID des Benutzers, der das Ereignis aktualisiert hat;
eventid - (ID) ID des aktualisierten Ereignisses;
clock - (timestamp) Zeitpunkt, zu dem das Ereignis aktualisiert wurde;
message - (string) Text der Nachricht;
action - (integer)Typ der Aktualisierungsaktion (siehe event.acknowledge);
old_severity - (integer) Ereignisschweregrad vor dieser Aktualisierungsaktion;
new_severity - (integer) Ereignisschweregrad nach dieser Aktualisierungsaktion;
suppress_until - (timestamp) Zeitpunkt, bis zu dem das Ereignis unterdrückt wird;
taskid - (ID) ID der Aufgabe, falls für das aktuelle Ereignis gerade eine Rangänderung durchgeführt wird.

Unterstützt count.
selectTags query Gibt eine tags-Eigenschaft mit den Problem-Tags zurück. Ausgabeformat: [{"tag": "<tag>", "value": "<value>"}, ...].
selectSuppressionData query Gibt eine suppression_data-Eigenschaft mit der Liste aktiver Wartungen und manueller Unterdrückungen zurück:
maintenanceid - (ID) ID der Wartung;
userid - (ID) ID des Benutzers, der das Problem unterdrückt hat;
suppress_until - (integer) Zeitpunkt, bis zu dem das Problem unterdrückt wird.
filter object Gibt nur die Ergebnisse zurück, die exakt dem angegebenen Filter entsprechen.

Akzeptiert ein Objekt, bei dem die Schlüssel Eigenschaftsnamen sind und die Werte entweder ein einzelner Wert oder ein Array von Werten sind, mit denen abgeglichen werden soll.

Unterstützt keine Eigenschaften des text-Datentyps.
sortfield string/array Sortiert das Ergebnis nach den angegebenen Eigenschaften.

Mögliche Werte: eventid.
countOutput boolean Diese Parameter sind in der Referenzkommentierung beschrieben.
editable boolean
excludeSearch boolean
limit integer
output query
preservekeys boolean
search object
searchByAny boolean
searchWildcardsEnabled boolean
sortorder string/array
startSearch boolean

Rückgabewerte

(integer/array) Gibt entweder Folgendes zurück:

  • ein Array von Objekten;
  • die Anzahl der abgerufenen Objekte, wenn der Parameter countOutput verwendet wurde.

Beispiele

Abrufen von Problemereignissen eines Auslösers

Rufen Sie aktuelle Ereignisse des Auslösers „15112“ ab.

Anfrage:

{
    "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
}

Antwort:

{
    "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-Agent auf localhost ist seit 5 Minuten nicht erreichbar",
            "acknowledged": "1",
            "severity": "3",
            "cause_eventid": "0",
            "opdata": "",
            "acknowledges": [
                {
                    "acknowledgeid": "14443",
                    "userid": "1",
                    "eventid": "1245463",
                    "clock": "1472457281",
                    "message": "Problem behoben",
                    "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
}

Abrufen von Problemen, die von einem angegebenen Benutzer bestätigt wurden

Abrufen von Problemen, die von einem Benutzer mit ID=10 bestätigt wurden

Anfrage:

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

Antwort:

{
    "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 auf localhost ist seit 5 Minuten nicht erreichbar",
            "acknowledged": "1",
            "severity": "3",
            "cause_eventid": "0",
            "opdata": "",
            "acknowledges": [
                {
                    "userid": "10",
                    "action": "2"
                }
            ],
            "suppressed": "0"
        }
    ],
    "id": 1
}

Siehe auch

Quelle

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