Table of Contents
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
countOutputfoi 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": "Áú»¢¶Ä²© 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.