Se encuentra viendo la documentación de la versión en desarrollo, puede estar incompleta.
Únase a nuestro proyecto de traducción y ayude a traducir la documentación de Zabbix a su lengua materna.

3 Plantillas

Visión general

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

La exportación de plantilla contiene:

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

Exportación

Para exportar plantillas, haga lo siguiente:

  1. Vaya a Recogida de datosPlantillas.
  2. Marque las casillas de verificación de las plantillas a exportar.
  3. 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:

  1. Vaya a: Recogida de datosPlantillas.
  2. Haga clic en Importar a la derecha.
  3. Seleccione el archivo a importar.
  4. Haga clic en Importar.

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 (elementos, disparadores, 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: '6.4'
       template_groups:
       - uuid: a571c0d144b14fd4a87a9d9b2aa9fcd6
       name: Templates/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.38
       vendor:
       name: Zabbix
       version: 6.4-0
       templates:
       - name: 'VMware macros'
       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. See also: https://www.zabbix.com/documentation/6.2/manual/config/items/preprocessing/examples#filtering_vmware_event_log_records'
       tags:
       - tag: Application
       value: VMware
       - 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: Application
       value: VMware
       - 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: Application
       value: VMware
       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: Application
       value: VMware
       - 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: Application
       value: VMware
       - 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: Application
       value: VMware
       - 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: Application
       value: VMware
       - 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: Application
       value: VMware
       - 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: Templates/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: Templates/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}'
       valuemaps:
       - uuid: 3c59c22905054d42ac4ee8b72fe5f270
       name: 'VMware status'
       mappings:
       - value: '0'
       newvalue: gray
       - value: '1'
       newvalue: green
       - value: '2'
       newvalue: yellow
       - value: '3'
       newvalue: red

Etiquetas de elementos

Los valores de las etiquetas de elementos se explican en la siguiente tabla.

Etiquetas de plantilla
Elemento Propiedad del elemento Requerido Tipo Rango Descripción
template_groups x Elemento raíz para grupos de plantillas.
uuid x cadena Identificador único para este grupo de plantillas.
name x cadena Nombre del grupo de plantillas.
host_groups x Elemento raíz para grupos de hosts que utilizan los prototipos de hosts.
uuid x cadena Identificador único para este grupo de hosts.
name x cadena Nombre del grupo anfitrión.
templates - Elemento raíz para plantillas.
uuid x cadena Identificador único para esta plantilla.
template x cadena 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.

Elemento agregado solo si la plantilla exportada contiene datos del proveedor.
name - cadena Nombre del proveedor de la plantilla.
version - cadena 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 x cadena Nombre de la plantilla.
groups - Elemento raíz para grupos de plantillas.
name x cadena Nombre del grupo de plantillas.
tags - Elemento raíz para etiquetas de plantilla.
tag x cadena Nombre de etiqueta.
value - cadena Valor de etiqueta.
macros - Elemento raíz para macros de usuario de plantilla.
macro x cadena Nombre de la macro de usuario.
type - cadena 0 - TEXTO (predeterminado)
1 - SECRETO_TEXTO
2 - VAULT
Tipo de macro.
value - cadena Valor de macro de usuario.
description - cadena Descripción de la macro de usuario.
valuemaps - Elemento raíz para mapas de valores de plantilla.
uuid x cadena Identificador único para este mapa de valores.
name x cadena Nombre del mapa de valores.
mapping - Elemento raíz para asignaciones.
value x cadena Valor de un mapeo.
newvalue x cadena Nuevo valor de un mapeo.
Etiquetas de plantillas de métricas
Elemento Propiedad del elemento Obligatorio Tipo Rango1 Descripción
items - Elemento raíz de las métricas.
uuid x cadena Identificador único de la métrica.
name x cadena Nombre de la métrica.
type - cadena 0 - ZABBIX_PASSIVE (predeterminado)
2 - TRAP
3 - SIMPLE
5 - INTERNO
7 - ZABBIX_ACTIVE
10 - EXTERNO
11 - ODBC
12 - IPMI
13 - SSH
14 - TELNET
15 - CALCULADO
16 - JMX
17 - SNMP_TRAP
18 - DEPENDIENTE
19 - HTTP_AGENT
20 - SNMP_AGENT
21 - ITEM_TYPE_SCRIPT
Tipo de métrica.
snmp_oid - cadena ID de objeto SNMP.

