Table of Contents

3 Plantillas

3 Plantillas

Descripción general

Las plantillas se exportan con muchos objetos relacionados y relaciones entre objetos.

La exportación de plantilla contiene:

Grupos de plantillas vinculados
Grupos de equipos vinculados (si se usan en la configuración de prototipo de equipo)
Datos de plantilla
Vinculación a otras plantillas.
Vinculación a grupos de plantillas.
Métricas directamente vinculadas
Iniciadores directamente vinculados
Gráficos directamente vinculados
Tableros directamente vinculados
Reglas de descubrimiento directamente vinculadas con todos los prototipos.
Escenarios web directamente vinculados
Mapas de valores

Exportación

Para exportar plantillas, haga lo siguiente:

Vaya a Recogida de datos → Plantillas.
Marque las casillas de verificación de las plantillas a exportar.
Haga clic en Exportar debajo de la lista.

Dependiendo del formato seleccionado, las plantillas son exportadas a un archivo local con un nombre predeterminado:

zabbix\_export\_templates.yaml - en la exportación YAML (opción predeterminada para exportar);
zabbix\_export\_templates.xml - en la exportación XML;
zabbix\_export\_templates.json - en la exportación JSON.

Importación

Para importar plantillas, haga lo siguiente:

Vaya a Recopilación de datos → Plantillas.
Haga clic en Importar en la esquina superior derecha.
Seleccione el archivo de importación.
Haga clic en Importar en la esquina inferior derecha del formulario de configuración.

Si marca la casilla Opciones avanzadas, se mostrará una lista detallada de todos los elementos importables; marque o desmarque cada regla de importación según sea necesario.

Si hace clic en la casilla de la fila Todo, todos los elementos debajo de ella serán marcados/desmarcados.

Reglas de importación:

Regla	Descripción
Actualizar existentes	Los elementos existentes se actualizarán utilizando los datos del archivo de importación. De lo contrario, no se actualizarán.
Crear nuevos	Se crearán nuevos elementos utilizando los datos del archivo de importación. De lo contrario, no se crearán.
Eliminar faltantes	Los elementos existentes que no estén presentes en el archivo de importación serán eliminados. De lo contrario, no se eliminarán. Si se marca Eliminar faltantes para Vinculación de plantilla, la vinculación de plantilla actual que no esté presente en el archivo de importación se desvinculará. Las entidades (elementos, disparadores, gráficos, etc.) heredadas de las plantillas desvinculadas no se eliminarán (a menos que también se seleccione la opción Eliminar faltantes para cada entidad).

En la siguiente pantalla, podrá ver el contenido de una plantilla que se está importando. Si se trata de una nueva plantilla, todos los elementos se mostrarán en verde. Si está actualizando una plantilla existente, los nuevos elementos de la plantilla se resaltarán en verde; los elementos eliminados se resaltarán en rojo; los elementos que no hayan cambiado se mostrarán con un fondo gris.

El menú de la izquierda se puede utilizar para navegar por la lista de cambios. La sección Actualizados resalta todos los cambios realizados en los elementos existentes de la plantilla. La sección Añadidos enumera los nuevos elementos de la plantilla. Los elementos de cada sección se agrupan por tipo de elemento; haga clic en la flecha gris para expandir o contraer el grupo de elementos.

Revise los cambios de la plantilla y luego haga clic en Importar para realizar la importación de la plantilla. En la interfaz web se mostrará un mensaje de éxito o fallo de la importación.

Formato de exportación

Cuando se exporta una plantilla, Zabbix genera un documento estructurado en YAML, JSON o XML. Este documento contiene elementos que representan todas las partes de la plantilla, como metadatos de la plantilla, elementos, macros, disparadores, paneles y más.

Cada elemento cumple una función específica y puede contener elementos anidados.

Las siguientes secciones describen cada elemento en el formato de exportación.

Se utiliza como ejemplo la plantilla Linux por agente Zabbix.

Un paréntesis (...) indica contenido omitido por brevedad. La nota (ver tabla abajo) se utiliza cuando el elemento se explica con más detalle en secciones posteriores.

Metadatos de la plantilla

zabbix_export:
         version: '7.4'
         template_groups:
           - uuid: 846977d1dfed4968bc5f8bdb363285bc
             name: 'Plantillas/Sistemas operativos'
         templates: (ver tabla abajo)
         triggers: (ver tabla abajo)
         graphs: (ver tabla abajo)

Elemento		Tipo	Descripción
version		cadena	(obligatorio) Versión de exportación.
template_groups			(obligatorio) Elemento raíz para los grupos de plantillas.
	uuid	cadena	(obligatorio) Identificador único para este grupo de plantillas.
	name	cadena	(obligatorio) Nombre del grupo de plantillas.
host_groups			Elemento raíz para los grupos de equipos que son usados por los prototipos de equipos.
	uuid	cadena	(obligatorio) Identificador único para este grupo de equipos.
	name	cadena	(obligatorio) Nombre del grupo de equipos.
templates			Elemento raíz para las plantillas.
triggers			Elemento raíz para los elementos de disparadores de plantilla, que son los mismos que para los disparadores de elementos de plantilla.
graphs			Elemento raíz para los elementos de gráficos de plantilla, que son los mismos que para los gráficos de equipos.

Plantillas

