1 Macros suportadas

Visão geral

Esta página contém uma lista completa de macros internas suportadas pelo Zabbix, agrupadas por área de aplicação.

Ações

Data e hora

Descoberta

Eventos

Eventos de causa e sintoma

As macros {EVENT.CAUSE.*} são usadas no contexto de um evento de sintoma, por exemplo, em notificações; elas retornam informações sobre o evento de causa.

A macro {EVENT.SYMPTOMS} é usada no contexto do evento de causa e retorna informações sobre eventos de sintoma.

Funções

Hosts

Veja também: Inventário do host

Grupos de hosts

Inventário do host

Items

Regras de descoberta de baixo nível

Mapas

Proxies

Scripts

Serviços

Triggers

Usuários

Outros tipos de macros

Notas de rodapé

¹ As macros {HOST.*} suportadas nos parâmetros de chave de item serão resolvidas para a interface que está selecionada para o item. Quando usadas em itens sem interfaces, elas serão resolvidas para a interface do agent Zabbix, SNMP, JMX ou IPMI do host nesta ordem de prioridade ou para 'UNKNOWN' se o host não tiver nenhuma interface.

² Em scripts globais, campos de IP/DNS de interface e cenários web, a macro será resolvida para a interface principal do agent. Se uma interface de agent não for definida, a interface principal SNMP será usada. Se uma interface SNMP também não for definida, a interface principal JMX será usada. Se uma interface JMX também não for definida, a interface principal IPMI será usada. Se o host não tiver nenhuma interface, a macro será resolvida para 'UNKNOWN'.

³ Apenas uma única função avg, last, max, min com segundos como parâmetro (sufixos de tempo suffixes podem ser usados) é suportada nesta macro em rótulos de mapas.

# Exemplo de uso:
       {?avg(/{HOST.HOST}/item.key,1h)}
       
       # Uso não suportado:
       {?last(/host/item1)/last(/host/item2)}
       {?last(/host/item1)*10}
       {?count(/host/item1,5m)}

⁴ As macros {HOST.*} são suportadas nos campos Variáveis, Cabeçalhos, Arquivo de certificado SSL e Arquivo de chave SSL do cenário web e nos campos URL, Post, Cabeçalhos e String obrigatória da etapa do cenário. Desde o Zabbix 5.2.2, as macros {HOST.*} não são mais suportadas nos campos Nome do cenário web e Nome da etapa do cenário web.

⁵ Apenas uma única função avg, last, max, min com segundos como parâmetro (sufixos de tempo suffixes podem ser usados) é suportada dentro desta macro em nomes de gráficos (veja exemplos na nota de rodapé 3). A macro {HOST.HOST<1-9>} pode ser usada como host dentro da macro (veja também macros indexadas).

⁶ Suportado em itens do tipo Script e itens do tipo Browser e scripts de ação manual de host para o Zabbix server e Zabbix proxy.

Macros indexadas

A sintaxe de macro indexada {MACRO<1-9>} só pode fazer referência ao N-ésimo item, função ou host no campo Expressão de um trigger:

• {HOST.IP1}, {HOST.IP2}, {HOST.IP3} são resolvidas para os endereços IP do primeiro, segundo e terceiro hosts na expressão do trigger (se presentes).
• {ITEM.VALUE1}, {ITEM.VALUE2}, {ITEM.VALUE3} são resolvidas para os valores do primeiro, segundo e terceiro items na expressão do trigger no momento do evento (se presentes).
• {FUNCTION.VALUE1}, {FUNCTION.VALUE2}, {FUNCTION.VALUE3} são resolvidas para os valores da primeira, segunda e terceira funções baseadas em item no momento do evento (se presentes).

No contexto de triggers, as macros indexadas sempre se referem ao campo Expressão da configuração do trigger, não à Expressão de recuperação. Por exemplo, em um evento de recuperação, {ITEM.VALUE2} será resolvida para o valor do segundo item da expressão de problema no momento da recuperação.

A macro {HOST.HOST<1-9>} também é suportada dentro da macro de expressão {?func(/host/key,param)} em nomes de gráficos. Por exemplo, {?func(/{HOST.HOST2}/key,param)} em um nome de gráfico será resolvido para o host do segundo item no gráfico.