Requerido por los elementos SNMP.
key x cadena Clave de la métrica.
delay - string Predeterminado: 1m Intervalo de actualización de la métrica.

Acepta segundos o una unidad de tiempo con sufijo (30s, 1m, 2h, 1d).
Opcionalmente uno o se pueden especificar más intervalos personalizados como intervalos flexibles o como programación.
Varios intervalos están separados por un punto y coma.
Se pueden usar macros de usuario. Una sola macro tiene que llenar todo el campo. No se admiten múltiples macros en un campo ni macros mezcladas con texto.
Los intervalos flexibles se pueden escribir como dos macros separadas por una barra diagonal (por ejemplo, {$FLEX_INTERVAL}/{$FLEX_PERIOD}).
history - string Predeterminado: 90d Período de tiempo durante el cual se deben almacenar los datos del historial. Un período de tiempo que utiliza el sufijo de tiempo, una macro de usuario o una macro LLD.
trends - string Predeterminado: 365d Período de tiempo durante el cual se deben almacenar los datos de tendencias. Un período de tiempo que utiliza el sufijo de tiempo, una macro de usuario o una macro LLD.
status - string 0 - HABILITADO (predeterminado)
1 - DESHABILITADO
Estado de la métrica.
value_type - cadena 0 - FLOAT
1 - CHAR
2 - LOG
3 - UNSIGNED (predeterminado)
4 - TEXTO
Tipo de valor recibido.
allowed_hosts - cadena Lista de direcciones IP (delimitadas por comas) de equipos a los que se permite enviar datos para la métrica.

Usado por métricas de captura y agente HTTP.
units - cadena Unidades de valores devueltos (bps, B, etc.).
params - texto Parámetros adicionales según el tipo de elemento:
- script ejecutado para elementos Script, SSH y Telnet;
- consulta SQL para elementos del monitor de base de datos;
- fórmula para elementos calculados.
ipmi_sensor - cadena Sensor IPMI.

Usado solo por métricas IPMI.
authtype - string Tipo de autenticación para métricas de agente SSH:
0 - CONTRASEÑA (predeterminada)
1 - PUBLIC_KEY

Tipo de autenticación para elementos del agente HTTP:
0 - NINGUNO (predeterminado)
1 - BÁSICO
2 - NTLM
Tipo de autenticación.

Usado solo por elementos de agente SSH y HTTP.
username - cadena Nombre de usuario para autenticación.
Usado por verificación simple, SSH, Telnet, monitor de base de datos, elementos de agente JMX y HTTP.

Requerido por elementos SSH y Telnet.
Cuando lo usa el agente JMX, la contraseña debe También se debe especificar junto con el nombre de usuario o ambas propiedades deben dejarse en blanco.
password - cadena Contraseña para autenticación.
Se utiliza mediante comprobación simple, SSH, Telnet, monitor de base de datos, métricas de agente JMX y HTTP.

Cuando lo utiliza el agente JMX, el nombre de usuario también debe especificarse junto con la contraseña o ambas propiedades. debe dejarse en blanco.
publickey - cadena Nombre del archivo de clave pública.

Obligatorio para las métricas de agente SSH.
privatekey - cadena Nombre del archivo de clave privada.

Obligatorio para las métricas de agente SSH.
port - cadena Puerto personalizado monitoreado por la métrica.
Puede contener macros de usuario.

Usado solo por métricas SNMP.
description - texto Descripción de la métrica.
inventory_link - string 0 - NINGUNO

Nombre del campo de inventario de host en mayúsculas. Por ejemplo:
4 - ALIAS
6 - SO_FULL
14 - HARDWARE
etc.
Campo de inventario del equipo que se completa con la métrica.

Consulte la página de inventario de equipo para obtener una lista de campos admitidos de inventario de equipo y sus ID.
logtimefmt - cadena Formato de la hora en las entradas del registro.
Usado sólo por métricas del registro.
jmx_endpoint - cadena Punto final JMX.

Usado solo por métricas del agente JMX.
url - cadena Cadena URL.

Obligatorio solo para métricas del agente HTTP.
allow_traps - string 0 - NO (predeterminado)
1 - SÍ
Permite completar el valor como en una métricas de captura.

Usado solo por métricas de agente HTTP.
follow_redirects - string 0 - NO
1 - SÍ (predeterminado)
Siga las redirecciones de respuesta HTTP mientras sondea los datos.