zabbix_export:
         (...)
         templates:
           - uuid: f8f7908280354f2abeed07dc788c3747
             template: 'Linux por agente Zabbix'
             name: 'Linux por agente Zabbix'
             description: |
               Esta es una plantilla oficial de Linux. Requiere el agente Zabbix 7.4 o superior. (...)
             wizard_ready: 'YES'
             readme: |
               ## Descripción general
               
               Esta es una plantilla oficial de Linux. Requiere el agente Zabbix 7.4 o superior. (...)
             vendor:
               name: Zabbix
               version: 7.4-2
             groups:
               - name: 'Plantillas/Sistemas operativos'
             items: (ver tabla abajo)
             discovery_rules: (ver tabla abajo)
             tags:
               - tag: class
                 value: os
               - tag: target
                 value: linux
             macros:
               - macro: '{$AGENT.TIMEOUT}'
                 value: 3m
                 description: 'Tiempo de espera tras el cual el agente se considera no disponible. Solo funciona para agentes accesibles desde el servidor/proxy Zabbix (modo pasivo).'
                 config: (ver tabla abajo)
               - macro: '{$CPU.UTIL.CRIT}'
                 value: '90'
                 description: 'Umbral crítico de utilización de CPU expresado en %.'
                 config: (ver tabla abajo)
               (...)
             dashboards: (ver tabla abajo)
             valuemaps: (ver tabla abajo)
           (...)

Elemento		Tipo	Descripción
uuid		cadena	(obligatorio) Identificador único para esta plantilla.
template		cadena	(obligatorio) Nombre único de la plantilla.
name		cadena	Nombre visible de la plantilla.
description		texto	Descripción de la plantilla.
wizard_ready		texto	Indica si la plantilla está disponible para su selección en el Asistente de Hosts. Valores posibles:¹ NO (0, por defecto), YES (1). Ver también: Objeto plantilla (`wizard_ready`).
readme		texto	Instrucciones de configuración específicas de la plantilla que se mostrarán en el Asistente de Hosts. Soporta formato Markdown.
vendor			Elemento raíz para el proveedor de la plantilla (presente si la plantilla exportada contiene datos del proveedor).
	name	cadena	(obligatorio) Nombre del proveedor de la plantilla.
	version	cadena	(obligatorio) Versión de la plantilla. Para plantillas integradas, la versión se muestra de la siguiente manera: versión principal de Zabbix, delimitador ("-"), número de revisión (aumenta con cada nueva versión de la plantilla y se reinicia con cada versión principal de Zabbix). Por ejemplo, 7.0-0, 7.0-3, 7.4-0, 7.4-3.
templates			Elemento raíz para plantillas enlazadas.
	name	cadena	(obligatorio) Nombre de la plantilla.
groups			Elemento raíz para grupos de plantillas.
	name	cadena	(obligatorio) Nombre del grupo de plantillas.
items			Elemento raíz para elementos de plantilla.
discovery_rules			Elemento raíz para reglas de bajo nivel de descubrimiento de plantilla.
httptests			Elemento raíz para escenarios web de plantilla.
tags			Elemento raíz para etiquetas de plantilla.
	tag	cadena	(obligatorio) Nombre de la etiqueta.
	value	cadena	Valor de la etiqueta.
macros			Elemento raíz para macros de usuario de plantilla.
	macro	cadena	(obligatorio) Nombre de la macro de usuario.
	type	cadena	Tipo de macro de usuario. Valores posibles:¹ TEXT (0, por defecto), SECRET_TEXT (1), VAULT (2). Ver también: Objeto macro de usuario (`type`).
	value	cadena	Valor de la macro de usuario.
	description	cadena	Descripción de la macro de usuario.
	config		Elemento raíz para la configuración de macro de plantilla responsable de cómo se muestra la macro en el Asistente de Hosts.
dashboards			Elemento raíz para paneles de plantilla.
valuemaps			Elemento raíz para mapas de valores de plantilla.

Elementos de la plantilla

zabbix_export:
         (...)
         templates:
           (...)
             items:
               - uuid: f94f9f4699e94c369e6c98b2a2f485ce
                 name: 'Ping del agente Zabbix'
                 key: agent.ping
                 description: 'El agente siempre devuelve "1" para este elemento. Puede usarse en combinación con `nodata()` para la comprobación de disponibilidad.'
                 valuemap:
                   name: 'Estado de ping del agente Zabbix'
                 tags:
                   - tag: component
                     value: system
               (...)
               - uuid: 58818005e76d46dda14d6592f601ab00
                 name: 'Número de paquetes instalados'
                 key: system.sw.packages.get
                 delay: 1h
                 preprocessing: (ver tabla abajo)
                 tags:
                   - tag: component
                     value: os
                 triggers: (ver tabla abajo)
               - uuid: 403cebed115441369e94d35d070ca7b8
                 name: 'Utilización de memoria'
                 type: DEPENDENT
                 key: vm.memory.utilization
                 value_type: FLOAT
                 units: '%'
                 description: 'El porcentaje de memoria utilizada se calcula como `100-pavailable`.'
                 preprocessing: (ver tabla abajo)
                 master_item:
                   key: 'vm.memory.size[pavailable]'
                 tags:
                   - tag: component
                     value: memory
                 triggers: (ver tabla abajo)
               (...)

