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 plantillas contiene:

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

Exportar

Para exportar plantillas, haga lo siguiente:

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

Dependiendo del formato seleccionado, las plantillas se exportan a un archivo local con un nombre por defecto:

zabbix_export_templates.yaml - en exportación YAML (opción por defecto para exportar);
zabbix_export_templates.xml - en exportación XML;
zabbix_export_templates.json - en exportación JSON.

Importar

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 Todos, 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 los que faltan	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 los que faltan para Vinculación de plantilla, la vinculación de plantilla actual que no esté presente en el archivo de importación será desvinculada. Las entidades (métricas, disparadores, gráficos, etc.) heredadas de las plantillas desvinculadas no se eliminarán (a menos que también se seleccione la opción Eliminar los que faltan 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 de la plantilla 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 Actualizado resalta todos los cambios realizados en los elementos existentes de la plantilla. La sección Añadido 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. Se mostrará un mensaje de éxito o error de la importación en la interfaz web.

Formato de exportación

Cuando se exporta una plantilla, Zabbix genera un formato estructurado en YAML, JSON o XML. La exportación incluye elementos de la plantilla, como metadatos de la plantilla, métricas, 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. Los ejemplos utilizan la plantilla Linux por Zabbix agent.

Un paréntesis (...) indica elementos omitidos 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: '8.0'
         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		string	(requerido) Versión de exportación.
template_groups			(requerido) Elemento raíz para los grupos de plantillas.
	uuid	string	(requerido) Identificador único para este grupo de plantillas.
	name	string	(requerido) Nombre del grupo de plantillas.
host_groups			Elemento raíz para los grupos de equipos que son utilizados por prototipos de equipos.
	uuid	string	(requerido) Identificador único para este grupo de equipos.
	name	string	(requerido) 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 métricas 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 8.0 o superior. (...)
             wizard_ready: 'YES'
             readme: |
               ## Descripción general
               
               Esta es una plantilla oficial de Linux. Requiere el agente Zabbix 8.0 o superior. (...)
             vendor:
               name: Zabbix
               version: 8.0-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 uso de CPU expresado en %.'
                 config: (ver tabla abajo)
               (...)
             dashboards: (ver tabla abajo)
             valuemaps: (ver tabla abajo)
           (...)

Elemento		Tipo	Descripción
uuid		string	(obligatorio) Identificador único para esta plantilla.
template		string	(obligatorio) Nombre único de la plantilla.
name		string	Nombre visible de la plantilla.
description		text	Descripción de la plantilla.
wizard_ready		text	Indica si la plantilla está disponible para su selección en el Asistente de equipos. Valores posibles:¹ NO (0, por defecto), YES (1). Ver también: Objeto plantilla (`wizard_ready`).
readme		text	Instrucciones de configuración específicas de la plantilla que se mostrarán en el Asistente de equipos. Soporta formato Markdown.
vendor			Elemento raíz para el proveedor de la plantilla (presente si la plantilla exportada contiene datos del proveedor).
	name	string	(obligatorio) Nombre del proveedor de la plantilla.
	version	string	(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, 8.0-0, 8.0-3.
templates			Elemento raíz para plantillas enlazadas.
	name	string	(obligatorio) Nombre de la plantilla.
groups			Elemento raíz para grupos de plantillas.
	name	string	(obligatorio) Nombre del grupo de plantillas.
items			Elemento raíz para métricas de plantilla.
discovery_rules			Elemento raíz para reglas de descubrimiento de bajo nivel de plantilla.
httptests			Elemento raíz para escenarios web de plantilla.
tags			Elemento raíz para etiquetas de plantilla.
	tag	string	(obligatorio) Nombre de la etiqueta.
	value	string	Valor de la etiqueta.
macros			Elemento raíz para macros de usuario de plantilla.
	macro	string	(obligatorio) Nombre de la macro de usuario.
	type	string	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	string	Valor de la macro de usuario.
	description	string	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 equipos.
dashboards			Elemento raíz para cuadros de mando de plantilla.
valuemaps			Elemento raíz para mapas de valores de plantilla.

Métricas de la plantilla

zabbix_export:
         (...)
         templates:
           (...)
             items:
               - uuid: f94f9f4699e94c369e6c98b2a2f485ce
                 name: 'Ping del agente Zabbix'
                 key: agent.ping
                 description: 'El agente siempre devuelve "1" para esta métrica. Puede utilizarse 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		string	(obligatorio) Identificador único para esta métrica.
name		string	(obligatorio) Nombre de la métrica.
type		string	Tipo de métrica. 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		string	(obligatorio para métricas SNMP_AGENT) OID SNMP.
key		string	(obligatorio) Clave de la métrica.
delay		string	Intervalo de actualización de la métrica. Por defecto: 1m. El valor siempre será 0 para métricas TRAP.
history		string	Periodo de tiempo (usando sufijo de tiempo, macro de usuario o macro LLD) durante el cual se almacenarán los datos históricos. Por defecto: 31d.
trends		string	Periodo de tiempo (usando sufijo de tiempo, macro de usuario o macro LLD) durante el cual se almacenarán los datos de tendencias. Por defecto: 365d.
status		string	Estado de la métrica. Valores posibles:¹ ENABLED (0, por defecto), DISABLED (1).
value_type		string	Tipo de valor recibido. Valores posibles:¹ FLOAT (0), CHAR (1), LOG (2), UNSIGNED (3, por defecto), TEXT (4), BINARY (5).
allowed_hosts		string	Lista de direcciones IP separadas por comas de los equipos autorizados a enviar datos para la métrica. Soportado para métricas TRAP y HTTP_AGENT.
units		string	Unidades del valor recibido (bps, B, etc.).
params		text	Parámetros adicionales dependiendo del tipo de métrica (script ejecutado para métricas SSH y TELNET; consulta SQL para métricas ODBC; fórmula para métricas CALCULATED; script para métricas ITEM_TYPE_SCRIPT y ITEM_TYPE_BROWSER).
ipmi_sensor		string	Sensor IPMI. Soportado para métricas IPMI.
authtype		string	Tipo de autenticación. Soportado para métricas SSH y HTTP_AGENT. Valores posibles para métricas SSH:¹ PASSWORD (0, por defecto), PUBLIC_KEY (1). Valores posibles para métricas HTTP_AGENT:¹ NONE (0, por defecto), BASIC (1), NTLM (2).
username		string	(obligatorio para métricas SSH y TELNET) Nombre de usuario para autenticación. Soportado para métricas SIMPLE, ODBC, JMX y HTTP_AGENT. Cuando se use para métricas JMX, también debe especificarse `password` (ver abajo) o ambos elementos deben dejarse en blanco.
password		string	(obligatorio para métricas SSH y TELNET) Contraseña para autenticación. Soportado para métricas SIMPLE, ODBC, JMX y HTTP_AGENT. Cuando se use para métricas JMX, también debe especificarse `username` (ver arriba) o ambos elementos deben dejarse en blanco.
publickey		string	(obligatorio para métricas SSH) Nombre del archivo de clave pública.
privatekey		string	(obligatorio para métricas SSH) Nombre del archivo de clave privada.
description		text	Descripción de la métrica.
inventory_link		string	Campo de inventario del equipo que se rellena con la métrica. Valores posibles:¹ NONE (0), ALIAS (4), etc. (ver Inventario de equipos para los campos soportados).
valuemap			Elemento raíz para los mapas de valores de la métrica.
	name	string	(obligatorio) Nombre del mapa de valores a utilizar para la métrica.
logtimefmt		string	Formato de la hora en las entradas de registro. Soportado para métricas de tipo de valor LOG.
preprocessing			Elemento raíz para el preprocesamiento de valores de la métrica.
	step		Elemento raíz para los pasos de preprocesamiento de valores de métricas de plantilla.
jmx_endpoint		string	Endpoint JMX. Soportado para métricas JMX.
master_item			(obligatorio para métricas DEPENDENT) Elemento raíz para la métrica principal de la métrica dependiente.
	key	string	(obligatorio) Clave de la métrica principal de la métrica dependiente.
timeout		string	Tiempo de espera de la solicitud de sondeo de datos de la métrica. Soportado para la lista de tipos de métricas con timeouts.
url		string	(obligatorio para métricas HTTP_AGENT) Cadena de URL.
query_fields			Elemento raíz para los parámetros de consulta. Soportado para métricas HTTP_AGENT.
	name	string	(obligatorio para métricas HTTP_AGENT) Nombre del parámetro de consulta.
	value	string	Valor del parámetro de consulta. Soportado para métricas HTTP_AGENT.
parameters			Elemento raíz para los parámetros definidos por el usuario. Soportado para métricas ITEM_TYPE_SCRIPT y ITEM_TYPE_BROWSER.
	name	string	(obligatorio para métricas ITEM_TYPE_SCRIPT y ITEM_TYPE_BROWSER) Nombre del parámetro definido por el usuario.
	value	string	Valor del parámetro definido por el usuario. Soportado para métricas ITEM_TYPE_SCRIPT y ITEM_TYPE_BROWSER.
posts		string	Datos del cuerpo de la solicitud HTTP(S). Soportado para métricas HTTP_AGENT.
status_codes		string	Rangos de códigos de estado HTTP requeridos, separados por comas. Soportado para métricas HTTP_AGENT.
follow_redirects		string	Seguir redirecciones de respuesta al sondear datos. Soportado para métricas HTTP_AGENT. Valores posibles:¹ NO (0), YES (1, por defecto).
post_type		string	Tipo de cuerpo de datos post. Soportado para métricas HTTP_AGENT. Valores posibles:¹ RAW (0, por defecto), JSON (2), XML (3).
http_proxy		string	Cadena de conexión de proxy HTTP(S). Soportado para métricas HTTP_AGENT.
headers			Elemento raíz para las cabeceras de la solicitud HTTP(S). Soportado para métricas HTTP_AGENT.
	name	string	(obligatorio para métricas HTTP_AGENT) Nombre de la cabecera.
	value	string	(obligatorio para métricas HTTP_AGENT) Valor de la cabecera.
retrieve_mode		string	Qué parte de la respuesta debe almacenarse. Soportado para métricas HTTP_AGENT. Valores posibles:¹ BODY (0, por defecto), HEADERS (1), BOTH (2).
request_method		string	Tipo de método de solicitud. Soportado para métricas HTTP_AGENT. Valores posibles:¹ GET (0, por defecto), POST (1), PUT (2), HEAD (3).
output_format		string	Cómo procesar la respuesta. Soportado para métricas HTTP_AGENT. Valores posibles:¹ RAW (0, por defecto), JSON (1).
allow_traps		string	Permitir poblar el valor de manera similar a la métrica trapper. Soportado para métricas HTTP_AGENT. Valores posibles:¹ NO (0, por defecto), YES (1).
ssl_cert_file		string	Ruta al archivo de clave pública SSL. Soportado para métricas HTTP_AGENT.
ssl_key_file		string	Ruta al archivo de clave privada SSL. Soportado para métricas HTTP_AGENT.
ssl_key_password		string	Contraseña para el archivo de clave SSL. Soportado para métricas HTTP_AGENT.
verify_peer		string	Si se debe validar que el certificado del equipo es auténtico. Soportado para métricas HTTP_AGENT. Valores posibles:¹ NO (0, por defecto), YES (1).
verify_host		string	Si se debe validar que el nombre del equipo para la conexión coincide con el del certificado del equipo. Soportado para métricas HTTP_AGENT. Valores posibles:¹ NO (0, por defecto), YES (1).
tags			Elemento raíz para las etiquetas de la métrica.
	tag	string	(obligatorio) Nombre de la etiqueta.
	value	string	Valor de la etiqueta.
triggers			Elemento raíz para los disparadores de métricas de plantilla.

Ver también: Objeto métrica (consulte la propiedad relevante con el mismo nombre).

Pasos de preprocesamiento de valores de métricas de plantilla

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

Elemento		Tipo	Descripción
type		string	(requerido) El tipo de paso de preprocesamiento del valor de la métrica. 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			(requerido) Elemento raíz para los parámetros del paso de preprocesamiento del valor de la métrica.
	parameter	string	Parámetro individual del paso de preprocesamiento del valor de la métrica.
error_handler		string	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		string	Parámetros del gestor de errores.

Ver también: Objeto de preprocesamiento de métricas (consulte la propiedad correspondiente con el mismo nombre).

Disparadores de métricas 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		string	(obligatorio) Identificador único para este disparador.
expression		string	(obligatorio) Expresión del disparador.
recovery_mode		string	Base para generar eventos OK. Valores posibles:¹ EXPRESSION (0, por defecto), RECOVERY_EXPRESSION (1), NONE (2).
recovery_expression		string	Expresión de recuperación del disparador.
correlation_mode		string	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		string	El nombre de la etiqueta que se utilizará para la correlación de eventos.
name		string	(obligatorio) Nombre del disparador.
event_name		string	Nombre del evento.
opdata		string	Datos operativos.
url_name		string	Etiqueta para la URL asociada al disparador.
url		string	URL asociada al disparador.
status		string	Estado del disparador. Valores posibles:¹ ENABLED (0, por defecto), DISABLED (1).
priority		string	Severidad del disparador. Valores posibles:¹ NOT_CLASSIFIED (0, por defecto), INFO (1), WARNING (2), AVERAGE (3), HIGH (4), DISASTER (5).
description		text	Descripción del disparador.
type		string	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		string	Cierre manual de eventos de problema. Valores posibles:¹ NO (0, por defecto), YES (1).
dependencies			Elemento raíz para dependencias.
	name	string	(obligatorio) Nombre del disparador de dependencia.
	expression	string	(obligatorio) Expresión del disparador de dependencia.
	recovery_expression	string	Expresión de recuperación del disparador de dependencia.
tags			Elemento raíz para etiquetas del disparador.
	tag	string	(obligatorio) Nombre de la etiqueta.
	value	string	Valor de la etiqueta.

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

Reglas de descubrimiento de bajo nivel de 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 plantilla son los mismos que para las métricas de plantilla. La siguiente tabla describe aquellos elementos que difieren de las métricas de plantilla.

Elemento		Tipo	Descripción
type		string	Tipo de métrica. 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) La clave de la regla de descubrimiento de bajo nivel.
filter			Elemento raíz para filtros de reglas de descubrimiento de bajo nivel de plantilla.
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 eliminados. 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 métricas de plantilla, que son los mismos que para las métricas de plantilla.
trigger_prototypes			Elemento raíz para los elementos prototipo de disparadores de plantilla, que son los mismos que para los disparadores de métricas de plantilla.
graph_prototypes			Elemento raíz para los elementos prototipo de gráficos de plantilla, que son los mismos que para los gráficos de equipo.
host_prototypes			Elemento raíz para los elementos prototipo de equipos de plantilla, que son los mismos que para los equipos.
parent_discovery_rule			Elemento raíz para la regla de descubrimiento de bajo nivel padre (o prototipo de regla) del prototipo de regla de descubrimiento de bajo nivel. Esta propiedad indica que es un prototipo de regla LLD, hijo directo de la regla/prototipo referenciado.
	key	string	(requerido) La clave de la regla de descubrimiento de bajo nivel padre (o prototipo de regla).
master_item		string	(requerido para reglas DEPENDENT) Elemento raíz para la métrica principal de la regla dependiente.
lld_macro_paths			Elemento raíz para las rutas de macros de reglas 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 de valores de la regla de descubrimiento de bajo nivel.
	step		Elemento raíz para los elementos de paso de preprocesamiento de valores de la regla de descubrimiento de bajo nivel, que son los mismos que para los pasos de preprocesamiento de valores de métricas de plantilla, excepto con menos valores posibles. Véase también: Objeto de preprocesamiento de regla LLD.
overrides			Elemento raíz para las reglas de anulación de reglas de descubrimiento de bajo nivel.
	name	string	(requerido) Nombre único de la anulación.
	step	string	(requerido) Número de orden único de la anulación.
	stop	string	Detener el procesamiento de las siguientes anulaciones si coincide.
	filter		Elemento raíz para los elementos de filtro de reglas de anulación de reglas de descubrimiento de bajo nivel de plantilla, que son los mismos que para los filtros de reglas de descubrimiento de bajo nivel de plantilla.
	operations		Elemento raíz para las operaciones de anulación de reglas de descubrimiento de bajo nivel de plantilla.

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

Filtros de reglas de bajo nivel de descubrimiento de plantillas

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		string	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		string	Fórmula de cálculo personalizada para las condiciones del filtro.
conditions			Elemento raíz para las condiciones del filtro.
	macro	string	(requerido) El nombre de la macro de bajo nivel de descubrimiento sobre la que realizar la comprobación.
	value	string	Valor con el que comparar.
	operator	string	Operador de condición. Valores posibles:¹ MATCHES_REGEX (8, por defecto), NOT_MATCHES_REGEX (9).
	formulaid	string	(requerido) ID único arbitrario que se utiliza para referenciar 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.

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

Operaciones de anulación de reglas de bajo nivel de plantilla

Elemento		Tipo	Descripción
operationobject		string	Objeto al que se aplica la operación. Valores posibles:¹ ITEM_PROTOTYPE (0), TRIGGER_PROTOTYPE (1), GRAPH_PROTOTYPE (2), HOST_PROTOTYPE (3).
operator		string	Operador de condición de anulación. Valores posibles:¹ EQUAL (1), NOT_EQUAL (2), LIKE (3), NOT_LIKE (4), REGEXP (5), NOT_REGEXP (6).
value		string	Una expresión regular o una cadena para el operador de condición de anulación.
status		string	Estado del objeto tras la operación de anulación.
discover		string	Indica si el objeto se añade como resultado del descubrimiento.
delay		string	Intervalo de actualización establecido para la métrica prototipo tras la operación de anulación.
history		string	Periodo de almacenamiento de histórico establecido para la métrica prototipo tras la operación de anulación.
trends		string	Periodo de almacenamiento de tendencias establecido para la métrica prototipo tras la operación de anulación.
severity		string	Gravedad del prototipo de disparador establecida tras la operación de anulación.
tags			Elemento raíz para las etiquetas establecidas para el objeto tras la operación de anulación.
	tag	string	(obligatorio) Nombre de la etiqueta.
	value	string	Valor de la etiqueta.
templates			Elemento raíz para las plantillas vinculadas al prototipo de equipo tras la operación de anulación.
	name	string	(obligatorio) Nombre de la plantilla.
inventory_mode		string	Modo de inventario del prototipo de equipo establecido tras la operación de anulación.

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

Plantillas de escenarios web

Elemento		Tipo	Descripción
uuid		string	(requerido) Identificador único para este escenario web.
name		string	(requerido) Nombre del escenario web.
delay		string	Frecuencia (usando segundos, sufijo de tiempo, o macro de usuario) de ejecución del escenario web. Por defecto: 1m.
attempts		integer	El número de intentos para ejecutar los pasos del escenario web. Valores posibles:¹ 1-10 (por defecto: 1).
agent		string	Agente cliente. Zabbix simulará ser el navegador seleccionado. Esto es útil cuando un sitio web devuelve contenido diferente para distintos navegadores. Por defecto: Zabbix.
http_proxy		string	Proxy que será utilizado por el escenario web dado como: `http://[usuario[:contraseña]@]proxy.ejemplo.com[:puerto]`
variables			Elemento raíz para las variables del escenario web que pueden ser usadas en los pasos del escenario.
	name	string	(requerido) Nombre de la variable.
	value	text	(requerido) Valor de la variable.
headers			Elemento raíz para las cabeceras HTTP que se enviarán al realizar una petición. Las cabeceras deben listarse usando la misma sintaxis que aparecerían en el protocolo HTTP.
	name	string	(requerido) Nombre de la cabecera.
	value	text	(requerido) Valor de la cabecera.
status		string	Estado del escenario web. Valores posibles:¹ ENABLED (0, por defecto), DISABLED (1).
authentication		string	Método de autenticación. Valores posibles:¹ NONE (0, por defecto), BASIC (1), NTLM (2).
http_user		string	Nombre de usuario utilizado para la autenticación BASIC (HTTP) o NTLM.
http_password		string	Contraseña utilizada para la autenticación BASIC (HTTP) o NTLM.
verify_peer		string	Verificar el certificado SSL del servidor web. Valores posibles:¹ NO (0, por defecto), YES (1).
verify_host		string	Verificar que el campo Common Name o el campo Subject Alternate Name del certificado del servidor web coincida. Valores posibles:¹ NO (0, por defecto), YES (1).
ssl_cert_file		string	Nombre del archivo de certificado SSL utilizado para la autenticación del cliente (debe estar en formato PEM).
ssl_key_file		string	Nombre del archivo de clave privada SSL utilizado para la autenticación del cliente (debe estar en formato PEM).
ssl_key_password		string	Contraseña del archivo de clave privada SSL.
steps			(requerido) Elemento raíz para los pasos de la plantilla de escenario web.
tags			Elemento raíz para las etiquetas del escenario web.
	tag	string	(requerido) Nombre de la etiqueta.
	value	string	Valor de la etiqueta.

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

Pasos del escenario web de la plantilla

Elemento		Tipo	Descripción
name		string	(obligatorio) Nombre del paso del escenario web.
url		string	(obligatorio) URL para monitorización.
query_fields			Elemento raíz para los parámetros de consulta (un array de campos HTTP que se añadirán a la URL al realizar una petición).
	name	string	(obligatorio) Nombre del parámetro de consulta.
	value	string	Valor del parámetro de consulta.
posts			Elemento raíz para las variables HTTP POST (una cadena (datos post sin procesar) o un array de campos HTTP (datos de campo de formulario)).
	name	string	(obligatorio) Nombre del campo post.
	value	string	(obligatorio) Valor del campo post.
variables			Elemento raíz de las variables a nivel de paso (macros) que deben aplicarse después de este paso. Si el valor de la variable tiene el prefijo 'regex:', entonces su valor se extrae de los datos devueltos por este paso según el patrón de expresión regular que sigue al prefijo 'regex:'
	name	string	(obligatorio) Nombre de la variable.
	value	text	(obligatorio) Valor de la variable.
headers			Elemento raíz para las cabeceras HTTP que se enviarán al realizar una petición.
	name	string	(obligatorio) Nombre de la cabecera.
	value	text	(obligatorio) Valor de la cabecera.
follow_redirects		string	Seguir redirecciones HTTP. Valores posibles:¹ NO (0), SÍ (1, por defecto).
retrieve_mode		string	Modo de obtención de la respuesta HTTP. Valores posibles:¹ BODY (0, por defecto), HEADERS (1), BOTH (2).
timeout		string	Tiempo de espera (usando segundos, sufijo de tiempo, o macro de usuario) para la ejecución del paso. Por defecto: 15s.
required		string	Texto que debe estar presente en la respuesta (se ignora si está vacío).
status_codes		string	Lista separada por comas de los códigos de estado HTTP aceptados (por ejemplo, `200-201,210-299`; se ignora si está vacío).

Véase también: Objeto paso de escenario web (consulte la propiedad relevante con el mismo nombre).

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		string	(obligatorio) Tipo de campo de entrada de macro. Valores posibles:¹ NOCONF (0), TEXT (1), LIST (2), CHECKBOX (3).
priority		string	Posición de la macro en la lista de macros.
section_name		string	Etiqueta de la sección plegable donde se agrupa la macro.
label		string	(obligatorio para macros TEXT, LIST, CHECKBOX) Etiqueta de la macro.
description		text	Texto de ayuda de la macro. Soporta formato Markdown.
required		string	Marca la macro como obligatoria. Valores posibles:¹ NO (0), YES (1). Soportado para macros TEXT y LIST.
regex		string	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 LIST o valores CHECKBOX.
	value	string	(obligatorio para macros LIST) Valor del elemento LIST.
	text	string	(obligatorio para macros LIST) Texto del elemento LIST.
	checked	string	(obligatorio para macros CHECKBOX) Valor que representa un estado marcado. Valores posibles:¹ 0 (falso), 1 (verdadero). Soportado para macros CHECKBOX.
	unchecked	string	(obligatorio para macros CHECKBOX) Valor que representa un estado desmarcado. Valores posibles:¹ 0 (falso), 1 (verdadero). Soportado para macros CHECKBOX.

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

Paneles de plantilla

zabbix_export:
         (...)
         templates:
           (...)
             dashboards:
               - uuid: c689ad3115fd46a4b927d1f70ee2e5a4
                 name: Sistemas de archivos
                 pages:
                   - name: Resumen
                     widgets: (ver tabla abajo)
               (...)

Elemento		Tipo	Descripción
uuid		string	(requerido) Identificador único para este panel.
name		string	(requerido) Nombre del panel de la plantilla.
display period		integer	Período de visualización de las páginas del panel.
auto_start		string	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 del panel de la plantilla.
	name	string	Nombre de la página.
	display period	integer	Período de visualización de la página.
	sortorder	integer	Orden de clasificación de la página.
widgets			Elemento raíz para los widgets del panel de la plantilla.

Ver también: Objeto panel de plantilla (consulte la propiedad relevante 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 by Zabbix agent'
                               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 by Zabbix agent'
                               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 mismo nombre).

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		string	(obligatorio) Identificador único para este mapa de valores.
name		string	(obligatorio) Nombre del mapa de valores.
mapping			Elemento raíz para las asignaciones.
	type	string	Tipo de coincidencia de la asignación. Valores posibles:¹ EQUAL (0, por defecto), GREATER_OR_EQUAL (2), LESS_OR_EQUAL (3), IN_RANGE (4), REGEXP (5), DEFAULT (6).
	value	string	Valor original.
	newvalue	string	(obligatorio) Valor al que se asigna el valor original.

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

Notas al pie

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

Documentation