Usado solo por métricas del agente HTTP.
headers - Elemento raíz para encabezados de solicitud HTTP(S), donde el nombre del encabezado se usa como clave y el valor del encabezado como valor.
Usado solo por métricas del agente HTTP.
name x cadena Nombre del encabezado.
value x cadena Valor del encabezado.
http_proxy - cadena Cadena de conexión de proxy HTTP(S).

Utilizada únicamente por métricas del agente HTTP.
output_format - cadena 0 - RAW (predeterminado)
1 - JSON
Cómo procesar la respuesta.

Usado solo por métricas del agente HTTP.
post_type - string 0 - RAW (predeterminado)
2 - JSON
3 - XML
Tipo de cuerpo de datos de la publicación.

Usado solo por métricas del agente HTTP.
posts - cadena Datos del cuerpo de la solicitud HTTP(S).

Utilizado únicamente por métricas del agente HTTP.
query_fields - Elemento raíz para parámetros de consulta.

Utilizado únicamente por métricas del agente HTTP.
name x cadena Nombre del parámetro.
value - cadena Valor del parámetro.
request_method - cadena 0 - GET (predeterminado)
1 - POST
2 - PUT
3 - HEAD
Método de solicitud.

Usado solo por métricas del agente HTTP.
retrieve_mode - string 0 - CUERPO (predeterminado)
1 - ENCABEZADOS
2 - AMBOS
Qué parte de la respuesta debe almacenarse.

Usado solo por métricas del agente HTTP.
ssl_cert_file - cadena Ruta del archivo de clave SSL pública.

Utilizada únicamente por métricas del agente HTTP.
ssl_key_file - cadena Ruta del archivo de clave SSL privada.

Utilizada únicamente por métricas del agente HTTP.
ssl_key_password - cadena Contraseña para el archivo de clave SSL.

Utilizada únicamente por métricas del agente HTTP.
status_codes - cadena Rangos de códigos de estado HTTP requeridos separados por comas. Admite macros de usuario.
Ejemplo: 200,200-{$M},{$M},200-400

Usado solo por métricas del agente HTTP.
timeout - cadena Tiempo de espera de solicitud de sondeo de datos de elementos. Admite macros de usuario.

Usado por el agente HTTP y métricas de secuencia de comandos.
verify_host - cadena 0 - NO (predeterminado)
1 - SÍ
Validar si el nombre de equipo en la URL está en el campo Nombre común o en el campo Nombre alternativo del sujeto del certificado de equipo.
< br>Usado sólo por métricas del agente HTTP.
verify_peer - string 0 - NO (predeterminado)
1 - SÍ
Validar si el certificado de host es auténtico.

Usado solo por métricas del agente HTTP.
parameters - Elemento raíz para parámetros definidos por el usuario.

Utilizado únicamente por métricas de script.
name x cadena Nombre del parámetro.

Usado sólo por métricas de script.
value - cadena Valor del parámetro.

Usado sólo por métricas de script.
value map - Mapa de valores.
name x cadena Nombre del mapa de valores que se utilizará para la métrica.
preprocessing - Elemento raíz para el preprocesamiento del valor de la métrica.
step - Paso de preprocesamiento del valor de la métrica individual.
type x cadena 1 - MULTIPLICADOR
2 - RTRIM
3 - LTRIM
4 - TRIM
5 - REGEX
6 - BOOL_TO_DECIMAL
7 - OCTAL_TO_DECIMAL
8 - HEX_TO_DECIMAL
9 - SIMPLE_CHANGE (calculado como (valor recibido-valor anterior))
10 - CAMBIO_PER_SECOND (calculado como (recibido valor-valor anterior)/(hora actual-hora de la última verificación))
11 - XMLPATH
12 - JSONPATH
13 - IN_RANGE
14 - MATCHES_REGEX
15 - NOT _MATCHES_REGEX
16 - COMPROBAR_JSON_ERROR
17 - COMPROBAR_XML_ERROR
18 - COMPROBAR_REGEX_ERROR
19 - DESCARTAR_SIN CAMBIAR
20 - DESCARTAR_SIN CAMBIAR _HEARTBEAT
21 - JAVASCRIPT
22 - PROMETHEUS_PATTERN
23 - PROMETHEUS_TO_JSON
24 - CSV_TO_JSON
25 - STR_REPLACE
26 - CHECK_NOT_SUPPORTED
Tipo de paso de preprocesamiento del valor de la métrica.
parameters - Elemento raíz para los parámetros del paso de preprocesamiento del valor de la métrica.
parameter x cadena Parámetro individual del paso de preprocesamiento del valor de la métrica.
error_handler - string 0 - ORIGINAL_ERROR (predeterminado)
1 - DESCARTAR_VALUE
2 - CUSTOM_VALUE
3 - CUSTOM_ERROR
Tipo de acción utilizado en caso de falla en el paso de preprocesamiento.
error_handler_params - cadena Parámetros del controlador de errores utilizados con 'error_handler'.
master_item - Métrica principal de la métrica dependiente.

