1 Macros suportadas

Visão geral

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

Notas de rodapé

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

² 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.

³ 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.

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

⁵ Suportado desde o Zabbix 2.0.3.

⁶ 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.

⁷ 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()}

⁸ Suportado desde o Zabbix 2.4.0.

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

¹⁰ 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.