Elemento		Tipo	Descripción
uuid		cadena	(obligatorio) Identificador único para este elemento.
name		cadena	(obligatorio) Nombre del elemento.
type		cadena	Tipo de elemento. Valores posibles:¹ ZABBIX_PASSIVE (0, por defecto), TRAP (2), SIMPLE (3), INTERNAL (5), ZABBIX_ACTIVE (7), EXTERNAL (10), ODBC (11), IPMI (12), SSH (13), TELNET (14), CALCULATED (15), JMX (16), SNMP_TRAP (17), DEPENDENT (18), HTTP_AGENT (19), SNMP_AGENT (20), ITEM_TYPE_SCRIPT (21), ITEM_TYPE_BROWSER (22).
snmp_oid		cadena	(obligatorio para elementos SNMP_AGENT) ID de objeto SNMP.
key		cadena	(obligatorio) Clave del elemento.
delay		cadena	Intervalo de actualización del elemento. Por defecto: 1m. El valor siempre será 0 para elementos TRAP.
history		cadena	Periodo de tiempo (usando sufijo de tiempo, macro de usuario o macro LLD) durante el cual se deben almacenar los datos históricos. Por defecto: 31d.
trends		cadena	Periodo de tiempo (usando sufijo de tiempo, macro de usuario o macro LLD) durante el cual se deben almacenar los datos de tendencias. Por defecto: 365d.
status		cadena	Estado del elemento. Valores posibles:¹ ENABLED (0, por defecto), DISABLED (1).
value_type		cadena	Tipo de valor recibido. Valores posibles:¹ FLOAT (0), CHAR (1), LOG (2), UNSIGNED (3, por defecto), TEXT (4), BINARY (5).
allowed_hosts		cadena	Lista de direcciones IP separadas por comas de los equipos permitidos para enviar datos para el elemento. Soportado para elementos TRAP y HTTP_AGENT.
units		cadena	Unidades del valor recibido (bps, B, etc.).
params		texto	Parámetros adicionales dependiendo del tipo de elemento (script ejecutado para elementos SSH y TELNET; consulta SQL para elementos ODBC; fórmula para elementos CALCULATED; script para elementos ITEM_TYPE_SCRIPT y ITEM_TYPE_BROWSER).
ipmi_sensor		cadena	Sensor IPMI. Soportado para elementos IPMI.
authtype		cadena	Tipo de autenticación. Soportado para elementos SSH y HTTP_AGENT. Valores posibles para elementos SSH:¹ PASSWORD (0, por defecto), PUBLIC_KEY (1). Valores posibles para elementos HTTP_AGENT:¹ NONE (0, por defecto), BASIC (1), NTLM (2).
username		cadena	(obligatorio para elementos SSH y TELNET) Nombre de usuario para autenticación. Soportado para elementos SIMPLE, ODBC, JMX y HTTP_AGENT. Cuando se usa para elementos JMX, también debe especificarse `password` (ver abajo) o ambos elementos deben dejarse en blanco.
password		cadena	(obligatorio para elementos SSH y TELNET) Contraseña para autenticación. Soportado para elementos SIMPLE, ODBC, JMX y HTTP_AGENT. Cuando se usa para elementos JMX, también debe especificarse `username` (ver arriba) o ambos elementos deben dejarse en blanco.
publickey		cadena	(obligatorio para elementos SSH) Nombre del archivo de clave pública.
privatekey		cadena	(obligatorio para elementos SSH) Nombre del archivo de clave privada.
description		texto	Descripción del elemento.
inventory_link		cadena	Campo de inventario del equipo que es rellenado por el elemento. Valores posibles:¹ NONE (0), ALIAS (4), etc. (ver Inventario de equipos para los campos soportados).
valuemap			Elemento raíz para mapas de valores del elemento.
	name	cadena	(obligatorio) Nombre del mapa de valores a usar para el elemento.
logtimefmt		cadena	Formato de la hora en las entradas de registro. Soportado para elementos de tipo de valor LOG.
preprocessing			Elemento raíz para el preprocesamiento de valores del elemento.
	step		Elemento raíz para pasos de preprocesamiento de valores de elementos de plantilla.
jmx_endpoint		cadena	Punto final JMX. Soportado para elementos JMX.
master_item			(obligatorio para elementos DEPENDENT) Elemento raíz para el elemento maestro del elemento dependiente.
	key	cadena	(obligatorio) Clave del elemento maestro del elemento dependiente.
timeout		cadena	Tiempo de espera de la solicitud de sondeo de datos del elemento. Soportado para la lista de tipos de elementos de Tiempos de espera.
url		cadena	(obligatorio para elementos HTTP_AGENT) Cadena de URL.
query_fields			Elemento raíz para parámetros de consulta. Soportado para elementos HTTP_AGENT.
	name	cadena	(obligatorio para elementos HTTP_AGENT) Nombre del parámetro de consulta.
	value	cadena	Valor del parámetro de consulta. Soportado para elementos HTTP_AGENT.
parameters			Elemento raíz para parámetros definidos por el usuario. Soportado para elementos ITEM_TYPE_SCRIPT y ITEM_TYPE_BROWSER.
	name	cadena	(obligatorio para elementos ITEM_TYPE_SCRIPT y ITEM_TYPE_BROWSER) Nombre del parámetro definido por el usuario.
	value	cadena	Valor del parámetro definido por el usuario. Soportado para elementos ITEM_TYPE_SCRIPT y ITEM_TYPE_BROWSER.
posts		cadena	Datos del cuerpo de la solicitud HTTP(S). Soportado para elementos HTTP_AGENT.
status_codes		cadena	Rangos de códigos de estado HTTP requeridos, separados por comas. Soportado para elementos HTTP_AGENT.
follow_redirects		cadena	Seguir redirecciones de respuesta al sondear datos. Soportado para elementos HTTP_AGENT. Valores posibles:¹ NO (0), YES (1, por defecto).
post_type		cadena	Tipo de cuerpo de datos de post. Soportado para elementos HTTP_AGENT. Valores posibles:¹ RAW (0, por defecto), JSON (2), XML (3).
http_proxy		cadena	Cadena de conexión proxy HTTP(S). Soportado para elementos HTTP_AGENT.
headers			Elemento raíz para cabeceras de solicitud HTTP(S). Soportado para elementos HTTP_AGENT.
	name	cadena	(obligatorio para elementos HTTP_AGENT) Nombre de la cabecera.
	value	cadena	(obligatorio para elementos HTTP_AGENT) Valor de la cabecera.
