[comment]: # translation:outdated [comment]: # ({4a427d30-29480506}) # 1 Configurando um gatilho [comment]: # ({/4a427d30-29480506}) [comment]: # ({00d721e0-ea19cfe1}) #### 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](/manual/config/triggers) sobre gatilhos e seus cálculos de tempo. [comment]: # ({/00d721e0-ea19cfe1}) [comment]: # ({f29fcb83-f29d794b}) #### Configuração A aba **Gatilho** contém todos os atributos essenciais de um gatilho. ![](../../../../assets/en/manual/config/triggers/trigger.png) Todos os campos obrigatórios estão marcados com um asterisco vermelho. |Parâmetro|Descrição| |---------|-----------| |*Nome*|Nome do gatilho.
[Macros](/manual/appendix/macros/supported_by_location) 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](/manual/config/triggers/expression#example_17)).
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](/manual/web_interface/frontend_sections/monitoring/problems)*. 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](severity) requerida para o gatilho clicando nos botões.| |*Expressão*|[Expressão](expression) 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](expression) 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](/manual/config/triggers/expression#hysteresis) 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](/manual/config/events/manual_close) 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](/manual/config/tagging) de nível de gatilho. Todos os problemas deste gatilho serão etiquetados com os valores informados aqui. ![](../../../../assets/en/manual/config/triggers/trigger_b.png) 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](/manual/config/macros/macro_functions) 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](/manual/config/tagging#macro_support) suportadas para etiquetas de evento.
[Etiquetas de evento](/manual/config/tagging) 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](dependencies) do gatilho. Clique em *Adicionar* para adicionar uma nova dependência. ::: noteclassic Você também pode configurar um gatilho abrindo um existente, pressionando o botão *Clonar* e então salvando-o sob um nome diferente. ::: [comment]: # ({/f29fcb83-f29d794b}) [comment]: # ({ce838eef-dbfe2e70}) #### 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. ![](../../../../assets/en/manual/config/triggers/trigger_test.png) 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. ![](../../../../assets/en/manual/config/triggers/expr_test_button.png){width="600"} 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*. ![](../../../../assets/en/manual/config/triggers/expr_test.png){width="600"} 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. [comment]: # ({/ce838eef-dbfe2e70})