problem.get

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. 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.

Este método pode retornar problemas de uma entidade excluída se esses problemas ainda não tiverem sido removidos pelo housekeeper.

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 para mais informações.

Parâmetros

(object) Parâmetros que definem a saída desejada.

O método suporta os seguintes parâmetros.

Parâmetro	Tipo	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 para uma lista de 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 para uma lista de tipos de objeto suportados. Padrão: 0 - trigger.
acknowledged	boolean	`true` - retorna apenas problemas reconhecidos; `false` - apenas não reconhecidos.
action	integer	Retorna apenas problemas para os quais as ações de atualização de evento fornecidas foram executadas. Para múltiplas 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 de usuários que executaram as ações de atualização de evento de problema.
suppressed	boolean	`true` - retorna apenas problemas suprimidos; `false` - retorna problemas no estado normal.
symptom	boolean	`true` - retorna apenas eventos de problema do tipo sintoma; `false` - retorna apenas eventos de problema do tipo causa.
severities	integer/array	Retorna apenas problemas com as gravidades de evento fornecidas. Aplica-se apenas se o objeto for trigger.
evaltype	integer	Método de avaliação de tag. Valores possíveis: 0 - (padrão) E/Ou; 2 - Ou.
tags	array	Retorna apenas problemas com as tags fornecidas. Formato: `[{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...]`. Um array vazio retorna todos os problemas. Valores possíveis para operator: 0 - (padrão) Contém; 1 - Igual; 2 - Não contém; 3 - Não é igual; 4 - Existe; 5 - Não existe.
recent	boolean	`true` - retorna problemas em PROBLEMA e problemas recentemente RESOLVIDOS (depende de Exibir triggers OK por N segundos) Padrão: `false` - 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 reversa. O objeto de atualização do problema possui 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 de ação de atualização (veja `event.acknowledge`); `old_severity` - `(integer)` gravidade do evento antes desta ação de atualização; `new_severity` - `(integer)` gravidade do evento após esta ação de atualização; `suppress_until` - `(timestamp)` horário até o qual o evento será 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` com as tags do problema. Formato de saída: `[{"tag": "<tag>", "value": "<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 está suprimido.
filter	object	Retorna apenas os resultados que correspondem exatamente ao filtro fornecido. Aceita um objeto, onde as chaves são nomes de propriedades e os valores são um único valor ou um array de valores para comparar. Não suporta propriedades do tipo de dado `text` data type.
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.
editable	boolean
excludeSearch	boolean
limit	integer
output	query
preservekeys	boolean
search	object
searchByAny	boolean
searchWildcardsEnabled	boolean
sortorder	string/array
startSearch	boolean

Valores de retorno

(integer/array) Retorna:

uma matriz de objetos;
a contagem de objetos recuperados, se o parâmetro countOutput foi usado.

Exemplos

Recuperando eventos de problemas de trigger

Recupere eventos recentes do trigger "15112".

Requisição:

{
           "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:

{
           "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
       }

Recuperando problemas reconhecidos por um usuário específico

Recuperando problemas reconhecidos pelo usuário com ID=10