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 que é considerado "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 eventos 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 objetos 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 realizadas. Para múltiplas ações, use uma 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 dos usuários que realizaram as ações de atualização de evento de problema.
suppressed	boolean	`true` - retorna apenas problemas suprimidos; `false` - retorna problemas em 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 severidades de evento fornecidas. Aplica-se apenas se o objeto for trigger.
evaltype	integer	Regras para busca por tag. Valores possíveis: 0 - (padrão) And/Or; 2 - Or.
tags	array	Retorna apenas problemas com as tags fornecidas. Correspondência exata por tag e busca sensível ou não a maiúsculas/minúsculas pelo valor da tag, dependendo do valor do operador. Formato: `[{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...]`. Um array vazio retorna todos os problemas. Tipos de operador possíveis: 0 - (padrão) Contém (correspondência de substring, não sensível a maiúsculas/minúsculas); 1 - Igual (sensível a maiúsculas/minúsculas); 2 - Não contém (correspondência de substring, não sensível a maiúsculas/minúsculas); 3 - Diferente (sensível a maiúsculas/minúsculas); 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)` 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 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 correspondência. 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	Esses 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:

um array de objetos;
a contagem de objetos recuperados, se o parâmetro countOutput foi utilizado.

Exemplos

Recuperando eventos de problemas do 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 especificado

Recuperando problemas reconhecidos pelo usuário com ID=10