retrieve_mode		cadena	Qué parte de la respuesta debe almacenarse. Soportado para elementos HTTP_AGENT. Valores posibles:¹ BODY (0, por defecto), HEADERS (1), BOTH (2).
request_method		cadena	Tipo de método de solicitud. Soportado para elementos HTTP_AGENT. Valores posibles:¹ GET (0, por defecto), POST (1), PUT (2), HEAD (3).
output_format		cadena	Cómo procesar la respuesta. Soportado para elementos HTTP_AGENT. Valores posibles:¹ RAW (0, por defecto), JSON (1).
allow_traps		cadena	Permitir rellenar el valor de forma similar al elemento trapper. Soportado para elementos HTTP_AGENT. Valores posibles:¹ NO (0, por defecto), YES (1).
ssl_cert_file		cadena	Ruta del archivo de clave pública SSL. Soportado para elementos HTTP_AGENT.
ssl_key_file		cadena	Ruta del archivo de clave privada SSL. Soportado para elementos HTTP_AGENT.
ssl_key_password		cadena	Contraseña para el archivo de clave SSL. Soportado para elementos HTTP_AGENT.
verify_peer		cadena	Si se debe validar que el certificado del equipo es auténtico. Soportado para elementos HTTP_AGENT. Valores posibles:¹ NO (0, por defecto), YES (1).
verify_host		cadena	Si se debe validar que el nombre del equipo para la conexión coincide con el del certificado del equipo. Soportado para elementos HTTP_AGENT. Valores posibles:¹ NO (0, por defecto), YES (1).
tags			Elemento raíz para etiquetas del elemento.
	tag	cadena	(obligatorio) Nombre de la etiqueta.
	value	cadena	Valor de la etiqueta.
triggers			Elemento raíz para disparadores de elementos de plantilla.

Véase también: Objeto elemento (consulte la propiedad relevante con el mismo nombre).

Pasos de preprocesamiento de valores de elementos de plantilla

zabbix_export:
         (...)
         templates:
           (...)
             items:
               (...)
               - uuid: 58818005e76d46dda14d6592f601ab00
                 (...)
                 preprocessing:
                   - type: JSONPATH
                     parameters:
                       - $.length()
                   - type: DISCARD_UNCHANGED_HEARTBEAT
                     parameters:
                       - 12h
                 (...)

Elemento		Tipo	Descripción
type		cadena	(obligatorio) El tipo de paso de preprocesamiento del valor del elemento. Valores posibles:¹ MULTIPLIER (1), RTRIM (2), LTRIM (3), TRIM (4), REGEX (5), BOOL_TO_DECIMAL (6), OCTAL_TO_DECIMAL (7), HEX_TO_DECIMAL (8), SIMPLE_CHANGE (9, calculado: valor recibido - valor anterior), CHANGE_PER_SECOND (10, calculado: (valor recibido - valor anterior)/(hora actual - hora de la última comprobación)), XMLPATH (11), JSONPATH (12), IN_RANGE (13), MATCHES_REGEX (14), NOT_MATCHES_REGEX (15), CHECK_JSON_ERROR (16), CHECK_XML_ERROR (17), CHECK_REGEX_ERROR (18), DISCARD_UNCHANGED (19), DISCARD_UNCHANGED_HEARTBEAT (20), JAVASCRIPT (21), PROMETHEUS_PATTERN (22), PROMETHEUS_TO_JSON (23), CSV_TO_JSON (24), STR_REPLACE (25), CHECK_NOT_SUPPORTED (26), XML_TO_JSON (27), SNMP_WALK_VALUE (28), SNMP_WALK_TO_JSON (29), SNMP_GET_VALUE (30).
parameters			(obligatorio) Elemento raíz para los parámetros del paso de preprocesamiento del valor del elemento.
	parameter	cadena	Parámetro individual del paso de preprocesamiento del valor del elemento.
error_handler		cadena	Tipo de acción utilizada en caso de fallo del paso de preprocesamiento. Valores posibles:¹ ORIGINAL_ERROR (0, por defecto), DISCARD_VALUE (1), CUSTOM_VALUE (2), CUSTOM_ERROR (3).
error_handler_params		cadena	Parámetros del gestor de errores.

Ver también: Objeto de preprocesamiento de elemento (consulte la propiedad relevante con el mismo nombre).

Disparadores de elementos de plantilla

zabbix_export:
         (...)
         templates:
           (...)
             items:
               (...)
               - uuid: 58818005e76d46dda14d6592f601ab00
                 (...)
                 triggers:
                   - uuid: b950c306394f4b3c902060a8273cbcde
                     expression: 'change(/Linux by Zabbix agent/system.sw.packages.get)<>0'
                     name: 'Linux: El número de paquetes instalados ha cambiado'
                     priority: WARNING
                     manual_close: 'YES'
                     tags:
                       - tag: scope
                         value: notice
               (...)
               - uuid: 403cebed115441369e94d35d070ca7b8
                 (...)
                 triggers:
                   - uuid: cfd395b1cde74ef18a5e5f840bd5142a
                     expression: 'min(/Linux by Zabbix agent/vm.memory.utilization,5m)>{$MEMORY.UTIL.MAX}'
                     name: 'Linux: Alta utilización de memoria'
                     event_name: 'Linux: Alta utilización de memoria (>{$MEMORY.UTIL.MAX}% durante 5m)'
                     priority: AVERAGE
                     description: 'El sistema se está quedando sin memoria libre.'
                     dependencies:
                       - name: 'Linux: Falta de memoria disponible'
                         expression: 'max(/Linux by Zabbix agent/vm.memory.size[available],5m)<{$MEMORY.AVAILABLE.MIN} and last(/Linux by Zabbix agent/vm.memory.size[total])>0'
                     tags:
                       - tag: scope
                         value: capacity
                       - tag: scope
                         value: performance
               (...)

