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: Recogida de datos → Plantillas.
Haga clic en Importar en la esquina de arriba a la derecha.
Seleccione el archivo a importar.
Haga clic en Importar en la esquina inferior derecha del formulario de configuración.

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

Si hace clic en la casilla de verificación de la fila Todo, todos los elementos situados debajo de ella se marcarán o desmarcarán.

Reglas de importación:

Regla	Descripción
Update existing	Los elementos existentes serán actualizados con los datos tomados del archivo de importación. De lo contrario, no se actualizarán.
Create new	La importación agregará nuevos elementos usando los datos del archivo de importación. De lo contrario, no los agregará.
Delete missing	La importación eliminará los elementos existentes que no se encuentren en el archivo de importación. De lo contrario, no los eliminará. Si Delete missing es marcado para Template linkage, la vinculación actual de plantillas que no se encuentre en el archivo de importación será desvinculada. La entidades (métricas, iniciadores, gráficos, etc.) heredadas de las plantillas desvinculadas no se eliminarán (a menos que la opción Delete missing esté seleccionada para cada entidad).

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

EL menú de la izquierda puede ser usado para navegar a través de la lista de cambios. La sección Updated resalta todos los cambios realizados en los elementos de la plantilla que ya existen. La sección Added muestra los nuevos elementos de la plantilla. Los elementos de cada sección se agrupan por tipo de elemento; Presione la flecha gris que apunta hacia abajo para expandir o contraer el grupo de elementos.

Revise los cambios de la plantilla y, a continuación, pulse Importar para realizar la importación de plantillas. Se mostrará un mensaje de éxito o error de la importación en la interfaz de usuario.

Formato de exportación

Formato de exportación en YAML:

zabbix_export:
         version: '7.0'
         template_groups:
           - uuid: a571c0d144b14fd4a87a9d9b2aa9fcd6
             name: Templates/Applications
         host_groups:
           - uuid: a571c0d144b14fd4a87a9d9b2aa9fcd6
             name: Applications
         templates:
           - uuid: 56079badd056419383cc26e6a4fcc7e0
             template: VMware
             name: VMware
             description: |
               You can discuss this template or leave feedback on our forum https://www.zabbix.com/forum/zabbix-suggestions-and-feedback/
       
               Template tooling version used: 0.41
             groups:
               - name: Templates/Applications
             items:
               - uuid: 5ce209f4d94f460488a74a92a52d92b1
                 name: 'VMware: Event log'
                 type: SIMPLE
                 key: 'vmware.eventlog[{$VMWARE.URL},skip]'
                 history: 7d
                 trends: '0'
                 value_type: LOG
                 username: '{$VMWARE.USERNAME}'
                 password: '{$VMWARE.PASSWORD}'
                 description: 'Collect VMware event log.'
                 tags:
                   - tag: component
                     value: log
               - uuid: ee2edadb8ce943ef81d25dbbba8667a4
                 name: 'VMware: Full name'
                 type: SIMPLE
                 key: 'vmware.fullname[{$VMWARE.URL}]'
                 delay: 1h
                 history: 7d
                 trends: '0'
                 value_type: CHAR
                 username: '{$VMWARE.USERNAME}'
                 password: '{$VMWARE.PASSWORD}'
                 description: 'VMware service full name.'
                 preprocessing:
                   - type: DISCARD_UNCHANGED_HEARTBEAT
                     parameters:
                       - 1d
                 tags:
                   - tag: component
                     value: system
               - uuid: a0ec9145f2234fbea79a28c57ebdb44d
                 name: 'VMware: Version'
                 type: SIMPLE
                 key: 'vmware.version[{$VMWARE.URL}]'
                 delay: 1h
                 history: 7d
                 trends: '0'
                 value_type: CHAR
                 username: '{$VMWARE.USERNAME}'
                 password: '{$VMWARE.PASSWORD}'
                 description: 'VMware service version.'
                 preprocessing:
                   - type: DISCARD_UNCHANGED_HEARTBEAT
                     parameters:
                       - 1d
                 tags:
                   - tag: component
                     value: system
             discovery_rules:
               - uuid: 16ffc933cce74cf28a6edf306aa99782
                 name: 'Discover VMware clusters'
                 type: SIMPLE
                 key: 'vmware.cluster.discovery[{$VMWARE.URL}]'
                 delay: 1h
                 username: '{$VMWARE.USERNAME}'
                 password: '{$VMWARE.PASSWORD}'
                 description: 'Discovery of clusters'
                 item_prototypes:
                   - uuid: 46111f91dd564a459dbc1d396e2e6c76
                     name: 'VMware: Status of "{#CLUSTER.NAME}" cluster'
                     type: SIMPLE
                     key: 'vmware.cluster.status[{$VMWARE.URL},{#CLUSTER.NAME}]'
                     history: 7d
                     username: '{$VMWARE.USERNAME}'
                     password: '{$VMWARE.PASSWORD}'
                     description: 'VMware cluster status.'
                     valuemap:
                       name: 'VMware status'
                     tags:
                       - tag: cluster
                         value: '{#CLUSTER.NAME}'
                       - tag: component
                         value: cluster
               - uuid: 8fb6a45cbe074b0cb6df53758e2c6623
                 name: 'Discover VMware datastores'
                 type: SIMPLE
                 key: 'vmware.datastore.discovery[{$VMWARE.URL}]'
                 delay: 1h
                 username: '{$VMWARE.USERNAME}'
                 password: '{$VMWARE.PASSWORD}'
                 item_prototypes:
                   - uuid: 4b61838ba4c34e709b25081ae5b059b5
                     name: 'VMware: Average read latency of the datastore {#DATASTORE}'
                     type: SIMPLE
                     key: 'vmware.datastore.read[{$VMWARE.URL},{#DATASTORE},latency]'
                     history: 7d
                     username: '{$VMWARE.USERNAME}'
                     password: '{$VMWARE.PASSWORD}'
                     description: 'Amount of time for a read operation from the datastore (milliseconds).'
                     tags:
                       - tag: component
                         value: datastore
                       - tag: datastore
                         value: '{#DATASTORE}'
                   - uuid: 5355c401dc244bc588ccd18767577c93
                     name: 'VMware: Free space on datastore {#DATASTORE} (percentage)'
                     type: SIMPLE
                     key: 'vmware.datastore.size[{$VMWARE.URL},{#DATASTORE},pfree]'
                     delay: 5m
                     history: 7d
                     value_type: FLOAT
                     units: '%'
                     username: '{$VMWARE.USERNAME}'
                     password: '{$VMWARE.PASSWORD}'
                     description: 'VMware datastore space in percentage from total.'
                     tags:
                       - tag: component
                         value: datastore
                       - tag: datastore
                         value: '{#DATASTORE}'
                   - uuid: 84f13c4fde2d4a17baaf0c8c1eb4f2c0
                     name: 'VMware: Total size of datastore {#DATASTORE}'
                     type: SIMPLE
                     key: 'vmware.datastore.size[{$VMWARE.URL},{#DATASTORE}]'
                     delay: 5m
                     history: 7d
                     units: B
                     username: '{$VMWARE.USERNAME}'
                     password: '{$VMWARE.PASSWORD}'
                     description: 'VMware datastore space in bytes.'
                     tags:
                       - tag: component
                         value: datastore
                       - tag: datastore
                         value: '{#DATASTORE}'
                   - uuid: 540cd0fbc56c4b8ea19f2ff5839ce00d
                     name: 'VMware: Average write latency of the datastore {#DATASTORE}'
                     type: SIMPLE
                     key: 'vmware.datastore.write[{$VMWARE.URL},{#DATASTORE},latency]'
                     history: 7d
                     username: '{$VMWARE.USERNAME}'
                     password: '{$VMWARE.PASSWORD}'
                     description: 'Amount of time for a write operation to the datastore (milliseconds).'
                     tags:
                       - tag: component
                         value: datastore
                       - tag: datastore
                         value: '{#DATASTORE}'
               - uuid: a5bc075e89f248e7b411d8f960897a08
                 name: 'Discover VMware hypervisors'
                 type: SIMPLE
                 key: 'vmware.hv.discovery[{$VMWARE.URL}]'
                 delay: 1h
                 username: '{$VMWARE.USERNAME}'
                 password: '{$VMWARE.PASSWORD}'
                 description: 'Discovery of hypervisors.'
                 host_prototypes:
                   - uuid: 051a1469d4d045cbbf818fcc843a352e
                     host: '{#HV.UUID}'
                     name: '{#HV.NAME}'
                     group_links:
                       - group:
                           name: Applications
                     group_prototypes:
                       - name: '{#CLUSTER.NAME}'
                       - name: '{#DATACENTER.NAME}'
                     templates:
                       - name: 'VMware Hypervisor'
                     macros:
                       - macro: '{$VMWARE.HV.UUID}'
                         value: '{#HV.UUID}'
                         description: 'UUID of hypervisor.'
                     custom_interfaces: 'YES'
                     interfaces:
                       - ip: '{#HV.IP}'
               - uuid: 9fd559f4e88c4677a1b874634dd686f5
                 name: 'Discover VMware VMs'
                 type: SIMPLE
                 key: 'vmware.vm.discovery[{$VMWARE.URL}]'
                 delay: 1h
                 username: '{$VMWARE.USERNAME}'
                 password: '{$VMWARE.PASSWORD}'
                 description: 'Discovery of guest virtual machines.'
                 host_prototypes:
                   - uuid: 23b9ae9d6f33414880db1cb107115810
                     host: '{#VM.UUID}'
                     name: '{#VM.NAME}'
                     group_links:
                       - group:
                           name: Applications
                     group_prototypes:
                       - name: '{#CLUSTER.NAME} (vm)'
                       - name: '{#DATACENTER.NAME}/{#VM.FOLDER} (vm)'
                       - name: '{#HV.NAME}'
                     templates:
                       - name: 'VMware Guest'
                     macros:
                       - macro: '{$VMWARE.VM.UUID}'
                         value: '{#VM.UUID}'
                         description: 'UUID of guest virtual machine.'
                     custom_interfaces: 'YES'
                     interfaces:
                       - ip: '{#VM.IP}'
             tags:
               - tag: class
                 value: software
               - tag: target
                 value: vmware
             macros:
               - macro: '{$VMWARE.PASSWORD}'
                 description: 'VMware service {$USERNAME} user password'
               - macro: '{$VMWARE.URL}'
                 description: 'VMware service (vCenter or ESX hypervisor) SDK URL (https://servername/sdk)'
               - macro: '{$VMWARE.USERNAME}'
                 description: 'VMware service user name'
             valuemaps:
               - uuid: 3c59c22905054d42ac4ee8b72fe5f270
                 name: 'VMware status'
                 mappings:
                   - value: '0'
                     newvalue: gray
                   - value: '1'
                     newvalue: green
                   - value: '2'
                     newvalue: yellow
                   - value: '3'
                     newvalue: red

