event.acknowledge

Descrição

object event.acknowledge(object/array parameters)

Este método permite atualizar eventos. As seguintes ações de atualização podem ser realizadas:

  • Fechar evento. Se o evento já estiver resolvido, esta ação será ignorada.
  • Reconhecer evento. Se o evento já estiver reconhecido, esta ação será ignorada.
  • Remover reconhecimento do evento. Se o evento não estiver reconhecido, esta ação será ignorada.
  • Adicionar mensagem.
  • Alterar a severidade do evento. Se o evento já tiver a mesma severidade, esta ação será ignorada.
  • Suprimir evento. Se o evento já estiver suprimido, esta ação será ignorada.
  • Remover supressão do evento. Se o evento não estiver suprimido, esta ação será ignorada.
  • Alterar o ranking do evento para causa. Se o evento já estiver classificado como causa, esta ação será ignorada.
  • Alterar o ranking do evento para sintoma. Se o evento já estiver classificado como sintoma, esta ação será ignorada.

Apenas eventos de trigger podem ser atualizados.
Apenas eventos de problema podem ser atualizados.
Permissões de leitura/gravação para trigger são necessárias para fechar o evento ou alterar a severidade do evento.
Para fechar um evento, o fechamento manual deve ser permitido no trigger.

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/array) Parâmetros contendo os IDs dos eventos e as operações de atualização que devem ser realizadas.

Parâmetro Tipo Descrição
eventids ID/array IDs dos eventos a serem reconhecidos.

Comportamento do parâmetro:
- obrigatório
action integer Ação(ões) de atualização do evento.

Valores possíveis do bitmap:
1 - fechar problema;
2 - reconhecer evento;
4 - adicionar mensagem;
8 - alterar severidade;
16 - desmarcar reconhecimento do evento;
32 - suprimir evento;
64 - remover supressão do evento;
128 - alterar classificação do evento para causa;
256 - alterar classificação do evento para sintoma.

Este é um campo de máscara de bits; qualquer soma dos valores possíveis é aceitável (por exemplo, 34 para reconhecer e suprimir evento).

Comportamento do parâmetro:
- obrigatório
cause_eventid ID ID do evento causa.

Comportamento do parâmetro:
- obrigatório se action contiver o bit "alterar classificação do evento para sintoma"
message string Texto da mensagem.

Comportamento do parâmetro:
- obrigatório se action contiver o bit "adicionar mensagem"
severity integer Nova severidade para os eventos.

Valores possíveis:
0 - não classificado;
1 - informação;
2 - aviso;
3 - médio;
4 - alto;
5 - desastre.

Comportamento do parâmetro:
- obrigatório se action contiver o bit "alterar severidade"
suppress_until integer Timestamp Unix até o qual o evento deve ser suprimido.

Se definido como "0", a supressão será indefinida.

Comportamento do parâmetro:
- obrigatório se action contiver o bit "suprimir evento"

Valores de retorno

(object) Retorna um objeto contendo os IDs dos eventos atualizados na propriedade eventids.

Exemplos

Reconhecendo um evento

Reconheça um único evento e deixe uma mensagem.

Requisição:

{
    "jsonrpc": "2.0",
    "method": "event.acknowledge",
    "params": {
        "eventids": "20427",
        "action": 6,
        "message": "Problem resolved."
    },
    "id": 1
}

Resposta:

{
    "jsonrpc": "2.0",
    "result": {
        "eventids": [
            "20427"
        ]
    },
    "id": 1
}

Alterando a gravidade do evento

Altere a gravidade de vários eventos e deixe uma mensagem.

Requisição:

{
    "jsonrpc": "2.0",
    "method": "event.acknowledge",
    "params": {
        "eventids": ["20427", "20428"],
        "action": 12,
        "message": "Manutenção necessária para corrigir.",
        "severity": 4
    },
    "id": 1
}

Resposta:

{
    "jsonrpc": "2.0",
    "result": {
        "eventids": [
            "20427",
            "20428"
        ]
    },
    "id": 1
}

Fonte

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