Elemento		Tipo	Descripción
uuid		cadena	(requerido) Identificador único para este disparador.
expression		cadena	(requerido) Expresión del disparador.
recovery_mode		cadena	Base para generar eventos OK. Valores posibles:¹ EXPRESSION (0, por defecto), RECOVERY_EXPRESSION (1), NONE (2).
recovery_expression		cadena	Expresión de recuperación del disparador.
correlation_mode		cadena	Modo de correlación (sin correlación de eventos o correlación de eventos por etiqueta). Valores posibles:¹ DISABLED (0, por defecto), TAG_VALUE (1).
correlation_tag		cadena	El nombre de la etiqueta que se utilizará para la correlación de eventos.
name		cadena	(requerido) Nombre del disparador.
event_name		cadena	Nombre del evento.
opdata		cadena	Datos operativos.
url_name		cadena	Etiqueta para la URL asociada al disparador.
url		cadena	URL asociada al disparador.
status		cadena	Estado del disparador. Valores posibles:¹ ENABLED (0, por defecto), DISABLED (1).
priority		cadena	Severidad del disparador. Valores posibles:¹ NOT_CLASSIFIED (0, por defecto), INFO (1), WARNING (2), AVERAGE (3), HIGH (4), DISASTER (5).
description		texto	Descripción del disparador.
type		cadena	Tipo de generación de eventos (evento de problema único o múltiples eventos de problema). Valores posibles:¹ SINGLE (0, por defecto), MULTIPLE (1).
manual_close		cadena	Cierre manual de eventos de problema. Valores posibles:¹ NO (0, por defecto), YES (1).
dependencies			Elemento raíz para dependencias.
	name	cadena	(requerido) Nombre del disparador de dependencia.
	expression	cadena	(requerido) Expresión del disparador de dependencia.
	recovery_expression	cadena	Expresión de recuperación del disparador de dependencia.
tags			Elemento raíz para etiquetas del disparador.
	tag	cadena	(requerido) Nombre de la etiqueta.
	value	cadena	Valor de la etiqueta.

Consulte también: Objeto disparador (consulte la propiedad relevante con el mismo nombre).

Reglas de descubrimiento de bajo nivel de la plantilla

zabbix_export:
         (...)
         templates:
           (...)
             discovery_rules:
               - uuid: acfdea9c46ef48c68e6636f43b8f96a2
                 name: 'Descubrimiento de interfaz de red'
                 key: net.if.discovery
                 delay: 1h
                 filter: (ver tabla abajo)
                 description: 'El descubrimiento de interfaces de red.'
                 item_prototypes: (ver tabla abajo)
                 trigger_prototypes: (ver tabla abajo)
                 graph_prototypes: (ver tabla abajo)
               (...)

La mayoría de los elementos de las reglas de descubrimiento de bajo nivel de la plantilla son los mismos que para los elementos de la plantilla. La siguiente tabla describe aquellos elementos que difieren de los elementos de la plantilla.

Elemento		Tipo	Descripción
type		string	Tipo de elemento. Valores posibles:¹ ZABBIX_PASSIVE (0, por defecto), TRAP (2), SIMPLE (3), INTERNAL (5), ZABBIX_ACTIVE (7), EXTERNAL (10), ODBC (11), IPMI (12), SSH (13), TELNET (14), JMX (16), DEPENDENT (18), HTTP_AGENT (19), SNMP_AGENT (20), ITEM_TYPE_SCRIPT (21), ITEM_TYPE_BROWSER (22).
key		string	(requerido) Clave de la regla de descubrimiento de bajo nivel.
filter			Elemento raíz para filtros de reglas de descubrimiento de bajo nivel de la plantilla.
lifetime		string	Período de tiempo (usando segundos, sufijo de tiempo, o macro de usuario), después del cual se eliminarán los recursos ya no descubiertos. Por defecto: 7d.
lifetime_type		string	Escenario para eliminar recursos LLD perdidos. Valores posibles: DELETE_NEVER, DELETE_IMMEDIATELY, DELETE_AFTER.
enabled_lifetime		string	Período de tiempo (usando segundos, sufijo de tiempo, o macro de usuario), después del cual los recursos ya no descubiertos serán deshabilitados.
enabled_lifetime_type		string	Escenario para deshabilitar recursos LLD perdidos. Valores posibles: DISABLE_NEVER, DISABLE_IMMEDIATELY, DISABLE_AFTER.
item_prototypes			Elemento raíz para los elementos prototipo de la plantilla, que son los mismos que para los elementos de la plantilla.
trigger_prototypes			Elemento raíz para los elementos prototipo de disparadores de la plantilla, que son los mismos que para los disparadores de elementos de la plantilla.
graph_prototypes			Elemento raíz para los elementos prototipo de gráficos de la plantilla, que son los mismos que para los gráficos de host.
host_prototypes			Elemento raíz para los elementos prototipo de host de la plantilla, que son los mismos que para los hosts.
master_item		string	(requerido para reglas DEPENDENT) Elemento raíz para el elemento maestro de la regla dependiente.
lld_macro_paths			Elemento raíz para las rutas de macros de la regla de descubrimiento de bajo nivel.
	lld_macro	string	(requerido) Nombre de la macro de la regla de descubrimiento de bajo nivel.
	path	string	(requerido) Selector para el valor, que se asignará a la macro correspondiente.
preprocessing			Elemento raíz para el preprocesamiento del valor de la regla de descubrimiento de bajo nivel.
	step		Elemento raíz para los elementos de paso de preprocesamiento del valor de la regla de descubrimiento de bajo nivel, que son los mismos que para los pasos de preprocesamiento del valor del elemento de la plantilla, excepto con menos valores posibles. Véase también: Objeto de preprocesamiento de regla LLD.
overrides			Elemento raíz para las reglas de sobrescritura de la regla de descubrimiento de bajo nivel.
	name	string	(requerido) Nombre único de la sobrescritura.
	step	string	(requerido) Número de orden único de la sobrescritura.
	stop	string	Detener el procesamiento de las siguientes sobrescrituras si coincide.
	filter		Elemento raíz para los elementos de filtro de la regla de sobrescritura de la regla de descubrimiento de bajo nivel de la plantilla, que son los mismos que para los filtros de reglas de descubrimiento de bajo nivel de la plantilla.
	operations		Elemento raíz para las operaciones de sobrescritura de la regla de descubrimiento de bajo nivel de la plantilla.