Elementos exportados

Los elementos exportados se explican en las tablas siguientes.

Elemento		Tipo	Descripción
template_groups			(obligatorio) Elemento raíz para grupos de plantillas.
	uuid	cadena	(obligatorio) Identificador único para este grupo de plantillas.
	name	cadena	(obligatorio) Nombre del grupo de plantillas.
name			(obligatorio) Elemento raíz para los grupos de equipos que utilizan los prototipos de equipo.
	uuid	cadena	(obligatorio) Identificador único para este grupo de equipos.
	name	cadena	(obligatorio) Nombre del grupo de equipos.
templates			Elemento raíz para plantillas.

Plantillas

Elemento		Tipo	Descripción
uuid		cadena	(obligatorio) Identificador único para esta plantilla.
template		cadena	(obligatorio) Nombre de plantilla único.
name		cadena	Nombre de plantilla visible.
description		texto	Descripción de la plantilla.
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 listas para usar, la versión se muestra de la siguiente manera: versión principal de Zabbix, delimitador (" -"), número de revisión (aumentado con cada nueva versión de la plantilla y restablecido con cada versión principal de Zabbix). Por ejemplo, 6,4-0, 6,4-3, 7,0-0, 7,0-3.
templates			Elemento raíz para plantillas vinculadas.
	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 modelo de reglas de descubrimiento de bajo nivel.
