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 ID.
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 użyj sumy dowolnych akceptowalnych wartości bitmapy jako maski bitowej (na przykład 34 dla potwierdzenia i wyciszenia zdarzenia).
action_userids ID/array Zwraca tylko problemy z podanymi ID 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ówne;
2 - Nie zawiera;
3 - Nie równa się;
4 - Istnieje;
5 - Nie istnieje.
recent boolean Jeśli ustawiono na true, zwraca tylko niedawno rozwiązane problemy (zależy od ok_period).
eventid_from string Zwraca tylko problemy o ID większym lub równym podanemu ID.
eventid_till string Zwraca tylko problemy o ID mniejszym lub równym podanemu ID.
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) 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.

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 konserwacji i ręcznych wyciszeń:
maintenanceid - (ID) ID okresu konserwacji;
userid - (ID) ID 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 klucze są nazwami właściwości, a wartości są pojedynczą wartością lub tablicą 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 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 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.