Documentation
Table of Contents
1 Condições
Visão geral
É possível definir que uma ação seja executada apenas se o evento corresponde a um conjunto de condições definidas. Condições são definidas quando configurando a ação.
A correspondência de condições é sensível a letras maiúsculas e minúsculas.
Ações de gatilho
As seguintes condições podem ser usadas em ações baseadas em gatilho:
| Tipo de condição | Operadores suportados | Descrição |
|---|---|---|
| Grupo de host | igual (equals) não igual (does not equal) |
Especifica grupos de host ou grupos de host para exclusão. equals - evento pertence a este grupo de host. does not equal - evento não pertence a este grupo de host. A especificação de um grupo de host pai seleciona implicitamente todos os grupos aninhados. Para especificar apenas o grupo pai, todos os grupos aninhados têm de ser adicionalmente configurados com o operador does not equal. |
| Modelo (template) | igual não igual |
Especifica modelos ou modelos para exclusão. equals - evento pertence a um gatilho herdado deste modelo. does not equal - evento não pertence a um gatilho herdado deste modelo. |
| Host | igual não igual |
Especifica hosts ou hosts para exclusão. equals - evento pertence a este host. does not equal - evento não pertence a este host. |
| Nome da etiqueta | igual não igual contém (contains) não contém (does not contain) |
Especifica etiqueta de evento ou etiqueta de evento para exclusão. equals - evento possui esta etiqueta does not equal - evento não possui esta etiqueta contains - evento possui uma etiqueta contendo esta string does not contain - evento não possui uma etiqueta contendo esta string |
| Valor da etiqueta | igual não igual contém não contém |
Especifica etiqueta de evento e combinação de valor ou etiqueta e combinação de valor para exclusão. equals - evento possui esta etiqueta e valor does not equal - evento não possui esta etiqueta e valor contains - evento possui uma etiqueta e valor contendo estas strings does not contain - evento não possui uma etiqueta e valor contendo estas strings |
| Gatilho | igual não igual |
Especifica gatilhos e gatilhos para exclusão. equals - evento é gerado por este gatilho. does not equal - evento é gerado por qualquer outro gatilho, exceto este. |
| Nome do gatilho | contém não contém |
Especifica uma string no nome do gatilho ou uma string para exclusão. contains - evento é gerado por um gatilho, contendo esta string no nome. does not contain - esta string não pode ser encontrada no nome do gatilho. Nota: O valor informado será comparado ao nome do gatilho com todas as macros expandidas. |
| Severidade do gatilho | igual não igual é maior que (is greater than) ou igual (equals) é menor que (is less than) ou igual (equals) |
Especifica severidade do gatilho. equals - igual à severidade do gatilho does not equal - não igual à severidade do gatilho is greater than or equals - maior ou igual à severidade do gatilho is less than or equals - menor ou igual à severidade do gatilho |
| Período de tempo | dentro (in) fora (not in) |
Especifica um período de tempo ou um período de tempo para exclusão. in - horário do evento está dentro do período de tempo. not in - horário do evento está fora do período de tempo. Consulte a página de especificação de período de tempo para descrição do formato. Macros de usuário são suportadas, desde o Zabbix 3.4.0. |
| Problema é suprimido | não (no) sim (yes) |
Especifica se o problema é suprimido (não mostrado) devido manutenção do host. no - problema não é suprimido. yes - problema é suprimido. |
Service actions
The following conditions can be used in service actions:
| Condition type | Supported operators | Description |
|---|---|---|
| Service | equals does not equal |
Specify a service or a service to exclude. equals - event belongs to this service. does not equal - event does not belong to this service. Specifying a parent service implicitly selects all child services. To specify the parent service only, all nested services have to be additionally set with the does not equal operator. |
| Service name | contains does not contain |
Specify a string in the service name or a string to exclude. contains - event is generated by a service, containing this string in the name. does not contain - this string cannot be found in the service name. |
| Service tag name | equals does not equal contains does not contain |
Specify an event tag or an event tag to exclude. Service event tags can be defined in the service configuration section Tags. equals - event has this tag does not equal - event does not have this tag contains - event has a tag containing this string does not contain - event does not have a tag containing this string. |
| Service tag value | equals does not equal contains does not contain |
Specify an event tag and value combination or a tag and value combination to exclude. Service event tags can be defined in the service configuration section Tags. equals - event has this tag and value does not equal - event does not have this tag and value contains - event has a tag and value containing these strings does not contain - event does not have a tag and value containing these strings. |
Make sure to define message templates for Service actions in the Alerts -> Media types menu. Otherwise, the notifications will not be sent.
Ações de descoberta
As seguintes condições podem ser usadas em eventos baseados em descoberta:
| Tipo de condição | Operadores suportados | Descrição |
|---|---|---|
| IP do host | igual (equals) não igual (does not equal) |
Especifica um intervalo de endereço IP ou um intervalo para exclusão para um host descoberto. equals - IP do host está no intervalo. does not equal - IP do host não está no intervalo. Ele pode ter os seguintes formatos: IP único: 192.168.1.33 Intervalo de endereços IP: 192.168.1-10.1-254 Máscara IP: 192.168.4.0/24 Lista: 192.168.1.1-254, 192.168.2.1-100, 192.168.2.200, 192.168.4.0/24 Suporte para espaços no formato de lista é fornecido desde o Zabbix 3.0.0. |
| Tipo de serviço | igual não igual |
Especifica um tipo de serviço de um serviço descoberto ou um tipo de serviço para exclusão. equals - corresponde ao serviço descoberto. does not equal - não corresponde ao serviço descoberto. Tipos de serviço disponíveis: SSH, LDAP, SMTP, FTP, HTTP, HTTPS (disponível desde a versão 2.2 do Zabbix), POP, NNTP, IMAP, TCP, Zabbix agent, SNMPv1 agent, SNMPv2 agent, SNMPv3 agent, ICMP ping, telnet (disponível desde a versão 2.2 do Zabbix). |
| Porta do serviço | igual não igual |
Especifica um intervalo de porta TCP de um serviço descoberto ou um intervalo para exclusão. equals - porta do serviço está no intervalo. does not equal - porta do serviço não está no intervalo. |
| Regra de descoberta | igual não igual |
Especifica uma regra de descoberta ou uma regra de descoberta para exclusão. equals - usando esta regra de descoberta. does not equal - usando qualquer outra regra de descoberta, exceto esta. |
| Verificação de descoberta | igual não igual |
Especifica uma verificação de descoberta ou uma verificação de descoberta para exclusão. equals - usando esta verificação de descoberta. does not equal - usando qualquer outra verificação de descoberta, exceto esta. |
| Objeto da descoberta | igual (equals) | Especifica o objeto da descoberta. equals - igual ao objeto descoberto (um dispositivo ou um serviço). |
| Estado da descoberta | igual | Up - corresponde aos eventos 'Host Up' e 'Serviço Up' Down - corresponde aos eventos 'Host Down' e 'Serviço Down' Discovered - corresponde aos eventos 'Host Descoberto' e 'Serviço Descoberto' Lost - corresponde aos eventos 'Host Perdido' e 'Serviço Perdido' |
| Tempo ativo (Uptime)/Tempo inativo (Downtime) | é maior que ou igual é menor que ou igual |
Tempo ativo para eventos 'Host Up' e 'Serviço Up'. Tempo inativo para eventos 'Host Down' e 'Serviço Down'. is greater than or equals - é maior ou igual a. Parâmetro é dado em segundos. is less than or equals - é menor ou igual a. Parâmetro é dado em segundos. |
| Valor recebido | igual não igual é maior que ou igual é menor que ou igual contém não contém |
Especifica o valor recebido de uma verificação de agente (Zabbix, SNMP) em uma regra de descoberta. Comparação de string. Se várias verificações de Zabbix Agent ou SNMP são definidas para uma regra, os valores recebidos para cada uma delas são verificadas (cada verificação gera um novo evento que é correspondido contra todas as condições). equals - igual ao valor. does not equal - não igual ao valor. is greater than or equals - maior ou igual ao valor. is less than or equals - menor ou igual ao valor. contains - contém a substring. Parâmetro é dado como uma string. does not contain - não contém a substring. Parâmetro é dado como uma string. |
| Proxy | igual não igual |
Especifica um proxy ou um proxy para exclusão. equals - usando este proxy. does not equal - não usando qualquer outro proxy exceto este. |
Verificações de serviço em uma regra de descoberta, que resultam em eventos de descoberta, não ocorrem simultaneamente. Portanto, se múltiplos valores são configurados para condições de Tipo do serviço, Porta do serviço ou Valor recebido na ação, eles serão comparados com um evento de descoberta por vez, mas não com vários eventos simultaneamente. Como resultado, ações com múltiplos valores para os mesmos tipos de verificação podem não ser executadas corretamente.
Ações de autoregistro
As seguintes condições podem ser usadas em ações baseadas em autoregistro de agente ativo:
| Tipo de condição | Operadores suportados | Descrição |
|---|---|---|
| Metadados do host | contém não contém corresponde não corresponde |
Especifica metadados do host ou metadados do host para exclusão. contains - metadados do host contêm a string. does not contain - metadados do host não contêm a string. Os metadados do host podem ser especificados em um arquivo de configuração. matches - metadados do host corresponde à expressão regular. does not match - metadados do host não corresponde à expressão regular. |
| Nome do host | contém não contém corresponde não corresponde |
Especifica um nome de host ou um nome de host para exclusão. contains - nome do host contém a string. does not contain - nome do host não contém a string. matches - nome do host corresponde à expressão regular. does not match - nome do host não corresponde à expressão regular. |
| Proxy | igual não igual |
Especifica um proxy ou um proxy para exclusão. equals - usando o proxy. does not equal - usando qualquer outro proxy exceto este. |
Ações de evento interno
As seguintes condições podem ser definidas baseadas em eventos internos:
| Tipo de condição | Operadores suportados | Descrição |
|---|---|---|
| Tipo do evento | igual (equals) | Item in "not supported" state - corresponde a eventos onde um item vai do estado 'normal' ao 'não suportado' Low-level discovery rule in "not supported" state - corresponde a eventos onde uma regra de descoberta de baixo-nível vai do estado 'normal' ao 'não suportado' Trigger in "unknown" state - corresponde a eventos onde um gatilho vai do estado 'normal' ao 'não suportado' |
| Grupo de host | igual não igual |
Especifica grupos de host ou grupos de host para exclusão. equals - evento pertence a este grupo de host. does not equal - evento não pertence a este grupo de host. |
| Nome de etiqueta | igual não igual contém não contém |
Especifica etiqueta de evento ou etiqueta de evento para exclusão. equals - evento possui esta etiqueta does not equal - evento não possui esta etiqueta contains - evento possui uma etiqueta contendo esta string does not contain - evento não possui uma etiqueta contendo esta string |
| Valor da etiqueta | igual não igual contém não contém |
Especifica combinação de etiqueta do evento e valor ou combinação de etiqueta e valor para exclusão. equals - evento possui esta etiqueta e valor does not equal - evento não possui esta etiqueta e valor contains - evento possui uma etiqueta e valor contendo estas strings does not contain - evento não possui uma etiqueta e valor contendo estas strings |
| Modelo | igual não igual |
Especifique modelos ou modelos para exclusão. equals - evento pertence a um item/gatilho/regra de descoberta de baixo-nível herdado deste modelo. does not equal - evento não pertence a um item/gatilho/regra de descoberta de baixo-nível herdado deste modelo. |
| Host | igual não igual |
Especifica hosts ou hosts para exclusão. equals - evento pertence a este host. does not equal - evento não pertence a este host. |
Tipo de cálculo
As seguintes opções de cálculo de condições estão disponíveis:
- And - todas as condições devem ser atendidas
Note que o uso de cálculo "And" não é permitido entre vários gatilhos quando eles são selecionados como uma condição Trigger=. Ações só podem ser executadas baseadas no evento de um gatilho.
- Or - suficiente se uma condição é atendida
- And/Or - combinação das duas: AND com diferentes tipos de condição e OR com o mesmo tipo de condição, por exemplo:
Grupo de host igual Oracle servers
Grupo de host igual MySQL servers
Nome do gatilho contém 'Banco de dados está down'
Nome do gatilho contém 'Banco de dados está indisponível'
é avaliado como
(Grupo de host equals Oracle servers or Grupo de host equals MySQL servers) and (Nome do gatilho contains 'Banco de dados está down' or Nome do gatilho contains 'Banco de dados está indisponível')
- Custom expression - (expressão customizada) uma fórmula de cálculo definida pelo usuário para avaliação de condições de ação. Deve incluir todas as condições (representadas como letra maiúsculas A, B, C, ...) e pode incluir espaços, tabulações, parêntesis ( ), and (sensível a maiúsculas e minúsculas), or (sensível a maiúsculas e minúsculas), not (sensível a maiúsculas e minúsculas).
Enquanto o exemplo anterior com And/Or seria representado como (A or B) e (C or D), em uma expressão customizada você pode também ter múltiplas formas de cálculo:
(A and B) and (C or D)
(A and B) or (C and D)
((A or B) and C) or D
(not (A or B) and C) or not D
etc.
Ações desabilitadas devido objetos eliminados
Se um certo objeto (host, modelo, gatilho, etc.) usado em uma ação condição/operação é eliminado, a condição/operação é removida e a ação é desabilitada para evitar execução incorreta da ação. A ação pode ser reabilitada pelo usuário.
Este comportamento ocorre quando eliminando:
- grupos de host (condição "grupo de host", operação "comando remoto" em um grupo de host específico);
- hosts (condição "host", operação "comando remoto" em um host específico);
- modelos (condição "modelo", operações "associar a modelo" e "desassociar de modelo");
- gatilhos (condição "gatilho");
- regras de descoberta (quando usando condições "regra de descoberta" e "verificação de descoberta").
Nota: Se um comando remoto tem muitos hosts alvo, e nós eliminamos um deles, apenas este host será removido da lista alvo, a operação em si permanecerá. Mas, se for o único host, a operação será removida, também. O mesmo se aplica para operações "associar a modelo" e "desassociar de modelo".
Ações não são desabilitadas quando eliminando um usuário ou grupo de usuário usado em uma operação "enviar mensagem".