Requerido por métricas dependientes.
key x cadena Valor de clave de métrica maestra de métrica dependiente.

Se permite la recursividad de hasta 3 métricas dependientes y un recuento máximo de métricas dependientes igual a 29999.
triggers - Elemento raíz para iniciadores simples.
Para conocer los valores de las etiquetas de las métricas desencadenantes, consulte la plantilla etiquetas desencadenantes.
tags - Elemento raíz para etiquetas de métricas.
tag x cadena Nombre de etiqueta.
value - cadena Valor de etiqueta.
Template item value preprocessing steps
Element Type Description
type string (required) The item value preprocessing step type.
Possible values:1 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, calculated: received value - previous value), CHANGE_PER_SECOND (10, calculated: (received value - previous value)/(time now - time of last check)), 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 (required) Root element for parameters of the item value preprocessing step.
parameter string Individual parameter of the item value preprocessing step.
error_handler string Action type used in case of preprocessing step failure.
Possible values:1 ORIGINAL_ERROR (0, default), DISCARD_VALUE (1), CUSTOM_VALUE (2), CUSTOM_ERROR (3).
error_handler_params string Error handler parameters.

See also: Item preprocessing object (refer to the relevant property with a matching name).

Etiquetas de regla de plantilla de descubrimiento de bajo nivel
Elemento Propiedad del elemento Requerido Tipo Rango Descripción
discovery_rules - Elemento raíz para reglas de descubrimiento de bajo nivel.
Para la mayoría de los valores de etiquetas de métricas, consulte los valores de etiquetas de métricas para un elemento normal. A continuación solo se describen las etiquetas que son específicas de las reglas de descubrimiento de bajo nivel.
type - cadena 0 - ZABBIX_PASSIVE (predeterminado)
2 - TRAP
3 - SIMPLE
5 - INTERNO
7 - ZABBIX_ACTIVE
10 - EXTERNO
11 - ODBC
12 - IPMI
13 - SSH
14 - TELNET
16 - JMX
18 - DEPENDIENTE
19 - HTTP_AGENT
20 - SNMP _AGENT
Tipo de métrica.
lifetime - string Predeterminado: 30 días Período de tiempo después del cual se eliminarán las métriocas que ya no se descubren. Segundos, unidad de tiempo con sufijo o macro de usuario.
filter Filtro individual.
evaltype - string 0 - AND_OR (predeterminado)
1 - AND
2 - O
3 - FÓRMULA
Lógica a usar para verificar las condiciones del filtro de reglas de descubrimiento de bajo nivel.
formula - cadena Fórmula de cálculo personalizada para las condiciones del filtro.
conditions - Elemento raíz para condiciones de filtrado.
macro x cadena Nombre de la macro de descubrimiento de bajo nivel.
value - cadena Valor de filtro: expresión regular o expresión regular global.
operator - cadena 8 - MATCHES_REGEX (predeterminado)
9 - NOT_MATCHES_REGEX
Operador de condición.
formulaid x carácter 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.
lld_macro_paths - Elemento raíz para rutas de macro LLD.
lld_macro x cadena Nombre de la macro de descubrimiento de bajo nivel.
path x cadena Selector de valor que se asignará a la macro correspondiente.
preprocessing - Preprocesamiento del valor de la regla LLD.
step - Paso de preprocesamiento del valor de regla LLD individual.
Para la mayoría de los valores de etiquetas de métricas, consulte Valores de etiquetas de métricas para el preprocesamiento de valores de plantillas de métricas. A continuación solo se describen las etiquetas que son específicas del preprocesamiento del valor de descubrimiento de bajo nivel de la plantilla.
type x cadena 5 - REGEX
11 - XMLPATH
12 - JSONPATH
15 - NOT_MATCHES_REGEX
16 - CHECK_JSON_ERROR
17 - CHECK _XML_ERROR
20 - DESCARTAR_UNCHANGED_HEARTBEAT
21 - JAVASCRIPT
23 - PROMETHEUS_TO_JSON
24 - CSV_TO_JSON
25 - STR_REPLACE
Tipo del paso de preprocesamiento del valor del artículo.
trigger_prototypes - Elemento raíz para prototipos de iniciador.
Para conocer los valores de etiqueta de elemento de prototipo de iniciador, consulte las etiquetas plantilla de iniciador normales.
graph_prototypes - Elemento raíz para prototipos de gráficos.
Para conocer los valores de etiquetas de elementos de prototipos de gráficos, consulte las etiquetas gráfico de plantilla normales.
host_prototypes - Elemento raíz para prototipos de equipos.
Para conocer los valores de etiquetas de elementos del prototipo de equipo, consulte las etiquetas equipo normales.
item_prototypes - Elemento raíz para prototipos de métricas.
Para conocer los valores de las etiquetas del elemento prototipo del artículo, consulte las etiquetas normales de elemento de plantilla.
master_item - Datos del prototipo de métrica individual de la métrica principal/prototipo de métrica.
key x cadena Valor clave del prototipo de métrica principal/valor clave del prototipo de métrica dependiente.

