Esta é uma tradução da página de documentação original em inglês. Ajude-nos a torná-la melhor.

Sidebar

Zabbix Summit 2022
Register for Zabbix Summit 2022

1 Macros suportadas

Visão geral

A tabela contém uma lista completa de macros suportadas pelo Zabbix sai da caixa.

Para ver todas as macros suportadas em um local (por exemplo, em "URL do mapa"), você pode colar o nome do local na caixa de pesquisa em na parte inferior da janela do seu navegador (acessível pressionando CTRL+F) e faça uma busca por próximo.

Macro Suportado em Descrição
{ACTION.ID} → Notificações e comandos baseados em gatilho
→ Comandos e notificações de atualização de problemas
→ Comandos e notificações baseados em serviço
→ Comandos e notificações de atualização de serviço
→ Comandos e notificações de descoberta
→ Notificações e comandos de registro automático
→ Notificações internas
ID numérico da ação acionada.
{ACTION.NAME} → Notificações e comandos baseados em gatilho
→ Comandos e notificações de atualização de problemas
→ Comandos e notificações baseados em serviço
→ Comandos e notificações de atualização de serviço
→ Comandos e notificações de descoberta
→ Notificações e comandos de registro automático
→ Notificações internas
Nome da ação acionada.
{ALERT.MESSAGE} → Parâmetros do script de alerta Valor da 'mensagem padrão' da configuração da ação.
Suportado desde 3.0.0.
{ALERT.SENDTO} → Parâmetros de script de alerta Valor 'Enviar para' da configuração de mídia do usuário.
Suportado desde 3.0.0.
{ALERT.SUBJECT} → Parâmetros de script de alerta Valor de 'assunto padrão' da configuração da ação.
Suportado desde 3.0.0.
{DATA} → Notificações e comandos baseados em gatilho
→ Comandos e notificações de atualização de problemas
→ Comandos e notificações baseados em serviço
→ Comandos e notificações de atualização de serviço
→ Comandos e notificações de descoberta
>→ Notificações e comandos de registro automático
→ Notificações internas
→ Ação manual do evento scripts
Data atual em aaaa.mm.dd. formato.
{DISCOVERY.DEVICE.IPADDRESS} → Notificações e comandos de descoberta Endereço IP do dispositivo descoberto.
Disponível sempre, não depende da adição do host.
{DISCOVERY.DEVICE.DNS} → Notificações e comandos de descoberta Nome DNS do dispositivo descoberto.
Disponível sempre, não depende da adição do host.
{DISCOVERY.DEVICE.STATUS} → Notificações e comandos de descoberta Status do dispositivo descoberto: pode ser UP ou DOWN.
{DISCOVERY.DEVICE.UPTIME} → Notificações e comandos de descoberta Tempo desde a última alteração do status de descoberta para um determinado dispositivo, com precisão de até um segundo.
Por exemplo: 1h 29m 01s.
Para dispositivos com status DOWN, esse é o período de inatividade.
{DISCOVERY.RULE.NAME} → Notificações e comandos de descoberta Nome da regra de descoberta que descobriu a presença ou ausência do dispositivo ou serviço.
{DISCOVERY.SERVICE.NAME} → Notificações e comandos de descoberta Nome do serviço que foi descoberto.
Por exemplo: HTTP.
{DISCOVERY.SERVICE.PORT} → Notificações e comandos de descoberta Porta do serviço que foi descoberta.
Por exemplo: 80.
{DISCOVERY.SERVICE.STATUS} → Notificações e comandos de descoberta O status do service:// descoberto pode ser UP ou DOWN. | |{DISCOVERY.SERVICE.UPTIME} |→ Notificações e comandos de descoberta |Tempo desde a última alteração do status de descoberta para um determinado serviço, com precisão de até um segundo.
Por exemplo: 1h 29m 01s.
Para serviços com status DOWN, este é o período de inatividade. | |{ESC.HISTORY} |→ Notificações e comandos baseados em gatilho
→ Comandos e notificações de atualização de problemas
→ Comandos e notificações baseados em serviço
→ Comandos e notificações de atualização de serviço
→ Notificações internas |
Histórico de escalonamento. Log de mensagens enviadas anteriormente.
Mostra as notificações enviadas anteriormente, em qual etapa de escalonamento elas foram enviadas e seu status (
enviado//, em andamento ou falhou).
{EVENT.ACK.STATUS} → Notificações e comandos baseados em gatilho
→ Notificações e comandos de atualização de problemas
→ Ação de evento manual scripts
Reconhecimento status do evento (Sim/Não).
{EVENT.AGE} → Notificações e comandos baseados em gatilho
→ Comandos e notificações de atualização de problemas
→ Comandos e notificações baseados em serviço
→ Comandos e notificações de atualização de serviço
→ Notificações e comandos de recuperação de serviço comandos
→ Notificações e comandos de descoberta
→ Notificações e comandos de registro automático
→ Notificações internas
→ Ação de evento manual scripts
Age of the evento que acionou uma ação, com precisão de até um segundo.
Útil em mensagens escaladas.
{EVENT.DATE} → Notificações e comandos baseados em gatilho
→ Comandos e notificações de atualização de problemas
→ Comandos e notificações baseados em serviço
→ Comandos e notificações de atualização de serviço
→ Notificações e comandos de recuperação de serviço comandos
→ Notificação de descoberta cations e comandos
→ Notificações e comandos de registro automático
→ Notificações internas
→ Ação manual do evento scripts
Data do evento que acionou uma ação.
{EVENT.DURATION} → Notificações e comandos baseados em gatilho
→ Comandos e notificações de atualização de problemas
→ Comandos e notificações baseados em serviço
→ Comandos e notificações de atualização de serviço
→ Notificações e comandos de recuperação de serviço comandos
→ Notificações internas
→ Ação manual do evento scripts
Duração do evento (diferença de tempo entre os eventos de problema e de recuperação), com precisão de até um segundo.
Útil em mensagens de recuperação de problemas.

Suportado desde 5.0.0.
{EVENT.ID} → Notificações e comandos baseados em gatilho
→ Notificações e comandos de atualização de problemas
→ Comandos e notificações baseados em serviço
→ Notificações e comandos de atualização de serviço
→ Notificações e comandos de recuperação de serviço comandos
→ Notificações e comandos de descoberta
→ Notificações e comandos de registro automático
→ Notificações internas
→ URLs de acionamento
→ Ação de evento manual scripts
ID numérico do evento que acionou uma ação.
{EVENT.NAME} → Notificações e comandos baseados em gatilho
→ Comandos e notificações de atualização de problemas
→ Comandos e notificações baseados em serviço
→ Comandos e notificações de atualização de serviço
→ Notificações e comandos de recuperação de serviço comandos
→ Notificações internas
→ Ação de evento manual scripts
Nome do evento de problema que acionou uma ação.
Suportado desde 4.0.0 .
{EVENT.NSEVERITY} → Notificações e comandos baseados em gatilho
→ Comandos e notificações de atualização de problemas
→ Comandos e notificações baseados em serviço
→ Comandos e notificações de atualização de serviço
→ Notificações e comandos de recuperação de serviço comandos
→ Ação manual do evento scripts
Valor numérico da gravidade do evento. Valores possíveis: 0 - Não classificado, 1 - Informação, 2 - Aviso, 3 - Média, 4 - Alta, 5 - Desastre.
Suportado desde 4.0.0.
{EVENT.OBJECT} → Notificações e comandos baseados em gatilho
→ Comandos e notificações de atualização de problemas
→ Comandos e notificações baseados em serviço
→ Comandos e notificações de atualização de serviço
→ Notificações e comandos de recuperação de serviço comandos
→ Notificações e comandos de descoberta
→ Notificações e comandos de registro automático
→ Notificações internas
→ Ação de evento manual scripts
Valor numérico de do objeto de evento. Valores possíveis: 0 - Acionador, 1 - Host descoberto, 2 - Serviço descoberto, 3 - Registro automático, 4 - Item, 5 - Regra de descoberta de baixo nível.
Suportado desde 4.4.0.
{EVENT.OPDATA} → Notificações e comandos baseados em gatilho
→ Comandos e notificações de atualização de problemas
→ Ação de evento manual scripts
Dados operacionais de o gatilho subjacente de um problema.
Suportado desde 4.4.0.
{EVENT.RECOVERY.DATE} → Problema notificações de recuperação e comandos
→ Notificações e comandos de atualização de problema (se a recuperação ocorreu)
→ Recuperação de serviço notificações e comandos
→ Ação de evento manual scripts (se a recuperação ocorreu)
Data do evento de recuperação.
{EVENT.RECOVERY.ID} → Problema notificações de recuperação e comandos
→ Notificações e comandos de atualização de problemas (se a recuperação ocorreu)
→ Recuperação de serviço notificações e comandos
→ Ação de evento manual scripts (se a recuperação ocorreu)
ID numérico do evento de recuperação.
{EVENT.RECOVERY.NAME} → Problema notificações de recuperação e comandos
→ Notificações e comandos de atualização de problema (se a recuperação ocorreu)
→ Recuperação de serviço notificações e comandos
→ Ação de evento manual scripts (se a recuperação ocorreu)
Nome do evento de recuperação.
Suportado desde 4.4.1.
{EVENT.RECOVERY.STATUS} → Problema notificações de recuperação e comandos
→ Notificações e comandos de atualização de problema (se a recuperação ocorreu)
→ Recuperação de serviço notificações e comandos
→ Ação manual do evento scripts (se a recuperação ocorreu)
Valor verbal do evento de recuperação.
{EVENT.RECOVERY.TAGS} → Problema [notificações de recuperação](/manual/config
Notas de rodapé

1 As macros são suportadas em rótulos de mapas desde o Zabbix 1.8.

2 Desde o Zabbix 2.0.3, as macros HOST.* são suportadas em parâmetros de chave de item e só funcionam em tipos de item com interfaces compatíveis, p.e. elas não funcionarão para itens do tipo "Zabbix Agent (ativo)", "Calculado", etc.

3 Dependendo do contexto, a macro será expandida de forma diferente. No Zabbix 2.0.1 ou anterior, no contexto de execução de um comando remoto, scripts da GUI, parâmetros de chave de item, interfaces (campos IP/DNS), apenas a interface principal do agente seria considerada como origem da informação. Desde a versão 2.0.2 (para cenários web desde a 2.2.0) a macro será utilizada na interface principal do agente, entretanto, se ela estiver ausente, a interface principal de SNMP será utilizada. Se a interface SNMP também não estiver presente, a interface JMX principal será utilizada. Se a interface JMX não estiver presente, a interface principal IPMI. Em parâmetros de chave de item a interface que estiver selecionada para o item será utilizada, desde o Zabbix 2.0.3.

4 Apenas as funções avg, last, max e min, com segundos como parâmetros são suportadas nesta macro nos rótulos de mapas.

5 Suportado desde o Zabbix 2.0.3.

6 Suportado desde o Zabbix Zabbix 2.2.0. As macros {HOST.*} e as macros de usuário {$MACRO} são suportadas nos campos do cenários web: Nome, Variáveis, Cabeçalhos, Arquivo de certificado SSL, Agente, HTTP proxy, Autenticação (usuário e senha), Senha SSL e Arquivo de chave SSL e nos campos de passos de cenário: Nome, URL, Post, Cabeçalhos, Código de status requerido e Texto requerido.

7 Suportado desde o Zabbix Zabbix 2.2.0. Apenas as funções avg, last, max e min, em seu segundo parâmetro são suportadas com macros nos nomes de gráficos. A macro {HOST.HOST<1-9>} pode ser utilizada em outras macros. Por exemplo:

 * {Cisco switch:ifAlias[{#SNMPINDEX}].last()}
        * %%{{%%HOST.HOST}:ifAlias[{#SNMPINDEX}].last()}

8 Suportado desde o Zabbix 2.4.0.

9 As macros simples são suportadas para construir expressões de gatilho, mas não podem ser utilizadas umas dentro das outras.

10 Suportado desde o Zabbix 3.0.0.

Suporte adicional a macros de usuários

Em adição às localizações listadas, as macros de usuário, desde o Zabbix 2.0, suportam várias outras localizações:

  • Hosts
    • Interface IP/DNS
    • Interface port
  • Proxy Passivo
    • Porta de interface
  • Itens
    • SNMPv3 - nome de contexto
    • SNMPv3 - nome de segurança
    • SNMPv3 - senha de autenticação
    • SNMPv3 - senha privada
    • SNMPv1/v2 comunidade
    • SNMP OID
    • SNMP porta
    • SSH usuário
    • SSH chave pública
    • SSH chave privada
    • SSH senha
    • Telnet usuário
    • Telnet senha
    • Calculados em sua fórmula
    • Trapper no campo "Hosts permtidos" (desde o Zabbix 2.2)
  • Descoberta
    * SNMPv3 - Nome de contexto
           * SNMPv3 - Nome de segurança
           * SNMPv3 - Senha de autorização
           * SNMPv3 - Senha privada
           * SNMPv1/v2 comunidade
           * SNMP OID

Macros utilizadas no processo de descoberta de baixo-nível (LLD)

Temos aqui mais um tipo de macro utilizada no processo de LLD - {#MACRO}. Este tipo de macro é utilizada nas regras de descoberta e pode retornar, por exemplo, os nomes reais dos sistemas de arquivos, interfaces de rede, árvores SNMP.

Estas macros podem ser utilizadas para criar novas entidades (item, trigger, gráficos, hosts) a partir de protótipos. Ao descobrir um novo elemento (sistema de arquivo, interface de rede, etc) estas macros são substituídas pelos nomes reais dos elementos e podem ser utilizadas na criação das novas entidades.

Na descoberta de máquinas virtuais estas macros podem ainda ser utilizadas para criar hosts e grupos de hosts através de protótipos.

As macros LLD podem ser utilizadas em:

  • protótipos de item
    • nomes
    • parâmetros de chaves
    • unidades
    • SNMP OIDs
    • sensores IPMI
    • fórmulas de itens calculados
    • Scripts SSH e Telnet
    • Parâmetros de itens em monitoramento de banco de dados
    • Descrições (Suportado desde o Zabbix 2.2.0)
  • protótipos de gatilho
    • nomes
    • expressões (para se referenciar à um protótipo de gatilho e a consultas independentes)
    • URLs (Suportado desde o Zabbix 3.0.0)
    • Descrições (Suportado desde o Zabbix 2.2.0)
  • protótipos de gráficos
    • nomes
  • protótipos de host (Suportado desde o Zabbix 2.2.0)
    • nomes
    • nomes visíveis
    • nomes de protótipos de grupo
    • (consulte lista completa)

Algumas macros de LLD vêm em conjunto com o processo de LLD do Zabbix - {#FSNAME}, {#FSTYPE}, {#IFNAME}, {#SNMPINDEX}, {#SNMPVALUE}. De qualquer forma o uso destas macros não é obrigatório quando você estiver criando um LLD. Você poderá utilizar qualquer outro nome de macro e referenciá-lo.