Esta página fue traducida automáticamente. Si detectas un error, selecciónalo y presiona Ctrl+Enter para informarlo a los editores.

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:

  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 Recopilación de datosPlantillas.
  2. Haga clic en Importar en la esquina superior derecha.
  3. Seleccione el archivo de importación.
  4. Haga clic en Importar en la esquina inferior derecha del formulario de configuración.

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

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

Reglas de importación:

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

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

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

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

Formato de exportación

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

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

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

Se utiliza como ejemplo la plantilla Linux por agente Zabbix.

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

Metadatos de la plantilla

zabbix_export:
         version: '7.4'
         template_groups:
           - uuid: 846977d1dfed4968bc5f8bdb363285bc
             name: 'Plantillas/Sistemas operativos'
         templates: (ver tabla abajo)
         triggers: (ver tabla abajo)
         graphs: (ver tabla abajo)
Elemento Tipo Descripción
version cadena (obligatorio) Versión de exportación.
template_groups (obligatorio) Elemento raíz para los grupos de plantillas.
uuid cadena (obligatorio) Identificador único para este grupo de plantillas.
name cadena (obligatorio) Nombre del grupo de plantillas.
host_groups Elemento raíz para los grupos de equipos que son usados por los prototipos de equipos.
uuid cadena (obligatorio) Identificador único para este grupo de equipos.
name cadena (obligatorio) Nombre del grupo de equipos.
templates Elemento raíz para las plantillas.
triggers Elemento raíz para los elementos de disparadores de plantilla, que son los mismos que para los disparadores de elementos de plantilla.
graphs Elemento raíz para los elementos de gráficos de plantilla, que son los mismos que para los gráficos de equipos.

Plantillas

zabbix_export:
         (...)
         templates:
           - uuid: f8f7908280354f2abeed07dc788c3747
             template: 'Linux por agente Zabbix'
             name: 'Linux por agente Zabbix'
             description: |
               Esta es una plantilla oficial de Linux. Requiere el agente Zabbix 7.4 o superior. (...)
             wizard_ready: 'YES'
             readme: |
               ## Descripción general
               
               Esta es una plantilla oficial de Linux. Requiere el agente Zabbix 7.4 o superior. (...)
             vendor:
               name: Zabbix
               version: 7.4-2
             groups:
               - name: 'Plantillas/Sistemas operativos'
             items: (ver tabla abajo)
             discovery_rules: (ver tabla abajo)
             tags:
               - tag: class
                 value: os
               - tag: target
                 value: linux
             macros:
               - macro: '{$AGENT.TIMEOUT}'
                 value: 3m
                 description: 'Tiempo de espera tras el cual el agente se considera no disponible. Solo funciona para agentes accesibles desde el servidor/proxy Zabbix (modo pasivo).'
                 config: (ver tabla abajo)
               - macro: '{$CPU.UTIL.CRIT}'
                 value: '90'
                 description: 'Umbral crítico de utilización de CPU expresado en %.'
                 config: (ver tabla abajo)
               (...)
             dashboards: (ver tabla abajo)
             valuemaps: (ver tabla abajo)
           (...)
