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 datos → Plantillas.
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 datos → Plantillas.
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:

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)

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

Items de template

zabbix_export:
  (...)
  templates:
    (...)
      items:
        - uuid: f94f9f4699e94c369e6c98b2a2f485ce
          name: 'Zabbix agent ping'
          key: agent.ping
          description: 'El agent siempre devuelve "1" para este item. Puede utilizarse en combinación con `nodata()` para la comprobación de disponibilidad.'
          valuemap:
            name: 'Zabbix agent ping status'
          tags:
            - tag: component
              value: system
        (...)
        - uuid: 58818005e76d46dda14d6592f601ab00
          name: 'Number of installed packages'
          key: system.sw.packages.get
          delay: 1h
          preprocessing: (ver tabla abajo)
          tags:
            - tag: component
              value: os
          triggers: (ver tabla abajo)
        - uuid: 403cebed115441369e94d35d070ca7b8
          name: 'Memory utilization'
          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)
        (...)

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

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

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

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

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

Escenarios web de la plantilla

Pasos del escenario web de la plantilla

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

Plantillas de tablero

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

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

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

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.