problem.get

Opis

integer/array problem.get(object parameters)

Metoda umożliwia pobieranie problemów zgodnie z podanymi parametrami.

Ta metoda służy do pobierania nierozwiązanych problemów. Jeśli zostanie to określone, możliwe jest również dodatkowe pobieranie ostatnio rozwiązanych problemów. Okres określający, jak dawno oznacza "ostatnio", jest zdefiniowany w Administracja > Ogólne. Problemy, które zostały rozwiązane przed tym okresem, nie są przechowywane w tabeli problemów. Aby pobrać problemy rozwiązane dalej w przeszłości, użyj metody event.get.

Ta metoda może zwrócić problemy usuniętej encji, jeśli nie zostały one jeszcze usunięte przez housekeeper.

Ta metoda jest dostępna dla użytkowników dowolnego typu. Uprawnienia do wywołania metody mogą zostać cofnięte w ustawieniach roli użytkownika. Więcej informacji można znaleźć w sekcji Role użytkowników.

Parametry

(object) Parametry definiujące oczekiwany wynik.

Metoda obsługuje następujące parametry.

Parameter Type Description
eventids ID/array Zwracaj tylko problemy o podanych ID.
groupids ID/array Zwracaj tylko problemy utworzone przez obiekty należące do podanych grup hostów.
hostids ID/array Zwracaj tylko problemy utworzone przez obiekty należące do podanych hostów.
objectids ID/array Zwracaj tylko problemy utworzone przez podane obiekty.
source integer Zwracaj tylko problemy o podanym typie.

Listę obsługiwanych typów zdarzeń znajdziesz na stronie obiektu zdarzenia problemu.

Domyślnie: 0 - problem utworzony przez wyzwalacz.
object integer Zwracaj tylko problemy utworzone przez obiekty podanego typu.

Listę obsługiwanych typów obiektów znajdziesz na stronie obiektu zdarzenia problemu.

Domyślnie: 0 - wyzwalacz.
acknowledged boolean Jeśli ustawione na true, zwracaj tylko potwierdzone problemy.
action integer Zwracaj tylko problemy, dla których wykonano podane akcje aktualizacji zdarzeń. W przypadku wielu akcji użyj sumy dowolnych akceptowalnych wartości bitmapy jako maski bitowej (na przykład 34 dla potwierdzenia i wyciszenia zdarzenia).
action_userids ID/array Zwracaj tylko problemy o podanych ID użytkowników, którzy wykonali akcje aktualizacji zdarzenia problemu.
suppressed boolean Jeśli ustawione na true, zwracaj tylko wyciszone problemy.
symptom boolean Jeśli ustawione na true, zwracaj tylko zdarzenia problemów będące symptomami.
severities integer/array Zwracaj tylko problemy o podanych ważnościach zdarzeń. Dotyczy tylko wtedy, gdy object jest wyzwalacz.
evaltype integer Metoda oceny etykiet.

Możliwe wartości:
0 - (domyślnie) And/Or;
2 - Or.
tags array Zwracaj tylko problemy z podanymi etykietami.
Format: [{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...].
Pusta tablica zwraca wszystkie problemy.

Możliwe wartości operatora:
0 - (domyślnie) Zawiera;
1 - Równa się;
2 - Nie zawiera;
3 - Nie równa się;
4 - Istnieje;
5 - Nie istnieje.
recent boolean Jeśli ustawione na true, zwracaj ostatnie problemy, w tym te rozwiązane w ciągu ok_period oraz wszystkie nierozwiązane problemy.
Jeśli ustawione na false, zwracaj tylko nierozwiązane problemy.
eventid_from string Zwracaj tylko problemy o ID większym lub równym podanemu ID.
eventid_till string Zwracaj tylko problemy o ID mniejszym lub równym podanemu ID.
time_from timestamp Zwracaj tylko problemy utworzone po podanym czasie lub w tym czasie.
time_till timestamp Zwracaj tylko problemy utworzone przed podanym czasem lub w tym czasie.
selectAcknowledges query Zwracaj właściwość acknowledges z aktualizacjami problemu. Aktualizacje problemu są sortowane w odwrotnej kolejności chronologicznej.

Obiekt aktualizacji problemu ma następujące właściwości:
acknowledgeid - (ID) ID aktualizacji;
userid - (ID) ID użytkownika, który zaktualizował zdarzenie;
eventid - (ID) ID zaktualizowanego zdarzenia;
clock - (timestamp) czas aktualizacji zdarzenia;
message - (string) treść wiadomości;
action - (integer)typ akcji aktualizacji (zobacz event.acknowledge);
old_severity - (integer) ważność zdarzenia przed tą akcją aktualizacji;
new_severity - (integer) ważność zdarzenia po tej akcji aktualizacji;
suppress_until - (timestamp) czas, do którego zdarzenie będzie wyciszone;
taskid - (ID) ID zadania, jeśli bieżące zdarzenie przechodzi zmianę rangi;
maintenanceid - (ID) ID konserwacji.

Obsługuje count.
selectTags query Zwracaj właściwość tags z etykietami problemu. Format wyjściowy: [{"tag": "<tag>", "value": "<value>"}, ...].
selectSuppressionData query Zwracaj właściwość suppression_data z listą aktywnych konserwacji i ręcznych wyciszeń:
maintenanceid - (ID) ID konserwacji;
userid - (ID) ID użytkownika, który wyciszył problem;
suppress_until - (integer) czas, do którego problem jest wyciszony.
filter object Zwracaj tylko te wyniki, które dokładnie pasują do podanego filtra.

Przyjmuje obiekt, w którym klucze są nazwami właściwości, a wartościami jest pojedyncza wartość lub tablica wartości, z którymi ma zostać wykonane dopasowanie.

Nie obsługuje właściwości typu text data type.
sortfield string/array Sortuj wynik według podanych właściwości.

Możliwe wartości: eventid.
countOutput boolean Te parametry są opisane w komentarzu referencyjnym.
editable boolean
excludeSearch boolean
limit integer
output query
preservekeys boolean
search object
searchByAny boolean
searchWildcardsEnabled boolean
sortorder string/array
startSearch boolean

Zwracane wartości

(integer/array) Zwraca:

  • tablicę obiektów;
  • liczbę pobranych obiektów, jeśli użyto parametru countOutput.

Przykłady

Pobieranie zdarzeń problemów wyzwalacza

Pobierz ostatnie zdarzenia z wyzwalacza "15112."

Żądanie:

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

Odpowiedź:

{
    "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 on localhost is unreachable for 5 minutes",
            "acknowledged": "1",
            "severity": "3",
            "cause_eventid": "0",
            "suppressed": "1",
            "acknowledges": [
                {
                    "acknowledgeid": "14443",
                    "userid": "1",
                    "eventid": "1245463",
                    "clock": "1472457281",
                    "message": "problem solved",
                    "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
}

Pobieranie problemów potwierdzonych przez określonego użytkownika

Pobieranie problemów potwierdzonych przez użytkownika o ID=10

Żądanie:

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

Odpowiedź:

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

Zobacz także

Źródło

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