Véase también: Objeto de regla LLD (consulte la propiedad relevante con el mismo nombre).

Filtros de reglas de descubrimiento de bajo nivel de la plantilla

zabbix_export:
         (...)
         templates:
           (...)
             discovery_rules:
               - uuid: acfdea9c46ef48c68e6636f43b8f96a2
                 (...)
                 filter:
                   evaltype: AND
                   conditions:
                     - macro: '{#IFNAME}'
                       value: '{$NET.IF.IFNAME.MATCHES}'
                     - macro: '{#IFNAME}'
                       value: '{$NET.IF.IFNAME.NOT_MATCHES}'
                       operator: NOT_MATCHES_REGEX
                 (...)
               - uuid: 2bbdc79f082d4c618e01bec625e9c90a
                 (...)
                 filter:
                   evaltype: AND
                   conditions:
                     - macro: '{#DEVNAME}'
                       value: '{$VFS.DEV.DEVNAME.MATCHES}'
                     - macro: '{#DEVNAME}'
                       value: '{$VFS.DEV.DEVNAME.NOT_MATCHES}'
                       operator: NOT_MATCHES_REGEX
                     - macro: '{#DEVTYPE}'
                       value: disk
                 (...)

Elemento		Tipo	Descripción
evaltype		cadena	Sobrescribe el método de evaluación de la condición del filtro. Valores posibles:¹ AND_OR (0, por defecto), AND (1), OR (2), FORMULA (3).
formula		cadena	Fórmula de cálculo personalizada para las condiciones del filtro.
conditions			Elemento raíz para las condiciones del filtro.
	macro	cadena	(requerido) El nombre de la macro de descubrimiento de bajo nivel sobre la que realizar la comprobación.
	value	cadena	Valor con el que comparar.
	operator	cadena	Operador de condición. Valores posibles:¹ MATCHES_REGEX (8, por defecto), NOT_MATCHES_REGEX (9).
	formulaid	cadena	(requerido) ID único arbitrario que se utiliza para hacer referencia a una condición desde la expresión personalizada. Solo puede contener letras mayúsculas. El ID debe ser definido por el usuario al modificar las condiciones del filtro, pero se generará de nuevo al solicitarlas posteriormente.

Consulte también: Objeto de filtro de regla LLD (consulte la propiedad relevante con el mismo nombre).

Operaciones de reemplazo de reglas de descubrimiento de bajo nivel de plantilla

Elemento		Tipo	Descripción
operationobject		cadena	Objeto al que se aplica la operación. Valores posibles:¹ ITEM_PROTOTYPE (0), TRIGGER_PROTOTYPE (1), GRAPH_PROTOTYPE (2), HOST_PROTOTYPE (3).
operator		cadena	Operador de condición de reemplazo. Valores posibles:¹ EQUAL (1), NOT_EQUAL (2), LIKE (3), NOT_LIKE (4), REGEXP (5) , NOT_REGEXP (6).
value		cadena	Una expresión regular o una cadena para el operador de condición de reemplazo.
status		cadena	Estado del objeto tras la operación de reemplazo.
discover		cadena	Si el objeto se agrega como resultado del descubrimiento.
delay		cadena	Intervalo de actualización establecido para el prototipo de la métrica tras la operación de reemplazo.
history		cadena	Período de almacenamiento del historial establecido para el prototipo de la métrica en la operación de reemplazo.
trends		cadena	Período de almacenamiento de tendencias establecido para el prototipo de la métrica tras la operación de reemplazo.
severity		cadena	La gravedad del prototipo de iniciador se establece en la operación de reemplazo.
tags			Elemento raíz de las etiquetas establecidas para el objeto en la operación de reemplazo.
	tag	cadena	(obligatorio) Nombre de etiqueta.
	value	cadena	Valor de etiqueta.
templates			Elemento raíz para las plantillas vinculadas al prototipo de equipo tras la operación de reemplazo.
	name	cadena	(obligatorio) Nombre de la plantilla.
inventory_mode		cadena	Modo de inventario del prototipo del equipo establecido en la operación de reemplazo.

Consulte también: objeto de operación de anulación de regla LLD (consulte la propiedad relevante con un nombre coincidente).

Escenarios web de plantilla

Elemento		Tipo	Descripción
uuid		cadena	(obligatorio) Identificador único para este escenario web.
name		cadena	(obligatorio) Nombre del escenario web.
delay		cadena	Frecuencia (usando segundos, sufijo de tiempo, o macro de usuario) de ejecución del escenario web. Predeterminado: 1m.
attempts		entero	El número de intentos para ejecutar los pasos del escenario web. Valores posibles:¹ 1-10 (predeterminado: 1).
agent		cadena	Agente cliente. Zabbix pretenderá ser el navegador seleccionado. Esto es útil cuando un sitio web devuelve contenido diferente para diferentes navegadores. Predeterminado: Zabbix.
http_proxy		cadena	Proxy que será utilizado por el escenario web dado como: `http://[nombre de usuario[:contraseña]@]proxy.example.com[:puerto]`
variables			Elemento raíz para las variables del escenario web que pueden usarse en los pasos del escenario.
	name	cadena	(obligatorio) Nombre de la variable.
	value	texto	(obligatorio) Valor de la variable.
headers			Elemento raíz para que se envíen los encabezados HTTP al realizar una solicitud. Los encabezados deben enumerarse utilizando la misma sintaxis que aparecerían en el protocolo HTTP.
	name	cadena	(obligatorio) Nombre del encabezado.
	value	texto	(obligatorio) Valor del encabezado.