httptests			Elemento raíz para escenarios web de plantilla.
tags			Elemento raíz para etiquetas de plantilla.
	tag	cadena	(obligatorio) Nombre de etiqueta.
	value	cadena	Valor de etiqueta.
macros			Elemento raíz para macros de usuario de plantilla.
	macro	cadena	(obligatorio) Nombre de macro de usuario.
	type	cadena	Tipo de macro de usuario. Valores posibles:¹ TEXTO (0, predeterminado), SECRETO_TEXTO (1), BÓVEDA (2). Ver también : Objeto macro de usuario (`type`).
	value	cadena	Valor de macro de usuario.
	description	cadena	Descripción de macro de usuario.
description			Elemento raíz para los tableros.
valuemaps			Elemento raíz para mapas de valores de plantilla.

Métricas de plantilla

Elemento		Tipo	Descripción
uuid		cadena	(obligatorio) Identificador único de esta métrica.
name		cadena	(obligatorio) Nombre de la métrica.
type		cadena	Tipo de métrica. Valores posibles:¹ ZABBIX_PASSIVE (0, predeterminado), 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) ID de objeto SNMP.
key		cadena	(obligatorio) Clave de métrica.
delay		cadena	Intervalo de actualización de la métrica. Predeterminado: 1m. El valor siempre será 0 para las métricas TRAP.
history		cadena	Período de tiempo (utilizando sufijo de tiempo, macros de usuario o macros LLD) durante el cual se deben almacenar los datos del historial. Predeterminado: 31d.
trends		cadena	Período de tiempo (utilizando sufijo de tiempo, macros de usuario o macros LLD) durante el cual se deben almacenar los datos de tendencias. Predeterminado: 365d.
status		cadena	Estado de la métrica. Valores posibles:¹ ENABLED (0, valor predeterminado), DISABLED (1).
value_type		cadena	Tipo de valor recibido. Valores posibles:¹ FLOAT (0), CHAR (1), LOG (2), UNSIGNED (3, valor predeterminado), TEXT (4), BINARY (5).
allowed_hosts		cadena	Lista de direcciones IP delimitadas por comas de los equipos a los que se les permite enviar datos para la métrica. Compatible con métricas TRAP y HTTP_AGENT.
units		cadena	Unidades del valor recibido (bps, B, etc.).
params		texto	Parámetros adicionales según el tipo de métrica (script ejecutado para métricas SSH y TELNET; consulta SQL para métricas ODBC; fórmula para métricas CALCULATED; el script para métricas ITEM_TYPE_SCRIPT y ITEM_TYPE_BROWSER).
ipmi_sensor		cadena	Sensor IPMI. Compatible con métricas IPMI.
authtype		cadena	Tipo de autenticación. Compatible con métricas SSH y HTTP_AGENT. Valores posibles para elementos SSH:¹ PASSWORD (0, predeterminado), PUBLIC_KEY (1). Valores posibles para métricas HTTP_AGENT:¹ NONE (0, predeterminado), BASIC (1), NTLM (2).
username		cadena	(requerido para métricas SSH y TELNET) Nombre de usuario para autenticación. Compatible con métricas SIMPLE, ODBC, JMX y HTTP_AGENT. Cuando se utiliza para métricas JMX, también se debe especificar `password` (ver a continuación) o ambos elementos se deben dejar en blanco.
password		cadena	(requerido para elementos SSH y TELNET) Contraseña para autenticación. Compatible con elementos SIMPLE, ODBC, JMX y HTTP_AGENT. Cuando se utiliza para métricas JMX, también se debe especificar `username` (ver arriba) o ambos elementos se deben dejar en blanco.
publickey		cadena	(requerido para métricas SSH) Nombre del archivo de clave pública.
privatekey		cadena	(requerido para métricas SSH) Nombre del archivo de clave privada.
description		texto	Descripción de la métrica.
inventory_link		cadena	Campo de inventario del equipo que se completa con la métrica. Valores posibles:¹ NONE (0), ALIAS (4), etc. (consulte Inventario del equipo para conocer los campos compatibles).
valuemap			Elemento raíz para los mapas de valores de métricas.
	name	cadena	(obligatorio) Nombre del mapa de valores que se utilizará para la métrica.
