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ção → Geral.
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.

Documentation