[comment]: # ({48cd3524-48cd3524}) # problem.get [comment]: # ({/48cd3524-48cd3524}) [comment]: # ({c91e55ea-a18b2713}) ### Descrição `integer/array problem.get(object parameters)` O método permite recuperar problemas de acordo com os parâmetros fornecidos. Este método serve para recuperar problemas não resolvidos. Também é possível, se especificado, recuperar adicionalmente problemas recentemente resolvidos. O período que determina o quão antigo é "recentemente" é definido em *Administração* → *[Geral](/manual/web_interface/frontend_sections/administration/general#trigger-displaying-options)*. Problemas que foram resolvidos antes desse período não são mantidos na tabela de problemas. Para recuperar problemas que foram resolvidos há mais tempo, use o método [`event.get`](/manual/api/reference/event/get). ::: noteimportant Este método pode retornar problemas de uma entidade excluída se esses problemas ainda não tiverem sido removidos pelo housekeeper. ::: ::: noteclassic Este método está disponível para usuários de qualquer tipo. As permissões para chamar o método podem ser revogadas nas configurações de função do usuário. Veja [Funções de usuário](/manual/web_interface/frontend_sections/users/user_roles) para mais informações. ::: [comment]: # ({/c91e55ea-a18b2713}) [comment]: # ({ec05f91b-98f39c6a}) ### Parâmetros `(object)` Parâmetros que definem a saída desejada. O método oferece suporte aos seguintes parâmetros. |Parâmetro|[Tipo](/manual/api/reference_commentary#data-types)|Descrição| |--|--|------| |eventids|ID/array|Retorna apenas problemas com os IDs fornecidos.| |groupids|ID/array|Retorna apenas problemas criados por objetos que pertencem aos grupos de hosts fornecidos.| |hostids|ID/array|Retorna apenas problemas criados por objetos que pertencem aos hosts fornecidos.| |objectids|ID/array|Retorna apenas problemas criados pelos objetos fornecidos.| |source|integer|Retorna apenas problemas com o tipo fornecido.