Elemento Tipo Descripción
uuid cadena (obligatorio) Identificador único para esta plantilla.
template cadena (obligatorio) Nombre único de la plantilla.
name cadena Nombre visible de la plantilla.
description texto Descripción de la plantilla.
wizard_ready texto Indica si la plantilla está disponible para su selección en el Asistente de Hosts.
Valores posibles:1 NO (0, por defecto), YES (1).
Ver también: Objeto plantilla (wizard_ready).
readme texto Instrucciones de configuración específicas de la plantilla que se mostrarán en el Asistente de Hosts. Soporta formato Markdown.
vendor Elemento raíz para el proveedor de la plantilla (presente si la plantilla exportada contiene datos del proveedor).
name cadena (obligatorio) Nombre del proveedor de la plantilla.
version cadena (obligatorio) Versión de la plantilla.
Para plantillas integradas, la versión se muestra de la siguiente manera: versión principal de Zabbix, delimitador ("-"), número de revisión (aumenta con cada nueva versión de la plantilla y se reinicia con cada versión principal de Zabbix). Por ejemplo, 7.0-0, 7.0-3, 7.4-0, 7.4-3.
templates Elemento raíz para plantillas enlazadas.
name cadena (obligatorio) Nombre de la plantilla.
groups Elemento raíz para grupos de plantillas.
name cadena (obligatorio) Nombre del grupo de plantillas.
items Elemento raíz para elementos de plantilla.
discovery_rules Elemento raíz para reglas de bajo nivel de descubrimiento de plantilla.
httptests Elemento raíz para escenarios web de plantilla.
tags Elemento raíz para etiquetas de plantilla.
tag cadena (obligatorio) Nombre de la etiqueta.
value cadena Valor de la etiqueta.
macros Elemento raíz para macros de usuario de plantilla.
macro cadena (obligatorio) Nombre de la macro de usuario.
type cadena Tipo de macro de usuario.
Valores posibles:1 TEXT (0, por defecto), SECRET_TEXT (1), VAULT (2).
Ver también: Objeto macro de usuario (type).
value cadena Valor de la macro de usuario.
description cadena Descripción de la macro de usuario.
config Elemento raíz para la configuración de macro de plantilla responsable de cómo se muestra la macro en el Asistente de Hosts.
dashboards Elemento raíz para paneles de plantilla.
valuemaps Elemento raíz para mapas de valores de plantilla.

Elementos de la plantilla

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

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

Pasos de preprocesamiento de valores de elementos de plantilla
zabbix_export:
         (...)
         templates:
           (...)
             items:
               (...)
               - uuid: 58818005e76d46dda14d6592f601ab00
                 (...)
                 preprocessing:
                   - type: JSONPATH
                     parameters:
                       - $.length()
                   - type: DISCARD_UNCHANGED_HEARTBEAT
                     parameters:
                       - 12h
                 (...)
Elemento Tipo Descripción
type cadena (obligatorio) El tipo de paso de preprocesamiento del valor del elemento.
Valores posibles: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, calculado: valor recibido - valor anterior), CHANGE_PER_SECOND (10, calculado: (valor recibido - valor anterior)/(hora actual - hora de la última comprobación)), XMLPATH (11), JSONPATH (12), IN_RANGE (13), MATCHES_REGEX (14), NOT_MATCHES_REGEX (15), CHECK_JSON_ERROR (16), CHECK_XML_ERROR (17), CHECK_REGEX_ERROR (18), DISCARD_UNCHANGED (19), DISCARD_UNCHANGED_HEARTBEAT (20), JAVASCRIPT (21), PROMETHEUS_PATTERN (22), PROMETHEUS_TO_JSON (23), CSV_TO_JSON (24), STR_REPLACE (25), CHECK_NOT_SUPPORTED (26), XML_TO_JSON (27), SNMP_WALK_VALUE (28), SNMP_WALK_TO_JSON (29), SNMP_GET_VALUE (30).
parameters (obligatorio) Elemento raíz para los parámetros del paso de preprocesamiento del valor del elemento.
parameter cadena Parámetro individual del paso de preprocesamiento del valor del elemento.
error_handler cadena Tipo de acción utilizada en caso de fallo del paso de preprocesamiento.
Valores posibles:1 ORIGINAL_ERROR (0, por defecto), DISCARD_VALUE (1), CUSTOM_VALUE (2), CUSTOM_ERROR (3).
error_handler_params cadena Parámetros del gestor de errores.

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

