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 ³¦´Ç²Ô³Ù¨¦³¾ (contains) n?o ³¦´Ç²Ô³Ù¨¦³¾ (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 ³¦´Ç²Ô³Ù¨¦³¾ n?o ³¦´Ç²Ô³Ù¨¦³¾ |
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 | ³¦´Ç²Ô³Ù¨¦³¾ n?o ³¦´Ç²Ô³Ù¨¦³¾ |
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 Áú»¢¶Ä²© 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 Áú»¢¶Ä²© 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 Áú»¢¶Ä²©), POP, NNTP, IMAP, TCP, Áú»¢¶Ä²© agent, SNMPv1 agent, SNMPv2 agent, SNMPv3 agent, ICMP ping, telnet (dispon¨ªvel desde a vers?o 2.2 do Áú»¢¶Ä²©). |
| 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 ³¦´Ç²Ô³Ù¨¦³¾ n?o ³¦´Ç²Ô³Ù¨¦³¾ |
Especifica o valor recebido de uma verifica??o de agente (Áú»¢¶Ä²©, SNMP) em uma regra de descoberta. Compara??o de string. Se v¨¢rias verifica??es de Áú»¢¶Ä²© 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 - ³¦´Ç²Ô³Ù¨¦³¾ a substring. Par?metro ¨¦ dado como uma string. does not contain - n?o ³¦´Ç²Ô³Ù¨¦³¾ 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 ³¾¨²±ô³Ù¾±±è±ô´Ç²õ 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 ³¾¨²±ô³Ù¾±±è±ô´Ç²õ 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 | ³¦´Ç²Ô³Ù¨¦³¾ n?o ³¦´Ç²Ô³Ù¨¦³¾ 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 | ³¦´Ç²Ô³Ù¨¦³¾ n?o ³¦´Ç²Ô³Ù¨¦³¾ corresponde n?o corresponde |
Especifica um nome de host ou um nome de host para exclus?o. contains - nome do host ³¦´Ç²Ô³Ù¨¦³¾ a string. does not contain - nome do host n?o ³¦´Ç²Ô³Ù¨¦³¾ 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 ³¦´Ç²Ô³Ù¨¦³¾ n?o ³¦´Ç²Ô³Ù¨¦³¾ |
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 ³¦´Ç²Ô³Ù¨¦³¾ n?o ³¦´Ç²Ô³Ù¨¦³¾ |
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 ³¦´Ç²Ô³Ù¨¦³¾ 'Banco de dados est¨¢ down'
Nome do gatilho ³¦´Ç²Ô³Ù¨¦³¾ '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".