Obligatorio para una métrica dependiente.
Template low-level discovery rule filters
Element Type Description
evaltype string Override filter condition evaluation method.
Possible values:1 AND_OR (0, default), AND (1), OR (2), FORMULA (3).
formula string Custom calculation formula for filter conditions.
conditions Root element for filter conditions.
macro string (required) The name of the low-level discovery macro to perform the check on.
value string Value to compare with.
operator string Condition operator.
Possible values:1 MATCHES_REGEX (8, default), NOT_MATCHES_REGEX (9).
formulaid string (required) Arbitrary unique ID that is used to reference a condition from the custom expression. Can only contain capital-case letters. The ID must be defined by the user when modifying filter conditions, but will be generated anew when requesting them afterward.

See also: LLD rule filter object (refer to the relevant property with a matching name).

Template low-level discovery rule override operations
Element Type Description
operationobject string Object to which the operation is applied.
Possible values:1 ITEM_PROTOTYPE (0), TRIGGER_PROTOTYPE (1), GRAPH_PROTOTYPE (2), HOST_PROTOTYPE (3).
operator string Override condition operator.
Possible values:1 EQUAL (1), NOT_EQUAL (2), LIKE (3), NOT_LIKE (4), REGEXP (5), NOT_REGEXP (6).
value string A regular expression or a string for the override condition operator.
status string Status of the object upon the override operation.
discover string Whether the object is added as a result of the discovery.
delay string Update interval set for the item prototype upon the override operation.
history string History storage period set for the item prototype upon the override operation.
trends string Trend storage period set for the item prototype upon the override operation.
severity string Trigger prototype severity set upon the override operation.
tags Root element for the tags set for the object upon the override operation.
tag string (required) Tag name.
value string Tag value.
templates Root element for the templates linked to the host prototype upon the override operation.
name string (required) Template name.
inventory_mode string Host prototype inventory mode set upon the override operation.

See also: LLD rule override operation object (refer to the relevant property with a matching name).

