Sidebar

event.get

Descrição

integer/array event.get(object parameters)

O método permite recuperar eventos de acordo com os parâmetros fornecidos.

::: não importante Este método pode retornar eventos de uma entidade excluída se esses eventos não foram removidos pela governanta ainda. :::

Este método está disponível para usuários de qualquer tipo. Permissões para chamar o método pode ser revogado nas configurações de função do usuário. Veja Usuário funções Para maiores 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|Retorna apenas eventos com os IDs fornecidos.| |groupids|string/array|Retorna apenas eventos criados por objetos que pertencem aos grupos de hosts especificados.| |hostids|string/array|Retorna apenas eventos criados por objetos que pertencem aos hosts fornecidos.| |objectids|string/array|Retorna apenas eventos criados pelos objetos fornecidos.| |source|integer|Retorna apenas eventos com o tipo fornecido.

Consulte a página do objeto do evento para obter uma lista de tipos de eventos suportados.

Padrão: 0 - acionar eventos.| |objeto|inteiro|Retorna apenas eventos criados por objetos de um determinado tipo.

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

Padrão : 0 - gatilho.| |acknowledged|boolean|Se definido como true retorna apenas eventos reconhecidos.| |suppressed|boolean|true - retorna somente eventos suprimidos;
false - retorna eventos no estado normal.| |severities|integer/array|Retorna apenas eventos com as severidades de eventos especificadas. Aplica-se apenas se o objeto for acionador.| |evaltype|integer|Regras para pesquisa de tags.

Valores possíveis:
0 - (padrão) E/Ou;
2 - Ou.| |tags|array de objetos|Retorna apenas eventos 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 eventos.

Possíveis tipos de operadores:
0 - (padrão) Like;
1 - Igual;
2 - Não gosta;
3 - Não é igual
4 - Existe;
5 - Não existe.| |eventid_from|string|Retorna apenas eventos com IDs maiores ou iguais ao ID fornecido.| |eventid_till|string|Retorna apenas eventos com IDs menores ou iguais ao ID fornecido.| |time_from|timestamp|Retorna apenas eventos que foram criados após ou no momento determinado.| |time_till|timestamp|Retorna apenas eventos que foram criados antes ou no momento determinado.| |problem_time_from|timestamp|Retorna apenas eventos que estavam no estado de problema começando com problem_time_from. Aplica-se apenas se a origem for um evento de acionamento e o objeto for um acionador. Obrigatório se problem_time_till for especificado.| |problem_time_till|timestamp|Retorna apenas eventos que estavam no estado de problema até problem_time_till. Aplica-se apenas se a origem for um evento de acionamento e o objeto for um acionador. Obrigatório se problem_time_from for especificado.| |valor|inteiro/array|Retorna apenas eventos com os valores fornecidos.| |selectHosts|query|Retorne uma propriedade hosts com hosts contendo o objeto que criou o evento. Com suporte apenas para eventos gerados por gatilhos, itens ou regras LLD.| |selectRelatedObject|query|Retorna uma propriedade relatedObject com o objeto que criou o evento. O tipo de objeto retornado depende do tipo de evento.| |select_alerts|query|Retorna uma propriedade alerts com alertas gerados pelo evento. Os alertas são classificados em ordem cronológica inversa.| |select_acknowledges|query|Retorna uma propriedade acknowledges com atualizações de eventos. As atualizações de eventos são classificadas em ordem cronológica inversa.

O objeto de atualização de evento tem as seguintes propriedades:
acknowledgeid - ID da confirmação de (string);
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 - texto (string) da mensagem;
action - (integer) ação de atualização que foi executada veja event.acknowledge;
old_severity - gravidade do evento (integer) antes desta ação de atualização;
new_severity - gravidade do evento (integer) após esta ação de atualização;
username - (string) nome de usuário do usuário que atualizou o evento;
name - (string) nome do usuário que atualizou o evento;
surname - (string) sobrenome do usuário que atualizou o evento .

Suporta contagem.| |selectTags|query|Retorne uma propriedade tags com tags de evento.| |selectSuppressionData|query|Retorna uma propriedade suppression_data com a lista de manutenções:
maintenanceid - (string) ID da manutenção;
suppress_until - (integer) tempo até o evento é suprimido.| |sortfield|string/array|Ordenar o resultado pelas propriedades fornecidas.

Os valores possíveis são: eventid, objectid e clock.| |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.| |editável|booleano|^| |excludePesquisa|boolean|^| |filtro|objeto|^| |limite|inteiro|^| |saída|consulta|^| |preservekeys|boolean|^| |pesquisar|objeto|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |ordem de classificação|cadeia/matriz|^| |startSearch|boolean|^|

