problem.get

Opis

integer/array problem.get(object parameters)

Metoda umożliwia pobranie problemów zgodnie z określonymi parametrami.

Ta metoda służy do pobierania nierozwiązanych problemów. Istnieje również możliwość dodatkowego pobrania niedawno rozwiązanych problemów, jeśli jest to określone. Okres, który określa, jak stary jest "niedawno", jest definiowany w Administracja → Ogólne. Problemy rozwiązane wcześniej niż ten okres nie są przechowywane w tabeli problemów. Aby pobrać problemy rozwiązane wcześniej w przeszłości, należy użyć metody event.get.

Ta metoda może zwracać problemy związane z usuniętym obiektem, jeśli te problemy nie zostały jeszcze usunięte przez porządkowanie.

Ta metoda jest dostępna dla użytkowników dowolnego typu. Uprawnienia do wywoływania metody można odebrać w ustawieniach roli użytkownika. Zobacz Role użytkownika aby uzyskać więcej informacji.

Parametry

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

Metoda obsługuje następujące parametry.

Parametr	Typ	Opis
eventids	string/array	Zwróć tylko problemy o podanych identyfikatorach.
groupids	string/array	Zwróć tylko problemy utworzone przez obiekty należące do podanych grup hostów.
hostids	string/array	Zwróć tylko problemy utworzone przez obiekty należące do podanych hostów.
objectids	string/array	Zwróć tylko problemy utworzone przez podane obiekty.
source	integer	Zwróć tylko problemy o podanym typie. Odwołaj się do strony problem event object page dla listy obsługiwanych typów zdarzeń. Domyślnie: 0 - problem utworzony przez wyzwalacz.
object	integer	Zwróć tylko problemy utworzone przez obiekty o podanym typie. Sprawdź stronę obiektu zdarzenia problemu dla listy obsługiwanych typów obiektów. Domyślnie: 0 - wyzwalacz.
acknowledged	boolean	`true` - zwróć tylko problemy potwierdzone; `false` - tylko niepotwierdzone.
suppressed	boolean	`true` - zwróć tylko problemy w stanie wstrzymanym; `false` - zwróć problemy w normalnym stanie.
severities	integer/array	Zwróć tylko problemy o podanych poziomach zdarzeń. Dotyczy tylko wyzwalacza.
evaltype	integer	Reguły wyszukiwania znaczników. Możliwe wartości: 0 - (domyślnie) I/Lub; 2 - Lub.
tags	array of objects	Zwróć tylko problemy z podanymi znacznikami. Dokładne dopasowanie według tagu i wyszukiwanie wartości niezależnie od wielkości liter i operatora. Format: `[{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...]`. Pusta tablica zwraca wszystkie problemy. Możliwe typy operatorów: 0 - (domyślnie) Zawiera; 1 - Jest równy; 2 - Nie zawiera; 3 - Nie jest równy; 4 - Istnieje; 5 - Nie istnieje.
recent	boolean	`true` - zwróć PROBLEM i niedawno ROZWIĄZANE problemy (zależy od czasu wyświetlania OK wyzwalaczy przez N sekund) Domyślnie: `false` - tylko nierozwiązane problemy
eventid_from	string	Zwróć tylko problemy o identyfikatorach większych lub równych podanemu ID.
eventid_till	string	Zwróć tylko problemy o identyfikatorach mniejszych lub równych podanemu ID.
time_from	timestamp	Zwróć tylko problemy utworzone po lub o podanym czasie.
time_till	timestamp	Zwróć tylko problemy utworzone przed lub o podanym czasie.
selectAcknowledges	query	Zwróć właściwość `acknowledges` z aktualizacjami problemu. Aktualizacje problemów są sortowane w odwrotnej kolejności chronologicznej. Obiekt aktualizacji problemu ma następujące właściwości: `acknowledgeid` - `(string)` ID aktualizacji; `userid` - `(string)` ID użytkownika, który zaktualizował zdarzenie; `eventid` - `(string)` ID zaktualizowanego zdarzenia; `clock` - `(timestamp)` czas, gdy zdarzenie zostało zaktualizowane; `message` - `(string)` treść wiadomości; `action` - `(integer)` typ akcji aktualizacji (patrz event.acknowledge); `old_severity` - `(integer)` powaga zdarzenia przed tą akcją aktualizacji; `new_severity` - `(integer)` powaga zdarzenia po tej akcji aktualizacji; Obsługuje `count`.
selectTags	query	Zwróć właściwość tags z znacznikami problemu. Format wyjścia: `[{"tag": "<tag>", "value": "<value>"}, ...]`.
selectSuppressionData	query	Zwróć właściwość `suppression_data` z listą okresów utrzymania: `maintenanceid` - `(string)` ID okresu utrzymania; `suppress_until` - `(integer)` czas wstrzymania problemu.
sortfield	string/array	Posortuj wynik według podanych właściwości. Możliwe wartości to: `eventid`.
countOutput	boolean	Te parametry, będąc wspólne dla wszystkich metod `get`, są szczegółowo opisane na stronie komentarza referencyjnego.
editable	boolean
excludeSearch	boolean
filter	object
limit	integer
output	query
preservekeys	boolean
search	object
searchByAny	boolean
searchWildcardsEnabled	boolean
sortorder	string/array
startSearch	boolean

Zwracane wartości

(integer/array) Zwraca jedną z opcji:

tablicę obiektów;
liczbę pobranych obiektów, jeśli parametr countOutput został wykorzystany.

Przykłady

Pobieranie zdarzeń problemów wyzwalacza

Pobierz ostatnie zdarzenia z wyzwalacza "15112."

Zapytanie:

{
           "jsonrpc": "2.0",
           "method": "problem.get",
           "params": {
               "output": "extend",
               "selectAcknowledges": "extend",
               "selectTags": "extend",
               "selectSuppressionData": "extend",
               "objectids": "15112",
               "recent": "true",
               "sortfield": ["eventid"],
               "sortorder": "DESC"
           },
           "auth": "67f45d3eb1173338e1b1647c4bdc1916",
           "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",
                   "opdata": "",
                   "acknowledges": [
                       {
                           "acknowledgeid": "14443",
                           "userid": "1",
                           "eventid": "1245463",
                           "clock": "1472457281",
                           "message": "problem solved",
                           "action": "6",
                           "old_severity": "0",
                           "new_severity": "0"
                       }
                   ],
                   "suppression_data": [
                       {
                           "maintenanceid": "15",
                           "suppress_until": "1472511600"
                       }
                   ],
                   "suppressed": "1",
                   "tags": [
                       {
                           "tag": "test tag",
                           "value": "test value"
                       }
                   ]
               }
           ],
           "id": 1
       }

Zobacz także

Źródło

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

Documentation