Table of Contents
1 Configurando um trigger
Visão geral
Para configurar um trigger, faça o seguinte:
- Vá para: Coleta de dados → Hosts
- Clique em Triggers na linha do host
- Clique em Criar trigger à direita (ou no nome do trigger para editar um trigger existente)
- Insira os parâmetros do trigger no formulário
Veja também informações gerais sobre triggers e seus tempos de cálculo.
Configuração
A aba Trigger contém todos os atributos essenciais do trigger.
Todos os campos obrigatórios estão marcados com um asterisco vermelho.
| Parâmetro | Descrição |
|---|---|
| Nome | Nome do trigger. As macros suportadas são: {HOST.HOST}, {HOST.NAME}, {HOST.PORT}, {HOST.CONN}, {HOST.DNS}, {HOST.IP}, {HOST.PORT}, {ITEM.VALUE}, {ITEM.VALUE.AGE}, {ITEM.VALUE.DATE}, {ITEM.VALUE.TIME}, {ITEM.VALUE.TIMESTAMP}, {ITEM.LASTVALUE}, {ITEM.LASTVALUE.AGE}, {ITEM.LASTVALUE.DATE}, {ITEM.LASTVALUE.TIME}, {ITEM.LASTVALUE.TIMESTAMP}, {ITEM.LOG.*} e macros de usuário {$MACRO}. As macros $1, $2...$9 podem ser usadas para se referir à primeira, segunda...nona constante da expressão. Nota: as macros $1-$9 serão resolvidas corretamente se referenciando constantes em expressões relativamente simples e diretas. Por exemplo, o nome "Carga do processador acima de $1 em {HOST.NAME}" mudará automaticamente para "Carga do processador acima de 5 em Novo host" se a expressão for last(/Novo host/system.cpu.load[percpu,avg1])>5 |
| Nome do evento | Se definido, este nome será usado para criar o nome do evento de problema, em vez do nome do trigger. O nome do evento pode ser usado para construir alertas significativos contendo dados do problema (veja exemplo). O mesmo conjunto de macros é suportado como no nome do trigger, além das macros de expressão {TIME}, {TIMESTAMP} e {?EXPRESSION}. |
| Dados operacionais | Os dados operacionais permitem definir strings arbitrárias junto com macros. As macros serão resolvidas dinamicamente para dados em tempo real em Monitoramento → Problemas. Enquanto as macros no nome do trigger (veja acima) serão resolvidas para seus valores no momento em que um problema ocorre e se tornarão a base de um nome de problema estático, as macros nos dados operacionais mantêm a capacidade de exibir as informações mais recentes dinamicamente. Se nenhum dado operacional for configurado no nível do trigger, os valores mais recentes de todos os items da expressão serão exibidos. O mesmo conjunto de macros é suportado como no nome do trigger. |
| Severidade | Defina a severidade do trigger clicando nos botões. |
| Expressão | Expressão lógica usada para definir as condições de um problema. Sufixos de tempo e sufixos de tamanho de memória são suportados. Um problema é criado após todas as condições incluídas na expressão serem atendidas, ou seja, a expressão é avaliada como VERDADEIRA. O problema será resolvido assim que a expressão for avaliada como FALSA, a menos que condições adicionais de recuperação sejam especificadas em Expressão de recuperação. |
| Geração de evento OK | Opções de geração de evento OK: Expressão - eventos OK são gerados com base na mesma expressão que os eventos de problema; Expressão de recuperação - eventos OK são gerados se a expressão de problema for avaliada como FALSA e a expressão de recuperação for avaliada como VERDADEIRA; Nenhuma - neste caso, o trigger nunca retornará ao estado OK por conta própria. |
| Expressão de recuperação | Expressão lógica (opcional) definindo condições adicionais que devem ser atendidas antes que o problema seja resolvido, depois que a expressão de problema original já tenha sido avaliada como FALSA. A expressão de recuperação é útil para histerese de trigger. Não é possível resolver um problema apenas pela expressão de recuperação se a expressão de problema ainda for VERDADEIRA. Este campo só está disponível se 'Expressão de recuperação' for selecionada para Geração de evento OK. |
| Modo de geração de evento PROBLEM | Modo para gerar eventos de problema: Único - um único evento é gerado quando um trigger entra no estado 'Problema' pela primeira vez; Múltiplo - um evento é gerado a cada avaliação 'Problema' do trigger. |
| Evento OK fecha | Selecione se o evento OK fecha: Todos os problemas - todos os problemas deste trigger Todos os problemas se os valores das tags coincidirem - apenas aqueles problemas do trigger com valores de tag de evento correspondentes |
| Tag para correspondência | Digite o nome da tag de evento a ser usada para correlação de eventos. Este campo é exibido se 'Todos os problemas se os valores das tags coincidirem' for selecionado para a propriedade Evento OK fecha e é obrigatório neste caso. |
| Permitir fechamento manual | Marque para permitir o fechamento manual de eventos de problema gerados por este trigger. O fechamento manual é possível ao reconhecer eventos de problema. |
| Nome da entrada do menu | Se não estiver vazio, o nome inserido aqui (até 64 caracteres) é usado em vários locais do frontend como um rótulo para a URL do trigger especificada no parâmetro URL da entrada do menu. Se vazio, o nome padrão Trigger URL é usado. O mesmo conjunto de macros é suportado como na URL do trigger. |
| URL da entrada do menu | Se não estiver vazio, a URL inserida aqui (até 2048 caracteres) estará disponível como um link no menu de eventos em vários locais do frontend, por exemplo, ao clicar no nome do problema em Monitoramento → Problemas ou no widget de painel Problemas. O mesmo conjunto de macros é suportado como no nome do trigger, além de {EVENT.ID}, {HOST.ID} e {TRIGGER.ID}. Nota: macros de usuário com valores secretos não serão resolvidas na URL. |
| Descrição | Campo de texto usado para fornecer mais informações sobre este trigger. Pode conter instruções para corrigir um problema específico, detalhes de contato do responsável, etc. O mesmo conjunto de macros é suportado como no nome do trigger. |
| Habilitado | Desmarcar esta caixa desabilitará o trigger, se necessário. Problemas de um trigger desabilitado não são mais exibidos no frontend, mas não são excluídos. |
A aba Tags permite definir tags no nível do trigger. Todos os problemas deste trigger serão marcados com os valores inseridos aqui.
Além disso, a opção Tags herdadas e do trigger permite visualizar tags definidas no nível do template, se o trigger vier desse template. Se houver vários templates com a mesma tag, essas tags são exibidas uma vez e os nomes dos templates são separados por vírgulas. Um trigger não "herda" e exibe tags do nível do host.
| Parâmetro | Descrição |
|---|---|
| Nome/Valor | Defina tags personalizadas para marcar eventos do trigger. As tags são um par de nome e valor. Você pode usar apenas o nome ou emparelhá-lo com um valor. Um trigger pode ter várias tags com o mesmo nome, mas valores diferentes. Macros de usuário, macros de usuário com contexto, macros de descoberta de baixo nível e funções de macro com {{ITEM.VALUE}}, {{ITEM.LASTVALUE}} e macros de descoberta de baixo nível são suportadas em tags de evento. Macros de descoberta de baixo nível podem ser usadas dentro do contexto da macro.A macro {TRIGGER.ID} é suportada nos valores das tags do trigger. Pode ser útil para identificar triggers criados a partir de protótipos de trigger e, por exemplo, suprimir problemas desses triggers durante a manutenção. Se o comprimento total do valor expandido exceder 255, ele será cortado para 255 caracteres. Veja todas as macros suportadas para tags de evento. Tags de evento podem ser usadas para correlação de eventos, em condições de ação e também serão vistas em Monitoramento → Problemas ou no widget Problemas. |
A aba Dependências contém todas as dependências do trigger.
Clique em Adicionar para adicionar uma nova dependência.
Você também pode configurar um trigger abrindo um existente, pressionando o botão Clonar e depois salvando com um nome diferente.
Testando expressões
É possível testar a expressão de trigger configurada para verificar qual seria o resultado da expressão dependendo do valor recebido.
A seguinte expressão de um template oficial é usada como exemplo:
avg(/Cisco IOS SNMPv2/sensor.temp.value[ciscoEnvMonTemperatureValue.{#SNMPINDEX}],5m)>{$TEMP_WARN}
or
last(/Cisco IOS SNMPv2/sensor.temp.status[ciscoEnvMonTemperatureState.{#SNMPINDEX}])={$TEMP_WARN_STATUS}Para testar a expressão, clique em Construtor de expressão abaixo do campo de expressão.
No Construtor de expressão, todas as expressões individuais são listadas. Para abrir a janela de teste, clique em Testar abaixo da lista de expressões.
Na janela de teste, você pode inserir valores de exemplo ('80', '70', '0', '1' neste exemplo) e então ver o resultado da expressão, clicando no botão Testar.
O resultado das expressões individuais, bem como da expressão completa, pode ser visualizado.
"TRUE" significa que a expressão especificada está correta. Neste caso particular A, "80" é maior que o valor especificado em {$TEMP_WARN}, "70" neste exemplo. Como esperado, um resultado "TRUE" aparece.
"FALSE" significa que a expressão especificada está incorreta. Neste caso particular B, {$TEMP_WARN_STATUS} "1" precisa ser igual ao valor especificado, "0" neste exemplo. Como esperado, um resultado "FALSE" aparece.
O tipo de expressão escolhido é "OR". Se pelo menos uma das condições especificadas (A ou B neste caso) for TRUE, o resultado geral também será TRUE. Isso significa que o valor atual excede o valor de aviso e um problema ocorreu.