status		cadena	Estado del escenario web. Valores posibles:¹ HABILITADO (0, predeterminado), DESHABILITADO (1).
authentication		cadena	Método de autenticación. Valores posibles:¹ NINGUNO (0, predeterminado), BÁSICO (1), NTLM (2).
http_user		cadena	Nombre de usuario utilizado para la autenticación BÁSICA (HTTP) o NTLM.
http_password		cadena	Contraseña utilizada para la autenticación BÁSICA (HTTP) o NTLM.
verify_peer		cadena	Verifica el certificado SSL del servidor web. Valores posibles:¹ NO (0, predeterminado), SÍ (1).
verify_host		cadena	Verifique que el campo Nombre común o el campo Nombre alternativo del sujeto del certificado del servidor web coincida. Valores posibles:¹ NO (0 , predeterminado), SÍ (1).
ssl_cert_file		cadena	Nombre del archivo de certificado SSL utilizado para la autenticación del cliente (debe estar en formato PEM).
ssl_key_file		cadena	Nombre del archivo de clave privada SSL utilizado para la autenticación del cliente (debe estar en formato PEM).
ssl_key_password		cadena	Contraseña del archivo de clave privada SSL.
pasos			(obligatorio) Elemento raíz para pasos del escenario web de la plantilla.
tags			Elemento raíz para etiquetas de escenarios web.
	tag	cadena	(obligatorio) Nombre de etiqueta.
	value	cadena	Valor de etiqueta.

Consulte también: Objeto de escenario web (consulte la propiedad relevante con un nombre coincidente).

Pasos del escenario web de la plantilla

Elemento		Tipo	Descripción
name		cadena	(obligatorio) Nombre del paso del escenario web.
url		string	(obligatorio) URL para monitoreo.
query_fields			Elemento raíz para los parámetros de consulta (una serie de campos HTTP que se agregarán a la URL al realizar una solicitud).
	name	cadena	(obligatorio) Nombre del parámetro de consulta.
	value	cadena	Valor del parámetro de consulta.
posts			Elemento raíz para variables HTTP POST (una cadena (datos de publicación sin procesar) o una matriz de campos HTTP (datos de campo de formulario)).
	name	cadena	(obligatorio) Nombre del campo de publicación.
	value	cadena	(obligatorio) Valor del campo de publicación.
variables			Elemento raíz de las variables de nivel de paso (macros) que deben aplicarse después de este paso. Si el valor de la variable tiene un prefijo 'regex:', entonces su valor se extrae de los datos devueltos por este paso de acuerdo con el procedimiento habitual. patrón de expresión que sigue el prefijo 'regex:'
	name	cadena	(obligatorio) Nombre de la variable.
	value	texto	(obligatorio) Valor de la variable.
headers			Elemento raíz para los encabezados HTTP que se enviarán al realizar una solicitud.
	name	cadena	(obligatorio) Nombre del encabezado.
	value	texto	(obligatorio) Valor del encabezado.
follow_redirects		cadena	Seguir redirecciones HTTP. Valores posibles:¹ NO (0), SÍ (1, predeterminado).
retrieve_mode		cadena	Modo de recuperación de respuesta HTTP. Valores posibles:¹ BODY (0, predeterminado), HEADERS (1), BOTH (2).
timeout		cadena	Tiempo de espera (usando segundos, sufijo de tiempo, o macro de usuario) de ejecución del paso.< br>Predeterminado: 15 s.
required		cadena	Texto que debe estar presente en la respuesta (ignorado si está vacío).
status_codes		cadena	Una lista delimitada por comas de códigos de estado HTTP aceptados (por ejemplo, `200-201,210-299`; ignorado si está vacío).

Consulte también: Objeto de paso de escenario web (consulte la propiedad relevante con un nombre coincidente).

Configuración de macro de plantilla

zabbix_export:
         (...)
         templates:
           - uuid: f8f7908280354f2abeed07dc788c3747
             (...)
             macros:
               - macro: '{$AGENT.TIMEOUT}'
                 (...)
                 config:
                   type: TEXT
                   priority: '1'
                   label: 'Segundos desde la última vez que se vio el agente Zabbix'
                   description: 'Tiempo de espera tras el cual el agente se considera no disponible.'
               - macro: '{$CPU.UTIL.CRIT}'
                 (...)
                 config:
                   type: TEXT
                   priority: '2'
                   section_name: Umbrales
                   label: 'Umbral de utilización de CPU expresado'
                   description: 'Umbral crítico de utilización de CPU expresado en %. En el rango de 0 a 100 inclusive.'
                   regex: '^-?([0-9]+|(([0-9]+)\.([0-9]+)))$'
               (...)
               - macro: '{$IFCONTROL}'
                 (...)
                 config:
                   type: CHECKBOX
                   priority: '19'
                   label: 'Control de interfaces'
                   description: 'Disparar un disparador cuando el estado operativo de la interfaz cambie a "Enlace caído".'
                   options:
                     - checked: '1'
                       unchecked: '0'
               (...)

Elemento		Tipo	Descripción
type		cadena	(obligatorio) Tipo de campo de entrada de macro. Valores posibles:¹ NOCONF (0), TEXT (1), LIST (2), CHECKBOX (3).
priority		cadena	Posición de la macro en la lista de macros.
section_name		cadena	Etiqueta de la sección plegable donde se agrupa la macro.
label		cadena	(obligatorio para macros TEXT, LIST, CHECKBOX) Etiqueta de la macro.
description		texto	Texto de ayuda de la macro. Soporta formato Markdown.
required		cadena	Marca la macro como obligatoria. Valores posibles:¹ NO (0), YES (1). Soportado para macros TEXT y LIST.
regex		cadena	Expresión regular para validar la entrada del usuario en un campo de texto. Soportado para macros TEXT.
options			Elemento raíz para los elementos de LIST o valores de CHECKBOX.
	value	cadena	(obligatorio para macros LIST) Valor del elemento de LIST.
	text	cadena	(obligatorio para macros LIST) Texto del elemento de LIST.
	checked	cadena	(obligatorio para macros CHECKBOX) Valor que representa un estado marcado. Valores posibles:¹ 0 (falso), 1 (verdadero). Soportado para macros CHECKBOX.
	unchecked	cadena	(obligatorio para macros CHECKBOX) Valor que representa un estado desmarcado. Valores posibles:¹ 0 (falso), 1 (verdadero). Soportado para macros CHECKBOX.