Valores de retorno

(integer/array) Retorna:

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

Exemplos

Recuperando eventos de gatilho

Recupere os eventos mais recentes do gatilho "13926".

Solicitação:

{
           "jsonrpc": "2.0",
           "método": "evento.get",
           "parâmetros": {
               "saída": "estender",
               "select_acknowledges": "estender",
               "selectTags": "estender",
               "selectSuppressionData": "estender",
               "objectids": "13926",
               "sortfield": ["relógio", "id do evento"],
               "ordem de classificação": "DESC"
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Resposta:

{
           "jsonrpc": "2.0",
           "resultado": [
               {
                   "eventid": "9695",
                   "fonte": "0",
                   "objeto": "0",
                   "objeto": "13926",
                   "relógio": "1347970410",
                   "valor": "1",
                   "reconhecido": "1",
                   "ns": "413316245",
                   "name": "MySQL está inativo",
                   "gravidade": "5",
                   "r_eventid": "0",
                   "c_eventid": "0",
                   "correlationid": "0",
                   "userid": "0",
                   "opdata": "",
                   "reconhece": [
                       {
                           "reconhecimento": "1",
                           "userid": "1",
                           "eventid": "9695",
                           "relógio": "1350640590",
                           "message": "Problema resolvido.\n\r----[BULK ACKNOWLEDGE]----",
                           "ação": "6",
                           "old_severity": "0",
                           "new_severity": "0",
                           "username": "Admin",
                           "nome": "Zabbix",
                           "sobrenome": "Administrador"
                       }
                   ],
                   "suppression_data": [
                       {
                           "manutenção": "15",
                           "suppress_until": "1472511600"
                       }
                   ],
                   "suprimido": "1",
                   "Tag": [
                       {
                           "tag": "serviço",
                           "valor": "mysqld"
                       },
                       {
                           "tag": "erro",
                           "valor": ""
                       }
                   ]
               },
               {
                   "evento": "9671",
                   "fonte": "0",
                   "objeto": "0",
                   "objeto": "13926",
                   "relógio": "1347970347",
                   "valor": "0",
                   "reconhecido": "0",
                   "ns": "0",
                   "name": "Indisponível por ping ICMP",
                   "gravidade": "4",
                   "r_eventid": "0",
                   "c_eventid": "0",
                   "correlationid": "0",
                   "userid": "0",
                   "opdata": "",
                   "reconhece": [],
                   "suppression_data": [],
                   "suprimido": "0",
                   "Tag": []
               }
           ],
           "id": 1
       }

Recuperando eventos por período de tempo

Recupere todos os eventos que foram criados entre 9 e 10 de outubro, 2012, em ordem cronológica inversa.

Solicitação:

{
           "jsonrpc": "2.0",
           "método": "evento.get",
           "parâmetros": {
               "saída": "estender",
               "time_from": "1349797228",
               "time_till": "1350661228",
               "sortfield": ["relógio", "id do evento"],
               "sortorder": "desc"
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Resposta:

{
           "jsonrpc": "2.0",
           "resultado": [
               {
                   "eventid": "20616",
                   "fonte": "0",
                   "objeto": "0",
                   "objeto": "14282",
                   "relógio": "1350477814",
                   "valor": "1",
                   "reconhecido": "0",
                   "ns": "0",
                   "name": "Menos de 25% livre no cache do histórico",
                   "gravidade": "3",
                   "r_eventid": "0",
                   "c_eventid": "0",
                   "correlationid": "0",
                   "userid": "0",
                   "opdata": "",
                   "suprimido": "0"
               },
               {
                   "eventid": "20617",
                   "fonte": "0",
                   "objeto": "0",
                   "objeto": "14283",
                   "relógio": "1350477814",
                   "valor": "0",
                   "reconhecido": "0",
                   "ns": "0",
                   "name": "O Zabbix Trapper processa mais de 75% ocupado",
                   "gravidade": "3",
                   "r_eventid": "0",
                   "c_eventid": "0",
                   "correlationid": "0",
                   "userid": "0",
                   "opdata": "",
                   "suprimido": "0"
               },
               {
                   "eventid": "20618",
                   "fonte": "0",
                   "objeto": "0",
                   "objeto": "14284",
                   "relógio": "1350477815",
                   "valor": "1",
                   "reconhecido": "0",
                   "ns": "0",
                   "name": "Alta perda de ping ICMP",
                   "gravidade": "3",
                   "r_eventid": "0",
                   "c_eventid": "0",
                   "correlationid": "0",
                   "userid": "0",
                   "opdata": "",
                   "suprimido": "0"
               }
           ],
           "id": 1
       }

Veja também

Fonte

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