[comment]: # translation:outdated [comment]: # ({48cd3524-48cd3524}) # problem.get [comment]: # ({/48cd3524-48cd3524}) [comment]: # ({c91e55ea-a18b2713}) ### 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](/manual/web_interface/frontend_sections/administration/general#trigger-displaying-options)*. 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`](/manual/api/reference/event/get). ::: noteimportant Ta metoda może zwracać problemy usuniętej jednostki, jeśli problemy te nie zostały jeszcze usunięte przez housekeeper. ::: ::: noteclassic 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](/manual/web_interface/frontend_sections/users/user_roles). ::: [comment]: # ({/c91e55ea-a18b2713}) [comment]: # ({ec05f91b-98f39c6a}) ### Parametry `(object)` Parametry definiujące żądane dane wyjściowe. Metoda obsługuje następujące parametry. |Parametr|[Typ](/manual/api/reference_commentary#data-types)|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](object#problem).

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](object#problem).

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](/manual/api/reference/event/acknowledge#parameters). 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](/manual/web_interface/frontend_sections/monitoring/problems#using-filter) tagów.

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

Możliwe wartości [operatora](/manual/web_interface/frontend_sections/monitoring/problems#using-filter):
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`](/manual/api/reference/settings/object), 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`](/manual/api/reference/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`](/manual/api/reference/problem/object#problem-tag) z tagami problemu. Format wyjściowy: `[{"tag": "", "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](/manual/api/reference_commentary#data-types).| |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](/manual/api/reference_commentary#common-get-method-parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^| [comment]: # ({/ec05f91b-98f39c6a}) [comment]: # ({7223bab1-7223bab1}) ### Zwracane wartości `(integer/array)` Zwraca: - tablicę obiektów; - liczbę pobranych obiektów, jeśli został użyty parametr `countOutput`. [comment]: # ({/7223bab1-7223bab1}) [comment]: # ({b41637d2-b41637d2}) ### Przykłady [comment]: # ({/b41637d2-b41637d2}) [comment]: # ({9d82627b-4d83529d}) #### Pobieranie zdarzeń problemów wyzwalacza Pobierz ostatnie zdarzenia dla wyzwalacza „15112”. [Żądanie](/manual/api#performing-requests): ```json { "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ź: ```json { "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 } ``` [comment]: # ({/9d82627b-4d83529d}) [comment]: # ({36151502-by}) #### Pobieranie problemów potwierdzonych przez określonego użytkownika Pobieranie problemów potwierdzonych przez użytkownika o ID=10 [Żądanie](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "problem.get", "params": { "output": "extend", "action": 2, "action_userids": [10], "selectAcknowledges": ["userid", "action"], "sortfield": ["eventid"], "sortorder": "DESC" }, "id": 1 } ``` Odpowiedź: ```json { "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 } ``` [comment]: # ({/36151502-by}) [comment]: # ({f5742bff-c6eb3ba0}) ### Zobacz także - [Alert](/manual/api/reference/alert/object) - [Pozycja](/manual/api/reference/item/object) - [Host](/manual/api/reference/host/object) - [Reguła LLD](/manual/api/reference/discoveryrule/object#lld-rule) - [Wyzwalacz](/manual/api/reference/trigger/object) [comment]: # ({/f5742bff-c6eb3ba0}) [comment]: # ({15f9267d-15f9267d}) ### Źródło CEvent::get() w *ui/include/classes/api/services/CProblem.php*. [comment]: # ({/15f9267d-15f9267d})