Consulte también: Objeto de configuración de macro (consulte la propiedad relevante con el mismo nombre).

Plantillas de tablero

zabbix_export:
         (...)
         templates:
           (...)
             dashboards:
               - uuid: c689ad3115fd46a4b927d1f70ee2e5a4
                 name: Filesystems
                 pages:
                   - name: Overview
                     widgets: (ver tabla abajo)
               (...)

Elemento		Tipo	Descripción
uuid		cadena	(requerido) Identificador único para este tablero.
name		cadena	(requerido) Nombre de la plantilla de tablero.
display period		entero	Período de visualización de las páginas del tablero.
auto_start		cadena	Inicio automático de la presentación de diapositivas. Valores posibles:¹ NO (0), SÍ (1, por defecto).
pages			Elemento raíz para las páginas de la plantilla de tablero.
	name	cadena	Nombre de la página.
	display period	entero	Período de visualización de la página.
	sortorder	entero	Orden de clasificación de la página.
widgets			Elemento raíz para los widgets de la plantilla de tablero.

Véase también: Objeto plantilla de tablero (consulte la propiedad correspondiente con el mismo nombre).

Widgets del panel de la plantilla

zabbix_export:
         (...)
         templates:
           (...)
             dashboards:
               - uuid: c689ad3115fd46a4b927d1f70ee2e5a4
                 name: Sistemas de archivos
                 pages:
                   - name: Resumen
                     widgets:
                       - type: graphprototype
                         width: '72'
                         height: '5'
                         fields:
                           - type: INTEGER
                             name: columns
                             value: '3'
                           - type: GRAPH_PROTOTYPE
                             name: graphid.0
                             value:
                               host: 'Linux por agente Zabbix'
                               name: 'FS [{#FSTYPE}({#FSNAME})]: Gráfico de utilización de espacio (relativo al total)'
                           - type: STRING
                             name: reference
                             value: AAAEB
                       - type: graphprototype
                         'y': '5'
                         width: '72'
                         height: '5'
                         fields:
                           - type: INTEGER
                             name: columns
                             value: '1'
                           - type: GRAPH_PROTOTYPE
                             name: graphid.0
                             value:
                               host: 'Linux por agente Zabbix'
                               name: 'FS [{#FSTYPE}({#FSNAME})]: Gráfico de uso de espacio, en % (relativo al máximo disponible)'
                           - type: STRING
                             name: reference
                             value: AAAEC
               (...)

Elemento		Tipo	Descripción
type		string	(requerido) Tipo de widget.
name		string	Nombre del widget.
x		integer	Posición horizontal desde el lado izquierdo del panel de la plantilla. Valores posibles:¹ 0-71.
y		integer	Posición vertical desde la parte superior del panel de la plantilla. Valores posibles:¹ 0-63.
width		integer	Ancho del widget. Valores posibles:¹ 1-72.
height		integer	Alto del widget. Valores posibles:¹ 1-64.
hide_header		string	Ocultar el encabezado del widget. Valores posibles:¹ NO (0, por defecto), YES (1).
fields			Elemento raíz para los campos del widget del panel de la plantilla.
	type	string	(requerido) Tipo de campo del widget. Valores posibles:¹ INTEGER (0), STRING (1), ITEM (4), ITEM_PROTOTYPE (5), GRAPH (6), GRAPH_PROTOTYPE (7), MAP (8), SERVICE (9), SLA (10), USER (11), ACTION (12), MEDIA_TYPE (13).
	name	string	(requerido) Nombre del campo del widget.
	value	mixed	(requerido) Valor del campo del widget, dependiendo del tipo de campo.

Consulte también: Objeto widget del panel de la plantilla (consulte la propiedad relevante con el nombre correspondiente).

Mapas de valores de la plantilla

zabbix_export:
         (...)
         templates:
           (...)
             valuemaps:
               - uuid: 8c048c6cca8248f2860c208e8db0f59e
                 name: ifOperStatus
                 mappings:
                   - value: '0'
                     newvalue: unknown
                   - value: '1'
                     newvalue: notpresent
                   - value: '2'
                     newvalue: down
                   - value: '3'
                     newvalue: lowerlayerdown
                   - value: '4'
                     newvalue: testing
                   - value: '5'
                     newvalue: dormant
                   - value: '6'
                     newvalue: up
               (...)

Elemento		Tipo	Descripción
uuid		cadena	(requerido) Identificador único para este mapa de valores.
name		cadena	(requerido) Nombre del mapa de valores.
mapping			Elemento raíz para las asignaciones.
	type	cadena	Tipo de coincidencia de asignación. Valores posibles:¹ EQUAL (0, por defecto), GREATER_OR_EQUAL (2), LESS_OR_EQUAL (3), IN_RANGE (4), REGEXP (5), DEFAULT (6).
	value	cadena	Valor original.
	newvalue	cadena	(requerido) Valor al que se asigna el valor original.

Véase también: Objeto mapa de valores (consulte la propiedad correspondiente con el mismo nombre).

Notas al pie

¹ Los valores enteros de API entre paréntesis, por ejemplo, HABILITADO (0), se mencionan solo como referencia. Para obtener más información, consulte la página del objeto API vinculado en la entrada de la tabla o al final de cada sección.

Documentation