1 Macros soportadas

Descripción general

Esta página contiene una lista completa de macros integradas compatibles con Zabbix, agrupadas por área de aplicación.

Acciones

Fecha y hora

Descubrimiento

Eventos

Eventos de causa y síntoma

Las macros {EVENT.CAUSE.*} se utilizan en el contexto de un evento de síntoma, por ejemplo, en notificaciones; devuelven información sobre el evento de causa.

La macro {EVENT.SYMPTOMS} se utiliza en el contexto del evento de causa y devuelve información sobre los eventos de síntoma.

Funciones

Hosts

Ver también: Inventario de host

Grupos de equipos

Inventario de host

Items

Reglas de descubrimiento de bajo nivel

Mapas

Proxies

Scripts

Servicios

Triggers

Usuarios

Otros tipos de macros

Notas al pie

¹ Las macros {HOST.*} admitidas en los parámetros de clave de elemento se resolverán en la interfaz que se seleccione para el elemento. Cuando se utilicen en elementos sin interfaces, se resolverán en la interfaz de agente Zabbix, SNMP, JMX o IPMI del host en este orden de prioridad o en 'UNKNOWN' si el host no tiene ninguna interfaz.

² En los scripts globales, los campos de IP/DNS de la interfaz y los escenarios web, la macro se resolverá en la interfaz principal del agente. Si no se define una interfaz de agente, se utilizará la interfaz principal de SNMP. Si tampoco se define una interfaz de SNMP, se utilizará la interfaz principal de JMX. Si tampoco se define una interfaz de JMX, se utilizará la interfaz principal de IPMI. Si el host no tiene ninguna interfaz, la macro se resuelve en 'UNKNOWN'.

³ Solo se admite una única función avg, last, max, min con segundos como parámetro (se pueden usar sufijos de tiempo) en esta macro en las etiquetas de los mapas.

# Ejemplo de uso:
       {?avg(/{HOST.HOST}/item.key,1h)}
       
       # Uso no admitido:
       {?last(/host/item1)/last(/host/item2)}
       {?last(/host/item1)*10}
       {?count(/host/item1,5m)}

⁴ Las macros {HOST.*} son compatibles en los campos Variables, Encabezados, Archivo de certificado SSL y Archivo de clave SSL del escenario web y en los campos URL, Post, Encabezados y Cadena requerida del paso del escenario. Desde Zabbix 5.2.2, las macros {HOST.*} ya no son compatibles en los campos Nombre del escenario web y Nombre del paso del escenario web.

⁵ Solo se admite una única función avg, last, max, min con segundos como parámetro (se pueden usar sufijos de tiempo) dentro de esta macro en los nombres de los gráficos (ver ejemplos en la nota al pie 3). La macro {HOST.HOST<1-9>} se puede usar como host dentro de la macro (ver también macros indexadas).

⁶ Compatible en elementos de tipo Script y elementos de tipo Navegador y scripts de acciones manuales de host para Zabbix server y Zabbix proxy.

Macros indexadas

La sintaxis de macro indexada {MACRO<1-9>} solo puede hacer referencia al elemento, función o equipo N-ésimo en el campo Expresión de un disparador:

• {HOST.IP1}, {HOST.IP2}, {HOST.IP3} se resuelven a las direcciones IP del primer, segundo y tercer equipo en la expresión del disparador (si están presentes).
• {ITEM.VALUE1}, {ITEM.VALUE2}, {ITEM.VALUE3} se resuelven a los valores del primer, segundo y tercer elemento en la expresión del disparador en el momento del evento (si están presentes).
• {FUNCTION.VALUE1}, {FUNCTION.VALUE2}, {FUNCTION.VALUE3} se resuelven a los valores de la primera, segunda y tercera función basada en elementos en el momento del evento (si están presentes).

En el contexto de los disparadores, las macros indexadas siempre se refieren al campo Expresión de la configuración del disparador, no a la Expresión de recuperación. Por ejemplo, en un evento de recuperación, {ITEM.VALUE2} se resolverá al valor del segundo elemento de la expresión de problema en el momento de la recuperación.

La macro {HOST.HOST<1-9>} también es compatible dentro de la macro de expresión {?func(/host/key,param)} en nombres de gráficos. Por ejemplo, {?func(/{HOST.HOST2}/key,param)} en un nombre de gráfico se resolverá al equipo del segundo elemento en el gráfico.