Disparadores de elementos de plantilla
zabbix_export:
         (...)
         templates:
           (...)
             items:
               (...)
               - uuid: 58818005e76d46dda14d6592f601ab00
                 (...)
                 triggers:
                   - uuid: b950c306394f4b3c902060a8273cbcde
                     expression: 'change(/Linux by Zabbix agent/system.sw.packages.get)<>0'
                     name: 'Linux: El número de paquetes instalados ha cambiado'
                     priority: WARNING
                     manual_close: 'YES'
                     tags:
                       - tag: scope
                         value: notice
               (...)
               - uuid: 403cebed115441369e94d35d070ca7b8
                 (...)
                 triggers:
                   - uuid: cfd395b1cde74ef18a5e5f840bd5142a
                     expression: 'min(/Linux by Zabbix agent/vm.memory.utilization,5m)>{$MEMORY.UTIL.MAX}'
                     name: 'Linux: Alta utilización de memoria'
                     event_name: 'Linux: Alta utilización de memoria (>{$MEMORY.UTIL.MAX}% durante 5m)'
                     priority: AVERAGE
                     description: 'El sistema se está quedando sin memoria libre.'
                     dependencies:
                       - name: 'Linux: Falta de memoria disponible'
                         expression: 'max(/Linux by Zabbix agent/vm.memory.size[available],5m)<{$MEMORY.AVAILABLE.MIN} and last(/Linux by Zabbix agent/vm.memory.size[total])>0'
                     tags:
                       - tag: scope
                         value: capacity
                       - tag: scope
                         value: performance
               (...)
Elemento Tipo Descripción
uuid cadena (requerido) Identificador único para este disparador.
expression cadena (requerido) Expresión del disparador.
recovery_mode cadena Base para generar eventos OK.
Valores posibles:1 EXPRESSION (0, por defecto), RECOVERY_EXPRESSION (1), NONE (2).
recovery_expression cadena Expresión de recuperación del disparador.
correlation_mode cadena Modo de correlación (sin correlación de eventos o correlación de eventos por etiqueta).
Valores posibles:1 DISABLED (0, por defecto), TAG_VALUE (1).
correlation_tag cadena El nombre de la etiqueta que se utilizará para la correlación de eventos.
name cadena (requerido) Nombre del disparador.
event_name cadena Nombre del evento.
opdata cadena Datos operativos.
url_name cadena Etiqueta para la URL asociada al disparador.
url cadena URL asociada al disparador.
status cadena Estado del disparador.
Valores posibles:1 ENABLED (0, por defecto), DISABLED (1).
priority cadena Severidad del disparador.
Valores posibles:1 NOT_CLASSIFIED (0, por defecto), INFO (1), WARNING (2), AVERAGE (3), HIGH (4), DISASTER (5).
description texto Descripción del disparador.
type cadena Tipo de generación de eventos (evento de problema único o múltiples eventos de problema).
Valores posibles:1 SINGLE (0, por defecto), MULTIPLE (1).
manual_close cadena Cierre manual de eventos de problema.
Valores posibles:1 NO (0, por defecto), YES (1).
dependencies Elemento raíz para dependencias.
name cadena (requerido) Nombre del disparador de dependencia.
expression cadena (requerido) Expresión del disparador de dependencia.
recovery_expression cadena Expresión de recuperación del disparador de dependencia.
tags Elemento raíz para etiquetas del disparador.
tag cadena (requerido) Nombre de la etiqueta.
value cadena Valor de la etiqueta.

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

Reglas de descubrimiento de bajo nivel de la plantilla

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

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

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

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

Filtros de reglas de descubrimiento de bajo nivel de la plantilla
zabbix_export:
         (...)
         templates:
           (...)
             discovery_rules:
               - uuid: acfdea9c46ef48c68e6636f43b8f96a2
                 (...)
                 filter:
                   evaltype: AND
                   conditions:
                     - macro: '{#IFNAME}'
                       value: '{$NET.IF.IFNAME.MATCHES}'
                     - macro: '{#IFNAME}'
                       value: '{$NET.IF.IFNAME.NOT_MATCHES}'
                       operator: NOT_MATCHES_REGEX
                 (...)
               - uuid: 2bbdc79f082d4c618e01bec625e9c90a
                 (...)
                 filter:
                   evaltype: AND
                   conditions:
                     - macro: '{#DEVNAME}'
                       value: '{$VFS.DEV.DEVNAME.MATCHES}'
                     - macro: '{#DEVNAME}'
                       value: '{$VFS.DEV.DEVNAME.NOT_MATCHES}'
                       operator: NOT_MATCHES_REGEX
                     - macro: '{#DEVTYPE}'
                       value: disk
                 (...)