Etiquetas de plantilla de iniciador
Elemento Propiedad del elemento Obligatorio Tipo Rango1 Descripción
triggers - Elemento raíz para iniciadores.
uuid x cadena Identificador único para este iniciador.
expression x cadena Expresión del iniciador.
recovery_mode - string 0 - EXPRESSION (predeterminado)
1 - RECOVERY_EXPRESSION
2 - NINGUNO
Base para generar eventos OK.
recovery_expression - cadena Expresión de recuperación del iniciador.
correlation_mode - string 0 - DISABLED (predeterminado)
1 - TAG_VALUE
Modo de correlación (sin correlación de eventos o correlación de eventos por etiqueta).
correlation_tag - cadena El nombre de la etiqueta que se utilizará para la correlación de eventos.
name x cadena Nombre del iniciador.
event_name - cadena Nombre del evento.
opdata - cadena Datos operativos.
url_name - cadena Etiqueta de la URL asociada al iniciador.
url - cadena URL asociada al iniciador.
status - string 0 - HABILITADO (predeterminado)
1 - DISABLED
Estado del iniciador.
priority - cadena 0 - NO_CLASIFICADO (predeterminado)
1 - INFORMACIÓN
2 - ADVERTENCIA
3 - PROMEDIO
4 - ALTO
5 - DESASTRE
Activador gravedad.
description - texto Descripción del iniciador.
type - string 0 - SINGLE (predeterminado)
1 - MULTIPLE
Tipo de generación de evento (evento de problema único o eventos de problema múltiple).
manual_close - string 0 - NO (predeterminado)
1 - SÍ
Cierre manual de eventos de problema.
dependencies - Elemento raíz para dependencias.
name x cadena Nombre del iniciador dependiente.
expression x cadena Expresión del iniciador dependiente.
recovery_expression - cadena Expresión de recuperación del iniciador dependiente.
tags - Elemento raíz para etiquetas de activación.
tag x cadena Nombre de etiqueta.
value - cadena Valor de etiqueta.
Etiquetas de plantilla de escenario web
Elemento Propiedad del elemento Obligatorio Tipo Rango1 Descripción
httptests - Elemento raíz para escenarios web.
uuid x cadena Identificador único para este escenario web.
name x cadena Nombre del escenario web.
delay - string Predeterminado: 1m Frecuencia de ejecución del escenario web. Segundos, unidad de tiempo con sufijo o macro de usuario.
attempts - integer 1-10 (predeterminado: 1) El número de intentos para ejecutar los pasos del escenario web.
agent - string Predeterminado: Zabbix Agente cliente. Zabbix pretenderá ser el navegador seleccionado. Esto resulta útil cuando un sitio web devuelve contenido diferente para distintos navegadores.
http_proxy - cadena Especifique un proxy HTTP para usar, usando el formato: http://[nombre de usuario[:contraseña]@]proxy.example.com[:puerto]
variables - Elemento raíz para variables a nivel de escenario (macros) que pueden usarse en los pasos del escenario.
name x cadena Nombre de la variable.
value x texto Valor variable.
headers - Elemento raíz para los encabezados HTTP que se enviarán al realizar una solicitud. Los encabezados deben enumerarse utilizando la misma sintaxis que aparecerían en el protocolo HTTP.
name x cadena Nombre del encabezado.
value x texto Valor del encabezado.
status - string 0 - HABILITADO (predeterminado)
1 - DISABLED
Estado del escenario web.
authentication - string 0 - NINGUNO (predeterminado)
1 - BÁSICO
2 - NTLM
Método de autenticación.
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 - string 0 - NO (predeterminado)
1 - SÍ
Verifique el certificado SSL del servidor web.
verify_host - string 0 - NO (predeterminado)
1 - SÍ
Verifique que el campo nombre común o el campo nombre alternativo del sujeto del certificado del servidor web coincidan.
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.
steps x Elemento raíz para los pasos del escenario web.
name x cadena Nombre del paso del escenario web.
url x cadena URL para seguimiento.
query_fields - Elemento raíz para campos de consulta: una matriz de campos HTTP que se agregarán a la URL al realizar una solicitud.
name x cadena Nombre del campo de consulta.
value - cadena Valor del campo de consulta.
posts - Variables HTTP POST como una cadena (datos de publicación sin procesar) o como una matriz de campos HTTP (datos de campo de formulario).
name x cadena Nombre del campo de publicación.
value x cadena Publicar valor del campo.
variables - Elemento raíz de las variables de nivel de paso (macros) que se deben aplicar 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 al patrón de expresión regular que sigue el prefijo 'regex:'
name x cadena Nombre de la variable.
value x texto Valor variable.
headers - Elemento raíz para los encabezados HTTP que se enviarán al realizar una solicitud. Los encabezados deben enumerarse utilizando la misma sintaxis que aparecerían en el protocolo HTTP.
name x cadena Nombre del encabezado.
value x texto Valor del encabezado.
follow_redirects - string 0 - NO
1 - SÍ (predeterminado)
Seguir redirecciones HTTP.
retrieve_mode - string 0 - CUERPO (predeterminado)
1 - ENCABEZADOS
2 - AMBOS
Modo de recuperación de respuesta HTTP.
timeout - string Predeterminado: 15s Tiempo de espera de ejecución del paso. Segundos, unidad de tiempo con sufijo o macro de usuario.
required - cadena Texto que debe estar presente en la respuesta. Se ignora si está vacío.
status_codes - cadena Una lista delimitada por comas de códigos de estado HTTP aceptados. Se ignora si está vacío. Por ejemplo: 200-201,210-299
tags - Elemento raíz para etiquetas de escenarios web.
tag x cadena Nombre de etiqueta.
value - cadena Valor de etiqueta.
Template web scenario steps
Element Type Description
name string (required) Web scenario step name.
url string (required) URL for monitoring.
query_fields Root element for query parameters (an array of HTTP fields to be added to the URL when performing a request).
name string (required) Query parameter name.
value string Query parameter value.
posts Root element for HTTP POST variables (a string (raw post data) or an array of HTTP fields (form field data)).
name string (required) Post field name.
value string (required) Post field value.
variables Root element of step-level variables (macros) that should be applied after this step.
If the variable value has a 'regex:' prefix, then its value is extracted from the data returned by this step according to the regular expression pattern following the 'regex:' prefix
name string (required) Variable name.
value text (required) Variable value.
headers Root element for HTTP headers to be sent when performing a request.
name string (required) Header name.
value text (required) Header value.
follow_redirects string Follow HTTP redirects.
Possible values:1 NO (0), YES (1, default).
retrieve_mode string HTTP response retrieve mode.
Possible values:1 BODY (0, default), HEADERS (1), BOTH (2).
timeout string Timeout (using seconds, time suffix, or user macro) of step execution.
Default: 15s.
required string Text that must be present in the response (ignored if empty).
status_codes string A comma-delimited list of accepted HTTP status codes (e.g., 200-201,210-299; ignored if empty).

