problem.get

Opis

integer/array problem.get(object parameters)

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

Ta metoda służy do pobierania nierozwiązanych problemów. Możliwe jest również, jeśli to określono, dodatkowe pobieranie niedawno rozwiązanych problemów. Okres, który określa, jak stare oznacza „niedawno”, 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, które zostały rozwiązane wcześniej w przeszłości, użyj metody event.get.

Ta metoda może zwracać problemy usuniętej jednostki, jeśli problemy te nie zostały jeszcze usunięte przez housekeeper.

Ta metoda jest dostępna dla użytkowników dowolnego typu. Uprawnienia do wywoływania tej metody mogą zostać cofnięte w ustawieniach roli użytkownika. Więcej informacji znajduje się w sekcji Role użytkowników.

Parametry

(object) Parametry definiujące żądane dane wyjściowe.

Metoda obsługuje następujące parametry.

Parametr Typ Opis
eventids ID/array Zwraca tylko problemy o podanych identyfikatorach.
groupids ID/array Zwraca tylko problemy utworzone przez obiekty należące do podanych grup hostów.
hostids ID/array Zwraca tylko problemy utworzone przez obiekty należące do podanych hostów.
objectids ID/array Zwraca tylko problemy utworzone przez podane obiekty.
source integer Zwraca tylko problemy o podanym typie.

Listę obsługiwanych typów zdarzeń można znaleźć na stronie obiektu zdarzenia problemu.

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

Listę obsługiwanych typów obiektów można znaleźć na stronie obiektu zdarzenia problemu.

Domyślnie: 0 - wyzwalacz.
acknowledged boolean Jeśli ustawiono na true, zwraca tylko potwierdzone problemy.
action integer Zwraca tylko problemy, dla których wykonano podane akcje aktualizacji zdarzenia. W przypadku wielu akcji należy użyć sumy dowolnych akceptowalnych wartości mapy bitowej jako maski bitowej (na przykład 34 dla potwierdzenia i wyciszenia zdarzenia).
action_userids ID/array Zwraca tylko problemy z podanymi identyfikatorami użytkowników, którzy wykonali akcje aktualizacji zdarzenia problemu.
suppressed boolean Jeśli ustawiono na true, zwraca tylko wyciszone problemy.
symptom boolean Jeśli ustawiono na true, zwraca tylko zdarzenia problemów będące symptomami.
severities integer/array Zwraca tylko problemy o podanych poziomach ważności zdarzeń. Ma zastosowanie tylko wtedy, gdy object to trigger.
evaltype integer Metoda oceny tagów.

Możliwe wartości:
0 - (domyślnie) And/Or;
2 - Or.
tags array Zwraca tylko problemy z podanymi tagami.
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 ustawiono na true, zwraca ostatnie problemy, w tym te rozwiązane w ciągu ok_period, oraz wszystkie nierozwiązane problemy.
Jeśli ustawiono na false, zwraca tylko nierozwiązane problemy.
eventid_from string Zwraca tylko problemy o identyfikatorach większych lub równych podanemu identyfikatorowi.
eventid_till string Zwraca tylko problemy o identyfikatorach mniejszych lub równych podanemu identyfikatorowi.
time_from timestamp Zwraca tylko problemy utworzone po podanym czasie lub dokładnie o podanym czasie.
time_till timestamp Zwraca tylko problemy utworzone przed podanym czasem lub dokładnie o podanym czasie.
selectAcknowledges query Zwraca 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) identyfikator aktualizacji;
userid - (ID) identyfikator użytkownika, który zaktualizował zdarzenie;
eventid - (ID) identyfikator 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) identyfikator zadania, jeśli bieżące zdarzenie przechodzi zmianę rangi.

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

Akceptuje obiekt, w którym kluczami są nazwy właściwości, a wartościami są pojedyncza wartość lub tablica wartości do dopasowania.

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

Możliwe wartości: eventid.
countOutput boolean Te parametry opisano 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 został użyty parametr countOutput.

Przykłady

Pobieranie zdarzeń problemów wyzwalacza

Pobierz ostatnie zdarzenia dla 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": "Agent Zabbix na localhost jest niedostępny przez 5 minut",
            "acknowledged": "1",
            "severity": "3",
            "cause_eventid": "0",
            "opdata": "",
            "acknowledges": [
                {
                    "acknowledgeid": "14443",
                    "userid": "1",
                    "eventid": "1245463",
                    "clock": "1472457281",
                    "message": "problem rozwiązany",
                    "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
}

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": "Agent Zabbix na localhost jest niedostępny przez 5 minut",
            "acknowledged": "1",
            "severity": "3",
            "cause_eventid": "0",
            "opdata": "",
            "acknowledges": [
                {
                    "userid": "10",
                    "action": "2"
                }
            ],
            "suppressed": "0"
        }
    ],
    "id": 1
}

Zobacz także

Źródło

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