Table of Contents

2 Macros de usuario

2 Macros de usuario

Descripción general

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:

{$MACRO}

Zabbix resuelve macros según la siguiente prioridad:

macros a nivel de host (comprobadas primero)
macros definidas para plantillas de primer nivel del host (es decir, plantillas vinculadas directamente al host), ordenadas por ID de plantilla
macros definidas para plantillas de segundo nivel del host, ordenadas por ID de plantilla
macros definidas para plantillas de tercer nivel del host, ordenadas por ID de plantilla, etc.
macros globales (verificadas por última vez)

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:

nombre del item
parámetro clave del item
intervalos de actualización de artículos e intervalos flexibles
nombre y descripción del activador
desencadenar parámetros y constantes de expresión (ver ejemplos)
muchos otros lugares - ver el completo lista

Casos de uso comunes de macros globales y de host

utilizar una macro global en varios lugares; luego cambia el valor de la macro y aplique cambios de configuración a todas las ubicaciones con un solo clic
aproveche las plantillas con atributos específicos del host: contraseñas, números de puerto, nombres de archivo, expresiones regulares, etc.

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.

Configuración

Para definir macros de usuario, vaya a la ubicación correspondiente en el frontend:

para macros globales, visite Administración → Macros
para macros a nivel de host y plantilla, abra las propiedades del host o de la plantilla y busca la pestaña Macros

Si una macro de usuario se utiliza en elementos o activadores en un plantilla, se sugiere agregar esa macro a la plantilla incluso si se define a nivel global. De esa manera, si el tipo de macro es texto exportar la plantilla a XML e importarla en otro sistema todavía permita que funcione como se esperaba. Los valores de las macros secretas no son exportado.

Una macro de usuario tiene los siguientes atributos:

Parámetro	Descripción
Macro	Nombre de la macro. El nombre debe estar entre llaves y comenzar con un signo de dólar. Ejemplo: {$FRONTEND_URL}. Se permiten los siguientes caracteres en los nombres de las macros: A-Z (solo mayúsculas), 0-9, _, .
Valor	Valor de macro. Se admiten tres tipos de valores: Text (predeterminado): valor de texto sin formato Texto secreto: el valor está enmascarado con asteriscos Secreto de bóveda: el valor contiene una ruta/consulta a un secreto de bóveda. 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 2048 caracteres.
Descripción	Campo de texto utilizado para proporcionar más información sobre esta macro.

::: nota importante En las expresiones de activación, las macros de usuario se resolverán si haciendo referencia a un parámetro o constante. NO resolverán si haciendo referencia a un host, clave de elemento, función, operador u otro activador expresión. Las macros secretas no se pueden utilizar en el disparador expresiones. :::

Ejemplos

Ejemplo 1

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.

Ejemplo 2

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

Ejemplo 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().

Ejemplo 4

Sincronice la condición de indisponibilidad del agente con la actualización del artículo intervalo:

definir la macro {$INTERVAL} y usarla en el intervalo de actualización del artículo;
use {$INTERVALO} como parámetro del activador de indisponibilidad del agente:

nodata(/ca_001/agent.ping,{$INTERVALO})=1

Ejemplo 5

Centralizar la configuración de los horarios de trabajo:

crear una macro global {$WORKING_HOURS} igual a 1-5,09:00-18:00;
utilícela en el campo Tiempo de trabajo en Administración → General → GUI;
utilícela en el campo Cuando esté activo en Administración → Usuario → Medios de comunicación;
utilícela para configurar un sondeo de métricas más frecuentes durante el horario laboral:

utilícela en la condición de acción Período de tiempo;
ajustar el tiempo de trabajo en Administración → General → Macros, si es necesario.

Ejemplo 6

Use la macro de prototipo de host para configurar elementos para hosts descubiertos:

en un prototipo de host, defina la macro de usuario {$SNMPVALUE} con {#SNMPVALUE} nivel bajo descubrimiento macro como un valor:

asignar la plantilla Generic SNMPv2 al prototipo de host;
use {$SNMPVALUE} en el campo SNMP OID de Generic SNMPv2 elementos de la plantilla.

Contexto de macro de usuario

Ver macros de usuario con contexto.

Documentation