See also: Web scenario step object (refer to the relevant property with a matching name).

Etiquetas de plantilla del tablero
Elemento Propiedad del elemento Obligatorio Tipo Rango1 Descripción
dashboards - Elemento raíz para plantillas de tableros.
uuid x cadena Identificador único para este tablero.
name x cadena Nombre de la plantilla del tablero.
display period - entero Período de visualización de las páginas del tablero.
auto_start - string 0 - no
1 - sí
Inicio automático de presentación de diapositivas.
pages - Elemento raíz para las páginas de la plantilla del 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 páginas.
widgets - Elemento raíz para los widgets de la plantilla del tablero.
type x cadena Tipo de widget.
name - cadena Nombre del widget.
x - integer 0-23 Posición horizontal desde el lado izquierdo del panel de la plantilla.
y - integer 0-62 Posición vertical desde la parte superior del panel de la plantilla.
width - integer 1-24 Ancho del widget.
height - integer 2-32 Altura del widget.
hide_header - string 0 - no
1 - sí
Ocultar encabezado del widget.
fields - Elemento raíz para los campos del widget de la plantilla del tablero.
type x cadena 0 - ENTERO
1 - CADENA
3 - EQUIPO
4 - MÉTRICA
5 - MÉTRICA_PROTOTIPO
6 - GRÁFICO
7 - GRÁFICO _PROTOTIPO
Tipo de campo de widget.
name x cadena Nombre del campo del widget.
value x mixto Valor del campo del widget, según el tipo de campo.
Template dashboard widgets
Element Type Description
type string (required) Widget type.
name string Widget name.
x integer Horizontal position from the left side of the template dashboard.
Possible values:1 0-23.
y integer Vertical position from the top of the template dashboard.
Possible values:1 0-62.
width integer Widget width.
Possible values:1 1-24.
height integer Widget height.
Possible values:1 2-32.
hide_header string Hide widget header.
Possible values:1 NO (0, default), YES (1).
fields Root element for the template dashboard widget fields.
type string (required) Widget field type.
Possible values:1 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 (required) Widget field name.
value mixed (required) Widget field value, depending on the field type.

See also: Template dashboard widget object (refer to the relevant property with a matching name).

Template value maps

Element Type Description
uuid string (required) Unique identifier for this value map.
name string (required) Value map name.
mapping Root element for mappings.
type string Mapping match type.
Possible values:1 EQUAL (0, default), GREATER_OR_EQUAL (2), LESS_OR_EQUAL (3), IN_RANGE (4), REGEXP (5), DEFAULT (6).
value string Original value.
newvalue string (required) Value to which the original value is mapped to.

See also: Value map object (refer to the relevant property with a matching name).

Notas al pie

1 Para valores de cadena, solo se exportará la cadena (p. ej. "ZABBIX_ACTIVE") sin la numeración utilizada en esta tabla. Los números para los valores de rango (correspondientes a los valores API) en esta tabla se utiliza solo para realizar pedidos.