3 Plantillas

Descripción general

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

La exportación de plantillas contiene:

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

Exportar

Para exportar plantillas, haga lo siguiente:

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

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

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

Importar

Para importar templates, haga lo siguiente:

1. Vaya a Recolección de datos → Templates.
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 Todos, todos los elementos debajo de ella se marcarán o desmarcarán.

Reglas de importación:

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

El menú de la izquierda se puede utilizar para navegar por la lista de cambios. La sección Actualizado resalta todos los cambios realizados en los elementos existentes del template. La sección Añadido enumera los nuevos elementos del template. 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 del template y luego haga clic en Importar para realizar la importación del template. Se mostrará un mensaje de éxito o fallo de la importación en el frontend.

Formato de exportación

Cuando se exporta una plantilla, Zabbix genera un formato estructurado en YAML, JSON o XML. La exportación incluye elementos de la plantilla, como metadatos de la plantilla, métricas, macros, disparadores, paneles y más.

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

Las siguientes secciones describen cada elemento en el formato de exportación. Los ejemplos utilizan la plantilla Linux por Zabbix agent.

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

Metadatos de template

zabbix_export:
  version: '7.4'
  template_groups:
    - uuid: 846977d1dfed4968bc5f8bdb363285bc
      name: 'Templates/Operating systems'
  templates: (see table below)
  triggers: (see table below)
  graphs: (see table below)

Templates

zabbix_export:
  (...)
  templates:
    - uuid: f8f7908280354f2abeed07dc788c3747
      template: 'Linux by Zabbix agent'
      name: 'Linux by Zabbix agent'
      description: |
        Esta es una template oficial de Linux. Requiere Zabbix agent 7.4 o una versión posterior. (...)
      wizard_ready: 'YES'
      readme: |
        ## Overview

        Esta es una template oficial de Linux. Requiere Zabbix agent 7.4 o una versión posterior. (...)
      vendor:
        name: Zabbix
        version: 7.4-2
      groups:
        - name: 'Templates/Operating systems'
      items: (see table below)
      discovery_rules: (see table below)
      tags:
        - tag: class
          value: os
        - tag: target
          value: linux
      macros:
        - macro: '{$AGENT.TIMEOUT}'
          value: 3m
          description: 'Tiempo de espera tras el cual el agent se considera no disponible. Solo funciona para agents accesibles desde Zabbix server/proxy (modo pasivo).'
          config: (see table below)
        - macro: '{$CPU.UTIL.CRIT}'
          value: '90'
          description: 'Umbral crítico de utilización de CPU expresado en %.'
          config: (see table below)
        (...)
      dashboards: (see table below)
      valuemaps: (see table below)
    (...)

Elementos 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 usarse 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: (see table below)
          tags:
            - tag: component
              value: os
          triggers: (see table below)
        - uuid: 403cebed115441369e94d35d070ca7b8
          name: 'Memory utilization'
          type: DEPENDENT
          key: vm.memory.utilization
          value_type: FLOAT
          units: '%'
          description: 'El porcentaje de memoria usada se calcula como `100-pavailable`.'
          preprocessing: (see table below)
          master_item:
            key: 'vm.memory.size[pavailable]'
          tags:
            - tag: component
              value: memory
          triggers: (see table below)
        (...)

Pasos de preprocesamiento de valores de métricas de plantilla

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

Disparadores de métricas de plantilla

zabbix_export:
  (...)
  templates:
    (...)
      items:
        (...)
        - uuid: 58818005e76d46dda14d6592f601ab00
          (...)
          triggers:
            - uuid: b950c306394f4b3c902060a8273cbcde
              expression: 'change(/Linux by Zabbix agent/system.sw.packages.get)<>0'
              name: 'Linux: El número de paquetes instalados ha cambiado'
              priority: WARNING
              manual_close: 'YES'
              tags:
                - tag: scope
                  value: notice
        (...)
        - uuid: 403cebed115441369e94d35d070ca7b8
          (...)
          triggers:
            - uuid: cfd395b1cde74ef18a5e5f840bd5142a
              expression: 'min(/Linux by Zabbix agent/vm.memory.utilization,5m)>{$MEMORY.UTIL.MAX}'
              name: 'Linux: Alta utilización de memoria'
              event_name: 'Linux: Alta utilización de memoria (>{$MEMORY.UTIL.MAX}% durante 5m)'
              priority: AVERAGE
              description: 'El sistema se está quedando sin memoria libre.'
              dependencies:
                - name: 'Linux: Falta de memoria disponible'
                  expression: 'max(/Linux by Zabbix agent/vm.memory.size[available],5m)<{$MEMORY.AVAILABLE.MIN} and last(/Linux by Zabbix agent/vm.memory.size[total])>0'
              tags:
                - tag: scope
                  value: capacity
                - tag: scope
                  value: performance
        (...)

Reglas de descubrimiento de bajo nivel de plantilla

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

Filtros de reglas de bajo nivel de descubrimiento de plantillas

zabbix_export:
  (...)
  templates:
    (...)
      discovery_rules:
        - uuid: acfdea9c46ef48c68e6636f43b8f96a2
          (...)
          filter:
            evaltype: AND
            conditions:
              - macro: '{#IFNAME}'
                value: '{$NET.IF.IFNAME.MATCHES}'
              - macro: '{#IFNAME}'
                value: '{$NET.IF.IFNAME.NOT_MATCHES}'
                operator: NOT_MATCHES_REGEX
          (...)
        - uuid: 2bbdc79f082d4c618e01bec625e9c90a
          (...)
          filter:
            evaltype: AND
            conditions:
              - macro: '{#DEVNAME}'
                value: '{$VFS.DEV.DEVNAME.MATCHES}'
              - macro: '{#DEVNAME}'
                value: '{$VFS.DEV.DEVNAME.NOT_MATCHES}'
                operator: NOT_MATCHES_REGEX
              - macro: '{#DEVTYPE}'
                value: disk
          (...)

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

Escenarios web de la template

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

Paneles de plantilla

zabbix_export:
  (...)
  templates:
    (...)
      dashboards:
        - uuid: c689ad3115fd46a4b927d1f70ee2e5a4
          name: Sistemas de archivos
          pages:
            - name: Resumen
              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 by Zabbix agent'
                        name: 'FS [{#FSTYPE}({#FSNAME})]: Gráfico de utilización de espacio (relativo al total)'
                    - type: STRING
                      name: reference
                      value: AAAEB
                - type: graphprototype
                  'y': '5'
                  width: '72'
                  height: '5'
                  fields:
                    - type: INTEGER
                      name: columns
                      value: '1'
                    - type: GRAPH_PROTOTYPE
                      name: graphid.0
                      value:
                        host: 'Linux by Zabbix agent'
                        name: 'FS [{#FSTYPE}({#FSNAME})]: Gráfico de uso de espacio, en % (relativo al máximo disponible)'
                    - type: STRING
                      name: reference
                      value: AAAEC
        (...)

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 la API entre corchetes, por ejemplo, ENABLED (0), se mencionan solo como referencia. Para obtener más información, consulte la página del objeto API enlazada en la entrada de la tabla o al final de cada sección.