Consulte a [página do objeto de evento de problema](object#problem) para obter uma lista dos tipos de evento suportados.

Padrão: 0 - problema criado por um trigger.| |object|integer|Retorna apenas problemas criados por objetos do tipo fornecido.

Consulte a [página do objeto de evento de problema](object#problem) para obter uma lista dos tipos de objeto suportados.

Padrão: 0 - trigger.| |acknowledged|boolean|Se definido como `true`, retorna apenas problemas reconhecidos.| |action|integer|Retorna apenas problemas para os quais as [ações de atualização de evento](/manual/api/reference/event/acknowledge#parameters) fornecidas foram executadas. Para várias ações, use a soma de quaisquer valores de bitmap aceitáveis como máscara de bits (por exemplo, 34 para reconhecer e suprimir evento).| |action_userids|ID/array|Retorna apenas problemas com os IDs fornecidos dos usuários que executaram as ações de atualização do evento de problema.| |suppressed|boolean|Se definido como `true`, retorna apenas problemas suprimidos.| |symptom|boolean|Se definido como `true`, retorna apenas eventos de problema do tipo sintoma.| |severities|integer/array|Retorna apenas problemas com as severidades de evento fornecidas. Aplica-se somente se o objeto for trigger.| |evaltype|integer|Método de [avaliação](/manual/web_interface/frontend_sections/monitoring/problems#using-filter) de tags.

Valores possíveis:
0 - *(padrão)* And/Or;
2 - Or.| |tags|array|Retorna apenas problemas com as tags fornecidas.
Formato: `[{"tag": "", "value": "", "operator": ""}, ...]`.
Um array vazio retorna todos os problemas.

Valores possíveis de [operator](/manual/web_interface/frontend_sections/monitoring/problems#using-filter):
0 - *(padrão)* Contém;
1 - Igual;
2 - Não contém;
3 - Diferente de;
4 - Existe;
5 - Não existe.| |recent|boolean|Se definido como `true`, retorna problemas recentes, incluindo aqueles resolvidos dentro de [`ok_period`](/manual/api/reference/settings/object) e quaisquer problemas não resolvidos.
Se definido como `false`, retorna apenas problemas não resolvidos.| |eventid\_from|string|Retorna apenas problemas com IDs maiores ou iguais ao ID fornecido.| |eventid\_till|string|Retorna apenas problemas com IDs menores ou iguais ao ID fornecido.| |time\_from|timestamp|Retorna apenas problemas que foram criados após ou no horário fornecido.| |time\_till|timestamp|Retorna apenas problemas que foram criados antes ou no horário fornecido.| |selectAcknowledges|query|Retorna uma propriedade `acknowledges` com as atualizações do problema. As atualizações do problema são classificadas em ordem cronológica inversa.

O objeto de atualização do problema tem as seguintes propriedades:
`acknowledgeid` - `(ID)` ID da atualização;
`userid` - `(ID)` ID do usuário que atualizou o evento;
`eventid` - `(ID)` ID do evento atualizado;
`clock` - `(timestamp)` horário em que o evento foi atualizado;
`message` - `(string)` texto da mensagem;
`action` - `(integer)` tipo da ação de atualização (consulte [`event.acknowledge`](/manual/api/reference/event/acknowledge));
`old_severity` - `(integer)` severidade do evento antes desta ação de atualização;
`new_severity` - `(integer)` severidade do evento após esta ação de atualização;
`suppress_until` - `(timestamp)` horário até o qual o evento ficará suprimido;
`taskid` - `(ID)` ID da tarefa se o evento atual estiver passando por uma alteração de classificação.

Suporta `count`.| |selectTags|query|Retorna uma propriedade [`tags`](/manual/api/reference/problem/object#problem-tag) com as tags do problema. Formato de saída: `[{"tag": "", "value": ""}, ...]`.| |selectSuppressionData|query|Retorna uma propriedade `suppression_data` com a lista de manutenções ativas e supressões manuais:
`maintenanceid` - `(ID)` ID da manutenção;
`userid` - `(ID)` ID do usuário que suprimiu o problema;
`suppress_until` - `(integer)` horário até o qual o problema ficará suprimido.| |filter|object|Retorna apenas os resultados que correspondem exatamente ao filtro fornecido.

Aceita um objeto, em que as chaves são nomes de propriedades e os valores são um único valor ou um array de valores para correspondência.

Não oferece suporte a propriedades do tipo de dado `text` [data type](/manual/api/reference_commentary#data-types).| |sortfield|string/array|Classifica o resultado pelas propriedades fornecidas.

Valores possíveis: `eventid`.| |countOutput|boolean|Estes parâmetros são descritos no [comentário de referência](/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}) ### Valores de retorno `(integer/array)` Retorna: - um array de objetos; - a contagem de objetos recuperados, se o parâmetro `countOutput` foi utilizado. [comment]: # ({/7223bab1-7223bab1}) [comment]: # ({b41637d2-b41637d2}) ### Exemplos [comment]: # ({/b41637d2-b41637d2}) [comment]: # ({9d82627b-4d83529d}) #### Recuperando eventos de problemas do trigger Recupere eventos recentes do trigger "15112". [Requisição](/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 } ``` Resposta: ```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": "Zabbix agent on localhost is unreachable for 5 minutes", "acknowledged": "1", "severity": "3", "cause_eventid": "0", "opdata": "", "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" } ], "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}) #### Recuperando problemas reconhecidos por um usuário especificado Recuperando problemas reconhecidos pelo usuário com ID=10 [Requisição](/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 } ``` Resposta: ```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": "Zabbix agent on localhost is unreachable for 5 minutes", "acknowledged": "1", "severity": "3", "cause_eventid": "0", "opdata": "", "acknowledges": [ { "userid": "10", "action": "2" } ], "suppressed": "0" } ], "id": 1 } ``` [comment]: # ({/36151502-by}) [comment]: # ({f5742bff-c6eb3ba0}) ### Veja também - [Alerta](/manual/api/reference/alert/object) - [Item](/manual/api/reference/item/object) - [Host](/manual/api/reference/host/object) - [Regra LLD](/manual/api/reference/discoveryrule/object#lld-rule) - [Trigger](/manual/api/reference/trigger/object) [comment]: # ({/f5742bff-c6eb3ba0}) [comment]: # ({15f9267d-15f9267d}) ### Fonte CEvent::get() em *ui/include/classes/api/services/CProblem.php*. [comment]: # ({/15f9267d-15f9267d})