logtimefmt		cadena	Formato de la hora en las entradas de registro. Compatible con métricas del tipo de valor LOG.
preprocessing			Elemento raíz para el preprocesamiento de valores de métricas.
	step		Elemento raíz para pasos de preprocesamiento de valores de métricas de plantilla.
jmx_endpoint		cadena	Punto final de JMX. Compatible con métricas JMX.
master_item			(requerido para elementos DEPENDIENTES) Elemento raíz de la métrica maestra de la métrica dependiente.
	key	cadena	(requerido) Clave de la métrica maestra de la métrica dependiente.
timeout		cadena	Tiempo de espera de la solicitud de sondeo de datos de la métrica. Compatible con la lista de tipos de métricas Timeouts.
url		cadena	(requerido para métricas HTTP_AGENT) Cadena de URL.
query_fields			Elemento raíz para parámetros de consulta. Compatible con métricas HTTP_AGENT.
	name	cadena	(requerido para métricas HTTP_AGENT) Nombre del parámetro de consulta.
	value	cadena	Valor del parámetro de consulta. Compatible con métricas HTTP_AGENT.
parameters			Elemento raíz para parámetros definidos por el usuario. Compatible con métricas ITEM_TYPE_SCRIPT y ITEM_TYPE_BROWSER.
	name	cadena	(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. Compatible con métricas ITEM_TYPE_SCRIPT y ITEM_TYPE_BROWSER.
posts		cadena	Datos del cuerpo de la solicitud HTTP(S). Compatible con métricas HTTP_AGENT.
status_codes		string	Rangos de códigos de estado HTTP obligatorios, separados por comas. Compatible con métricas HTTP_AGENT.
follow_redirects		string	Seguir las redirecciones de respuesta mientras se sondean los datos. Compatible con métricas HTTP_AGENT. Valores posibles:¹ NO (0), YES (1, predeterminado).
post_type		cadena	Tipo de cuerpo de datos de la publicación. Compatible con métricas HTTP_AGENT. Valores posibles:¹ RAW (0, predeterminado), JSON (2), XML (3).
http_proxy		cadena	Cadena de conexión de proxy HTTP(S). Compatible con métricas HTTP_AGENT.
headers			Elemento raíz para encabezados de solicitud HTTP(S). Compatible con métricas HTTP_AGENT.
	name	cadena	(obligatorio para elementos HTTP_AGENT) Nombre del encabezado.
	value	cadena	(obligatorio para elementos HTTP_AGENT) Valor del encabezado.
retrieve_mode		cadena	Qué parte de la respuesta se debe almacenar. Compatible con métricas HTTP_AGENT. Valores posibles:¹ BODY (0, predeterminado), HEADERS (1), BOTH (2).
request_method		cadena	Tipo de método de solicitud. Compatible con métricas HTTP_AGENT. Valores posibles:¹ GET (0, predeterminado), POST (1), PUT (2), HEAD (3).
output_format		cadena	Cómo procesar la respuesta. Compatible con elementos HTTP_AGENT. Valores posibles:¹ RAW (0, predeterminado), JSON (1).
allow_traps		cadena	Permitir rellenar el valor de forma similar al capturador de métricas. Compatible con métricas HTTP_AGENT. Valores posibles:¹ NO (0, predeterminado), YES (1).
ssl_cert_file		cadena	Ruta del archivo de clave SSL pública. Compatible con métricas HTTP_AGENT.
ssl_key_file		cadena	Ruta del archivo de clave SSL privada. Compatible con métricas HTTP_AGENT.
ssl_key_password		cadena	Contraseña para el archivo de clave SSL. Compatible con métricas HTTP_AGENT.
verify_peer		cadena	Si se debe validar que el certificado del equipo sea auténtico. Compatible con métricas HTTP_AGENT. Valores posibles:¹ NO (0, predeterminado), YES (1).
verify_host		cadena	Si se debe validar que el nombre del equipo para la conexión coincida con el del certificado del equipo. Compatible con métricas HTTP_AGENT. Valores posibles:¹ NO (0, predeterminado), YES (1).
tags			Elemento raíz para las etiquetas de métricas.
	tag	cadena	(obligatorio) Nombre de etiqueta.
	value	cadena	Valor de etiqueta.
triggers			Elemento raíz para iniciadores de métricas de plantilla.

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

Pasos de preprocesamiento del valor de la métrica de plantilla

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 verificació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 de la métrica.
	parameter	cadena	Parámetro individual del paso de preprocesamiento del valor de la métrica.
error_handler		cadeba	Tipo de acción utilizado en caso de fallo en el paso de preprocesamiento. Valores posibles:¹ ORIGINAL_ERROR (0, predeterminado), DISCARD_VALUE (1), CUSTOM_VALUE (2), CUSTOM_ERROR (3).
error_handler_params		cadena	Parámetros del controlador de errores.

Consulte también: Objeto de preprocesamiento de métricas (consulte la propiedad relevante con un nombre coincidente).

Plantilla de reglas de descubrimiento de bajo nivel

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

Elemento		Tipo	Descripción
type		cadena	Tipo de métrica. Valores posibles:¹ ZABBIX_PASSIVE (0, default), 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		cadena	(obligatorio) La clave de la regla de descubrimiento de bajo nivel.
filter			Elemento raíz para plantilla de filtros de reglas de descubrimiento de bajo nivel.
lifetime		cadena	Período de tiempo (usando segundos, sufijo de tiempo, o macro de usuario), después del cual los recursos descubiertos que ya no se encuentren se eliminarán. Predeterminado: 7d.
lifetime_type		string	Escenario para eliminar recursos LLD perdidos. Valores posibles: ELIMINAR_NUNCA, ELIMINAR_INMEDIATAMENTE, ELIMINAR_DESPUÉS.
enabled_lifetime		string	Período de tiempo (usando segundos, sufijo de tiempo, o macro de usuario), después del cual los recursos descubiertos durante más tiempo se desactivarán.
enabled_lifetime_type		cadena	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 del prototipo de iniciador de plantilla, que son los mismos que para activadores de elementos de plantilla.
graph_prototypes			Elemento raíz para los elementos del prototipo de gráfico de plantilla, que son los mismos que para gráficos de host.
host_prototypes			Elemento raíz para los elementos del prototipo de equipo de plantilla, que son los mismos que para los equipos.
master_item		cadema	(obligatorio para reglas DEPENDENTES) Elemento raíz para la métrica maestra de la regla dependiente.
lld_macro_paths			Elemento raíz para rutas de macros de reglas de descubrimiento de bajo nivel.
	lld_macro	string	(obligatorio) Nombre de macro de regla de descubrimiento de bajo nivel.
	path	cadena	(obligatorio) Selector de valor, que será asignado 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 de valor de regla de descubrimiento de bajo nivel, que son los mismos que para pasos de preprocesamiento de valor de métrica de plantilla, excepto que tienen menos valores posibles. Ver también: objeto de preprocesamiento de reglas LLD.
overrides			Elemento raíz para reglas de anulación de reglas de descubrimiento de bajo nivel.
	name	cadena	(obligatorio) Nombre de anulación único.
	step	cadena	(obligatorio) Número de orden único de la anulación.
	stop	string	Detener el procesamiento de las siguientes anulaciones si coinciden.
	filter		Elemento raíz para los elementos de filtro de reglas de anulación de regla 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 regla de descubrimiento de bajo nivel de plantilla.

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

Plantilla de filtros de reglas de descubrimiento de bajo nivel

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

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

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

Activadores de elementos de plantilla

Elemento		Tipo	Descripción
uuid		cadena	(obligatorio) Identificador único para este iniciador.
expression		cadena	(obligatorio) Expresión del iniciador.
recovery_mode		cadena	Base para generar eventos OK. Valores posibles:¹ EXPRESSION (0, predeterminado), RECOVERY_EXPRESSION (1), NONE (2).
recovery_expression		cadena	Expresión de recuperación del iniciador.
correlation_mode		cadena	Modo de correlación (sin correlación de eventos o correlación de eventos por etiqueta). Valores posibles:¹ DISABLED (0, predeterminado), TAG_VALUE (1) .
correlation_tag		cadena	El nombre de la etiqueta que se utilizará para la correlación de eventos.
name		cadena	(obligatorio) Nombre del iniciador.
event_name		cadena	Nombre del evento.
opdata		string	Datos operativos.
url_name		string	Etiqueta para la URL asociada con el iniciador.
url		cadena	URL asociada con el iniciador.
status		string	Estado del iniciador. Valores posibles:¹ HABILITADO (0, predeterminado), DISABLED (1).
priority		cadena	Gravedad del iniciador. Valores posibles:¹ NOT_CLASSIFIED (0, predeterminado), INFORMACIÓN (1), ADVERTENCIA (2), PROMEDIO (3), ALTA (4), DESASTRE (5).
description		texto	Descripción del iniciador.
type		cadena	Tipo de generación de evento (evento de problema único o eventos de problema múltiple). Valores posibles:¹ SINGLE (0, predeterminado), MULTIPLE (1).
manual_close		string	Cierre manual de eventos de problema. Valores posibles:¹ NO (0, predeterminado), SÍ (1).
dependencies			Elemento raíz para dependencias.
	name	cadena	(obligatorio) Nombre del iniciador de dependencia.
	expression	cadena	(obligatorio) Expresión del iniciador de dependencia.
	recovery_expression	string	Expresión de recuperación del iniciador de dependencia.
tags			Elemento raíz para etiquetas de iniciador.
	tag	cadena	(obligatorio) Nombre de etiqueta.
	value	cadena	Valor de etiqueta.

Consulte también: Objeto iniciador (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).

Tableros de plantilla

Elemento		Tipo	Descripción
uuid		string	(obligatorio) Identificador único para este tablero.
name		cadena	(obligatorio) Nombre del tablero de plantilla.
display period		entero	Período de visualización de las páginas del tablero.
auto_start		cadena	Inicio automático de presentación de diapositivas. Valores posibles:¹ NO (0), SÍ (1, predeterminado).
pages			Elemento raíz para las páginas del tablero de plantilla.
	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 páginas.
widgets			Elemento raíz para widgets del tablero de plantilla.

Consulte también: Objeto del panel de plantilla (consulte la propiedad relevante con un nombre coincidente).

Widgets del tablero de plantilla

Elemento		Tipo	Descripción
type		cadena	(obligatorio) Tipo de widget.
name		cadena	Nombre del widget.
x		entero	Posición horizontal desde el lado izquierdo del panel de la plantilla. Valores posibles:¹ 0-71.
y		entero	Posición vertical desde la parte superior del panel de la plantilla. Valores posibles:¹ 0-63.
width		entero	Ancho del widget. Valores posibles:¹ 1-72.
height		entero	Altura del widget. Valores posibles:¹ 1-64.
hide_header		string	Ocultar encabezado del widget. Valores posibles:¹ NO (0, predeterminado), SÍ (1).
fields			Elemento raíz para los campos del widget del tablero de plantilla.
	type	cadena	(obligatorio) Tipo de campo del widget. Valores posibles:¹ INTEGER (0), STRING (1), ITEM (4), ITEM_PROTOTYPE (5) , GRÁFICO (6), GRÁFICO_PROTOTIPO (7), MAPA (8), SERVICIO (9), SLA (10), USUARIO (11), ACCIÓN (12), TIPO_MEDIO (13).
	name	cadena	(obligatorio) Nombre del campo del widget.
	value	mixto	(obligatorio) Valor del campo del widget, según el tipo de campo.

Consulte también: Objeto de widget de panel de plantilla (consulte la propiedad relevante con un nombre coincidente).

Mapas de valores de plantilla

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

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

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