Las macros de usuario son compatibles con Zabbix para una mayor flexibilidad, además a las macros compatibles fuera de la caja.
Las macros de usuario se pueden definir a nivel global, de plantilla y de host. Estas macros tienen una sintaxis especial:
Zabbix resuelve macros según la siguiente prioridad:
En otras palabras, si no existe una macro para un host, Zabbix intentará encontrarlo en las plantillas de host de mayor profundidad. Si aún no se encuentra, una macro global se utilizara, si existe.
::: nota de advertencia Si existe una macro con el mismo nombre en varias plantillas vinculadas del mismo nivel, la macro de la plantilla con el ID más bajo se utilizara. Tener así macros con el mismo nombre en múltiples plantillas es un riesgo de configuración. :::
Si Zabbix no puede encontrar una macro, la macro no se resolverá.
::: nota importante Las macros (incluidas las macros de usuario) quedan sin resolver en la sección de Configuración (por ejemplo, en la lista de activadores) para hacer que la configuración compleja sea más transparente. :::
Las macros de usuario se pueden utilizar en:
Es recomendable utilizar macros de equipo en lugar de macros globales porque agregar, actualizar o eliminar macros globales fuerza una actualización incremental de la configuración para todos los equipos. Para obtener más información, consulte Comprobaciones de agentes activos y pasivos.
Para definir macros de usuario, vaya a la ubicación correspondiente en la interfaz web:
Una macro de usuario tiene los siguientes atributos:
Parámetro | Descripción |
---|---|
Macro | Nombre de la macro. El nombre debe ir entre llaves y comenzar con un signo de dólar. Ejemplo: {$FRONTEND_URL}. Los siguientes caracteres están permitidos en los nombres de macro: A-Z (solo mayúsculas), 0-9, _, . |
Valor | Valor de la macro. Se admiten tres tipos de valor: Texto (por defecto): valor en texto plano Texto secreto: el valor se oculta con asteriscos Secreto de Vault: el valor contiene una ruta/consulta a un secreto de vault. Para cambiar el tipo de valor, haga clic en el botón al final del campo de entrada de valor. La longitud máxima de un valor de macro de usuario es de 2048 caracteres. |
Descripción | Campo de texto utilizado para proporcionar más información sobre esta macro. |
Al configurar macros de usuario, tenga en cuenta los siguientes comportamientos específicos del contexto:
Uso de macro a nivel de host en la clave del elemento "Estado del demonio SSH":
net.tcp.servicio[ssh,,{$SSH_PORT}]
Este elemento se puede asignar a varios hosts, siempre que el valor de {$SSH_PORT} está definido en esos hosts.
Uso de macro a nivel de host en el activador "La carga de la CPU es demasiado alta":
último(/ca_001/system.cpu.load[,avg1])>{$MAX_CPULOAD}
Dicho activador se crearía en la plantilla, no se editaría en anfitriones individuales.
Si desea utilizar la cantidad de valores como la función parámetro (por ejemplo, max(/host/key,#3)), incluir marca hash en la definición de la macro así: ALGUNA_PERIODO => #3
Uso de dos macros en el activador "La carga de la CPU es demasiado alta":
min(/ca_001/system.cpu.load[,avg1],{$CPULOAD_PERIOD})>{$MAX_CPULOAD}
Tenga en cuenta que una macro se puede utilizar como parámetro de la función de disparo, en esta función de ejemplo min().
Sincronice la condición de indisponibilidad del agente con la actualización del artículo intervalo:
nodata(/ca_001/agent.ping,{$INTERVALO})=1
Centralizar la configuración de los horarios de trabajo:
1-5,09:00-18:00
;Use la macro de prototipo de host para configurar elementos para hosts descubiertos: