Documentation
Table of Contents
1 Configurando um gatilho
Visão geral
Para configurar um gatilho, faça o seguinte:
- Vá até: Configuração → Hosts
- Clique em Gatilhos na linha do host
- Clique em Criar gatilho à direita (ou no nome do gatilho para editar um gatilho existente)
- Informe os parâmetros do gatilho no formulário
Consulte também informações gerais sobre gatilhos e seus cálculos de tempo.
Configuração
A aba Gatilho contém todos os atributos essenciais de um gatilho.
Todos os campos obrigatórios estão marcados com um asterisco vermelho.
| Parâmetro | Descrição |
|---|---|
| Nome | Nome do gatilho. Macros suportadas são: {HOST.HOST}, {HOST.NAME}, {HOST.PORT}, {HOST.CONN}, {HOST.DNS}, {HOST.IP}, {ITEM.VALUE}, {ITEM.LASTVALUE}, {ITEM.LOG.*} e macros de usuário {$MACRO}. Macros $1, $2...$9 podem ser usadas para se referir à primeira, segunda...nona constante da expressão. Nota: macros $1-$9 resolverão corretamente se referenciando constantes em expressões relativamente simples e diretas. Por exemplo, o nome "Carga processador acima de $1 em {HOST.NAME}" será automaticamente alterada para "Carga processador acima de 5 em New host" se a expressão é last(/New host/system.cpu.load[percpu,avg1])>5 |
| Nome do evento | Se definido, este nome será usado para criar o nome do evento problema, em vez do nome do gatilho. O nome do evento pode ser usado para construir alertas significantes contendo dados do problema (consulte exemplo). O mesmo conjunto de macros é suportado como no nome do gatilho, mais as macros de expressão {TIME} e {?EXPRESSION}. Suportado desde o Zabbix 5.2.0. |
| Dados operacionais | Dados operacionais permitem definir strings arbitrárias em conjunto com as macros. As macros resolverão dinamicamente para dados em tempo real em Monitoramento → Problemas. Enquanto macros no nome do gatilho (veja acima) resolverá aos seus valores no momento de ocorrência de um problema e se tornará a base de um nome de problema estático, as macros nos dados operacionais mantêm a habilidade de apresentar a informação mais recente dinamicamente. O mesmo conjunto de macros é suportado como no nome do gatilho. |
| Severidade | Configure a severidade requerida para o gatilho clicando nos botões. |
| Expressão | Expressão lógica usada para definir as condições de um problema. Um problema é criado depois que todas as condições inclusas na expressão são atendidas, p.e. a expressão avalia para VERDADEIRO (TRUE). O problema será resolvido tão logo a expressão avalie para FALSO (FALSE), a menos que condições de recuperação adicionais sejam especificadas na 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 baseados 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 avaliar para FALSO e a expressão de recuperação avaliar para VERDADEIRO; Nenhum - neste caso o gatilho nunca retornará para um evento OK por conta própria. |
| Expressão de recuperação | Expressão lógica (opcional) definindo condições adicionais que devem ser atendidas antes do problema ser resolvido, depois que a expressão de problema original já tenha sido avaliada para FALSO. A expressão de recuperação é útil para histerese de gatilho. Não é possível resolver um problema através de uma 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' estiver selecionada para Geração de evento OK. |
| Modo de geração de evento PROBLEMA | Modo para geração de eventos de problema: Único - um evento único é gerado quando um gatilho entra em estado de 'Problema' pela primeira vez; Múltiplo - um evento é gerado a cada avaliação de 'Problema' no gatilho. |
| Fechamento por evento OK | Selecione se o evento OK fecha: Todos os problemas - todos os problemas deste gatilho Todos os problemas se valores de etiqueta corresponderem - apenas aqueles problemas do gatilho com valores de etiqueta de evento correspondentes |
| Etiqueta para correspondência | Informe o nome da etiqueta de evento para usar na correlação de evento. Este campo é apresentado se 'Todos os problemas se valores de etiqueta corresponderem' estiver selecionado para a propriedade Fechamento por evento OK e é obrigatório neste caso. |
| Permitir fechamento manual | Selecione para permitir fechamento manual de eventos de problema gerados por este gatilho. Fechamento manual é possível quando reconhecendo eventos de problema. |
| URL | Se não estiver vazio, a URL informada aqui está disponível como um link em vários locais do Frontend, p.e. quando clicando no nome do problema em Monitoramento → Problemas (opção URL no menu do Gatilho) e widget de dashboard Problemas. O mesmo conjunto de macros é suportado assim como no nome do gatilho, mais {EVENT.ID}, {HOST.ID} e {TRIGGER.ID}. Note que 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 sobres este gatilho. Pode conter instruções para correção de problemas específicos, detalhes de contato do pessoal responsável, etc. O mesmo conjunto de macros é suportado assim como no nome do gatilho. |
| Habilitado | Desmarcar esta caixa desabilitará o gatilho se necessário. Problemas de um gatilho desabilitado não são mais apresentados no Frontend, mas não são excluídas. |
A aba de Etiquetas permite definir etiquetas de nível de gatilho. Todos os problemas deste gatilho serão etiquetados com os valores informados aqui.
Em adição a opção Etiquetas herdadas e de gatilho permite visualizar etiquetas definidas no nível de template, se o gatilho vem daquele template. Se houver múltiplos templates com a mesma etiqueta, estas etiquetas são apresentadas uma vez e os nomes de template são separados com vírgulas. Um gatilho não "herda" e não apresenta etiquetas de nível de host.
| Parâmetro | Descrição |
|---|---|
| Nome/Valor | Configure etiquetas customizadas para marcar eventos do gatilho. Etiquetas são um par de nome e valor de etiqueta. Você pode usar apenas o nome ou pareá-lo com um valor. Um gatilho pode ter várias etiquetas com o mesmo nome, mas valores diferentes. Macros de usuário, contexto de macro de usuário, macros de descoberta de baixo-nível e funções de macro com {{ITEM.VALUE}}, {{ITEM.LASTVALUE}} e são suportadas em etiquetas de evento. Macros de descoberta de baixo-nível pode ser usadas dentro de contexto de macro.A macro {TRIGGER.ID} é suportada nos valores de etiqueta de gatilho. Ela pode ser útil para identificação de gatilhos criados a partir de protótipos de gatilho e, por exemplo, suprimindo problemas destes gatilhos durante uma manutenção. Se o comprimento total de valores expandidos exceder 255, ele será cortado para 255 caracteres. Veja todas as macros suportadas para etiquetas de evento. Etiquetas de evento podem ser usadas para correlação de evento, em condições de ação e também serão vistas em Monitoramento → Problemas ou no widget de Problemas. |
A aba Dependências contém todas as dependências do gatilho.
Clique em Adicionar para adicionar uma nova dependência.
Você também pode configurar um gatilho abrindo um existente, pressionando o botão Clonar e então salvando-o sob um nome diferente.
Teste de expressões
É possível testar as expressões de gatilho configuradas para saber qual seria o resultado da expressão dependendo do valor recebido.
A seguinte expressão de um template oficial é tomada como exemplo:
avg(/Cisco IOS SNMPv2/sensor.temp.value[ciscoEnvMonTemperatureValue.{#SNMPINDEX}],5m)>{$TEMP_WARN}
ou
last(/Cisco IOS SNMPv2/sensor.temp.status[ciscoEnvMonTemperatureState.{#SNMPINDEX}])={$TEMP_WARN_STATUS}Para testar a expressão, clique no Construtor de expressão sob o campo expressão.
No construtor de expressão, todas as expressões individuais são listadas. Para abrir a janela de testes, clique em Testar abaixo da lista de expressões.
Na janela de testes você pode informar amostras de valor ('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 assim como da expressão completa podem ser vistas.
"VERDADEIRO" (TRUE) significa que a expressão especificada está correta. Neste caso particular A, "80" é maior que o valor {$TEMP_WARN} especificado, "70" neste exemplo. Como esperado, um resultado "VERDADEIRO" aparece.
"FALSO" (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 "FALSO" aparece.
O tipo de expressão escolhido é "OR". Se ao menos uma das condições especificadas (A ou B neste caso) é VERDADEIRA, o resultado geral será VERDADEIRO também. Significando que o valor atual excede o valor de alerta e um problema ocorreu.