Elemento Tipo Descripción
evaltype cadena Sobrescribe el método de evaluación de la condición del filtro.
Valores posibles:1 AND_OR (0, por defecto), AND (1), OR (2), FORMULA (3).
formula cadena Fórmula de cálculo personalizada para las condiciones del filtro.
conditions Elemento raíz para las condiciones del filtro.
macro cadena (requerido) El nombre de la macro de descubrimiento de bajo nivel sobre la que realizar la comprobación.
value cadena Valor con el que comparar.
operator cadena Operador de condición.
Valores posibles:1 MATCHES_REGEX (8, por defecto), NOT_MATCHES_REGEX (9).
formulaid cadena (requerido) ID único arbitrario que se utiliza para hacer referencia a una condición desde la expresión personalizada. Solo puede contener letras mayúsculas. El ID debe ser definido por el usuario al modificar las condiciones del filtro, pero se generará de nuevo al solicitarlas posteriormente.

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

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

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

Escenarios web de plantilla

Elemento Tipo Descripción
uuid cadena (obligatorio) Identificador único para este escenario web.
name cadena (obligatorio) Nombre del escenario web.
delay cadena Frecuencia (usando segundos, sufijo de tiempo, o macro de usuario) de ejecución del escenario web.
Predeterminado: 1m.
attempts entero El número de intentos para ejecutar los pasos del escenario web.
Valores posibles:1 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:1 HABILITADO (0, predeterminado), DESHABILITADO (1).
authentication cadena Método de autenticación.
Valores posibles:1 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:1 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:1 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:1 NO (0), SÍ (1, predeterminado).
retrieve_mode cadena Modo de recuperación de respuesta HTTP.
Valores posibles:1 BODY (0, predeterminado), HEADERS (1), BOTH (2).
timeout cadena Tiempo de espera (usando segundos, sufijo de tiempo, o macro de usuario) de ejecución del paso.< br>Predeterminado: 15 s.
required cadena Texto que debe estar presente en la respuesta (ignorado si está vacío).
status_codes cadena Una lista delimitada por comas de códigos de estado HTTP aceptados (por ejemplo, 200-201,210-299; ignorado si está vacío).

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

Configuración de macro de plantilla

zabbix_export:
         (...)
         templates:
           - uuid: f8f7908280354f2abeed07dc788c3747
             (...)
             macros:
               - macro: '{$AGENT.TIMEOUT}'
                 (...)
                 config:
                   type: TEXT
                   priority: '1'
                   label: 'Segundos desde la última vez que se vio el agente Zabbix'
                   description: 'Tiempo de espera tras el cual el agente se considera no disponible.'
               - macro: '{$CPU.UTIL.CRIT}'
                 (...)
                 config:
                   type: TEXT
                   priority: '2'
                   section_name: Umbrales
                   label: 'Umbral de utilización de CPU expresado'
                   description: 'Umbral crítico de utilización de CPU expresado en %. En el rango de 0 a 100 inclusive.'
                   regex: '^-?([0-9]+|(([0-9]+)\.([0-9]+)))$'
               (...)
               - macro: '{$IFCONTROL}'
                 (...)
                 config:
                   type: CHECKBOX
                   priority: '19'
                   label: 'Control de interfaces'
                   description: 'Disparar un disparador cuando el estado operativo de la interfaz cambie a "Enlace caído".'
                   options:
                     - checked: '1'
                       unchecked: '0'
               (...)
