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 é para recuperar problemas não resolvidos. Também é possível, se especificado, recuperar problemas resolvidos recentemente. O período que determina a idade "recentemente" é definido em AdministraçãoGeral.
Os problemas que foram resolvidos antes desse período não são mantidos na tabela de problemas. Para recuperar problemas que foram resolvidos no passado, use o método event.get.

Esse 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. Consulte Funções de usuário para obter mais informações.

Parâmetros

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

O método oferece suporte aos parâmetros a seguir.

Parâmetro Tipo Descrição
eventids string/array Retornar apenas problemas com os IDs fornecidos.
groupids string/array Retorna apenas problemas criados por objetos que pertencem aos grupos de hosts fornecidos.
hostids string/array Retorna apenas problemas criados por objetos que pertencem aos hosts fornecidos.
objectids string/array Retorna apenas os problemas criados pelos objetos fornecidos.
source integer Retorna apenas problemas com o tipo fornecido.

Consulte a página de objeto de evento de problema para obter uma lista de tipos de eventos compatíveis.

Padrão: 0 - problema criado por uma trigger.
object integer Retorne apenas os problemas criados por objetos de um determinado tipo.

Consulte a página do objeto de evento do problema para obter uma lista de tipos de objetos compatíveis.

Padrão: 0 - trigger.
acknowledged boolean true - retornar somente problemas reconhecidos;
false - somente não reconhecidos.
suppressed boolean true - retorna apenas problemas suprimidos;
false - retorna problemas no estado normal.
severities integer/array Retorne apenas problemas com determinadas gravidades de eventos. Aplica-se apenas se o objeto for trigger.
evaltype integer Regras para pesquisa de tags.

Valores possíveis:
0 - (padrão) And/Or;
2 - Or.
tags array of objects Retorna apenas problemas com as tags fornecidas. Correspondência exata por tag e pesquisa sem distinção entre maiúsculas e minúsculas por valor e operador.
Formato: [{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...].
Um array vazio retorna todos os problemas.

Tipos de operadores possíveis:
0 - (padrão) Like;
1 - Equal;
2 - Not like;
3 - Not equal
4 - Exists;
5 - Not exists.
recent boolean true - Retorna PROBLEM e recentemente RESOLVED problemas (depende dos acionadores de exibição OK por N segundos)
Padrão: false - apenas problemas UNRESOLVED
eventid_from string Retornar apenas problemas com IDs maiores ou iguais ao ID fornecido.
eventid_till string Retornar apenas problemas com IDs menores ou iguais ao ID fornecido.
time_from timestamp Retornar apenas os problemas que foram criados após ou no momento determinado.
time_till timestamp Retornar apenas problemas que foram criados antes ou no momento determinado.
selectAcknowledges query Retorna uma propriedade acknowledges com as atualizações do problema. As atualizações de problemas são classificadas em ordem cronológica inversa.

O objeto de atualização do problema tem as seguintes propriedades:
acknowledgeid - (string) ID da atualização;
userid - (string) ID do usuário que atualizou o evento;
eventid - (string) ID do evento atualizado;
clock - (timestamp) hora 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;

Suporta count.
selectTags query Retorne uma propriedade tags com as tags de problema. Formato de saída: [{"tag": "<tag>", "value": "<value>"}, ...].
selectSuppressionData query Retorna uma propriedade suppression_data com a lista de manutenções:
maintenanceid - (string) ID da manutenção;
suppress_until - (integer) tempo até que o problema seja suprimido.
sortfield string/array Classifique o resultado pelas propriedades fornecidas.

Os valores possíveis são: eventid.
countOutput boolean Esses parâmetros sendo comuns para todos os métodos get são descritos em detalhes na página comentário de referência page.
editable boolean
excludeSearch boolean
filter object
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 problema de trigger

Recupere eventos recentes do trigger "15112".

Request:

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

Response:

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

Veja também

Fonte

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