Elemento Tipo Descripción
type cadena (obligatorio) Tipo de campo de entrada de macro.
Valores posibles:1 NOCONF (0), TEXT (1), LIST (2), CHECKBOX (3).
priority cadena Posición de la macro en la lista de macros.
section_name cadena Etiqueta de la sección plegable donde se agrupa la macro.
label cadena (obligatorio para macros TEXT, LIST, CHECKBOX) Etiqueta de la macro.
description texto Texto de ayuda de la macro. Soporta formato Markdown.
required cadena Marca la macro como obligatoria.
Valores posibles:1 NO (0), YES (1).
Soportado para macros TEXT y LIST.
regex cadena Expresión regular para validar la entrada del usuario en un campo de texto.
Soportado para macros TEXT.
options Elemento raíz para los elementos de LIST o valores de CHECKBOX.
value cadena (obligatorio para macros LIST) Valor del elemento de LIST.
text cadena (obligatorio para macros LIST) Texto del elemento de LIST.
checked cadena (obligatorio para macros CHECKBOX) Valor que representa un estado marcado.
Valores posibles:1 0 (falso), 1 (verdadero).
Soportado para macros CHECKBOX.
unchecked cadena (obligatorio para macros CHECKBOX) Valor que representa un estado desmarcado.
Valores posibles:1 0 (falso), 1 (verdadero).
Soportado para macros CHECKBOX.

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

Plantillas de tablero

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

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

Widgets del panel de la plantilla
zabbix_export:
         (...)
         templates:
           (...)
             dashboards:
               - uuid: c689ad3115fd46a4b927d1f70ee2e5a4
                 name: Sistemas de archivos
                 pages:
                   - name: Resumen
                     widgets:
                       - type: graphprototype
                         width: '72'
                         height: '5'
                         fields:
                           - type: INTEGER
                             name: columns
                             value: '3'
                           - type: GRAPH_PROTOTYPE
                             name: graphid.0
                             value:
                               host: 'Linux por agente Zabbix'
                               name: 'FS [{#FSTYPE}({#FSNAME})]: Gráfico de utilización de espacio (relativo al total)'
                           - type: STRING
                             name: reference
                             value: AAAEB
                       - type: graphprototype
                         'y': '5'
                         width: '72'
                         height: '5'
                         fields:
                           - type: INTEGER
                             name: columns
                             value: '1'
                           - type: GRAPH_PROTOTYPE
                             name: graphid.0
                             value:
                               host: 'Linux por agente Zabbix'
                               name: 'FS [{#FSTYPE}({#FSNAME})]: Gráfico de uso de espacio, en % (relativo al máximo disponible)'
                           - type: STRING
                             name: reference
                             value: AAAEC
               (...)
Elemento Tipo Descripción
type string (requerido) Tipo de widget.
name string Nombre del widget.
x integer Posición horizontal desde el lado izquierdo del panel de la plantilla.
Valores posibles:1 0-71.
y integer Posición vertical desde la parte superior del panel de la plantilla.
Valores posibles:1 0-63.
width integer Ancho del widget.
Valores posibles:1 1-72.
height integer Alto del widget.
Valores posibles:1 1-64.
hide_header string Ocultar el encabezado del widget.
Valores posibles:1 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: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 (requerido) Nombre del campo del widget.
value mixed (requerido) Valor del campo del widget, dependiendo del tipo de campo.

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

Mapas de valores de la plantilla

zabbix_export:
         (...)
         templates:
           (...)
             valuemaps:
               - uuid: 8c048c6cca8248f2860c208e8db0f59e
                 name: ifOperStatus
                 mappings:
                   - value: '0'
                     newvalue: unknown
                   - value: '1'
                     newvalue: notpresent
                   - value: '2'
                     newvalue: down
                   - value: '3'
                     newvalue: lowerlayerdown
                   - value: '4'
                     newvalue: testing
                   - value: '5'
                     newvalue: dormant
                   - value: '6'
                     newvalue: up
               (...)
Elemento Tipo Descripción
uuid cadena (requerido) Identificador único para este mapa de valores.
name cadena (requerido) Nombre del mapa de valores.
mapping Elemento raíz para las asignaciones.
type cadena Tipo de coincidencia de asignación.
Valores posibles:1 EQUAL (0, por defecto), GREATER_OR_EQUAL (2), LESS_OR_EQUAL (3), IN_RANGE (4), REGEXP (5), DEFAULT (6).
value cadena Valor original.
newvalue cadena (requerido) Valor al que se asigna el valor original.

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

Notas al pie

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