Plantillas

Resumen

Los templates se exportan con muchos objetos relacionados y relaciones entre objetos.

La exportación de templates contiene:

• Grupos de templates vinculados
• Grupos de hosts vinculados (si se usan en la configuración de host prototype)
• Datos del template
• Vinculación con otros templates
• Vinculación con grupos de templates
• items vinculados directamente
• triggers vinculados directamente
• gráficos vinculados directamente
• paneles vinculados directamente
• reglas de descubrimiento vinculadas directamente con todos los prototipos
• escenarios web vinculados directamente
• Mapas de valores

Exportación

Para exportar templates, haga lo siguiente:

1. Vaya a Data collection > Templates.
2. Marque las casillas de verificación de los templates que desea exportar.
3. Haga clic en Export debajo de la lista.

Según el formato seleccionado, los templates se exportan a un archivo local con un nombre predeterminado:

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

Importación

Para importar templates, haga lo siguiente:

1. Vaya a Data collection > Templates.
2. Haga clic en Import en la esquina superior derecha.
3. Seleccione el archivo de importación.
4. Haga clic en Import en la esquina inferior derecha del formulario de configuración.

Si marca la casilla Advanced options, 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 All, se marcarán o desmarcarán todos los elementos que aparecen debajo.

Reglas de importación:

En la siguiente pantalla, podrá ver el contenido de un template que se está importando. Si se trata de un template nuevo, todos los elementos se mostrarán en verde. Si se actualiza 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 sobre un fondo gris.

El menú de la izquierda puede utilizarse para navegar por la lista de cambios. La sección Updated resalta todos los cambios realizados en los elementos existentes del template. La sección Added 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 Import para realizar la importación del template. En el frontend se mostrará un mensaje de éxito o de error de la importación.

Formato de exportación

Cuando se exporta un template, Zabbix genera un formato estructurado YAML, JSON o XML. La exportación incluye elementos del template, como metadatos del template, items, macros, triggers, dashboards y más.

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

Las siguientes secciones describen cada elemento del formato de exportación. Los ejemplos usan el template Linux by Zabbix agent.

Una elipsis (...) indica elementos omitidos por brevedad. La nota (see table below) se usa cuando el elemento se explica con más detalle en secciones posteriores.

Metadatos de template

zabbix_export:
  version: '8.0'
  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 8.0 o una versión posterior. (...)
      wizard_ready: 'YES'
      readme: |
        ## Descripción general

        Esta es una template oficial de Linux. Requiere Zabbix agent 8.0 o una versión posterior. (...)
      vendor:
        name: Zabbix
        version: 8.0-2
      groups:
        - name: 'Templates/Sistemas operativos'
      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 del 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 utilizada 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 del valor del item de template

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

Triggers de item de template

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: Alto uso de memoria'
              event_name: 'Linux: Alto uso 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 template

zabbix_export:
  (...)
  templates:
    (...)
      discovery_rules:
        - uuid: acfdea9c46ef48c68e6636f43b8f96a2
          name: 'Network interface discovery'
          key: net.if.discovery
          delay: 1h
          filter: (see table below)
          description: 'The discovery of network interfaces.'
          item_prototypes: (see table below)
          trigger_prototypes: (see table below)
          graph_prototypes: (see table below)
        (...)

Filtros de la regla de descubrimiento de bajo nivel de template

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 la regla de descubrimiento de bajo nivel de template

Escenarios web de template

Pasos del escenario web de template

Configuración de macros de template

zabbix_export:
  (...)
  templates:
    - uuid: f8f7908280354f2abeed07dc788c3747
      (...)
      macros:
        - macro: '{$AGENT.TIMEOUT}'
          (...)
          config:
            type: TEXT
            priority: '1'
            label: 'Segundos desde la última vez que se detectó el agent de Zabbix'
            description: 'Tiempo de espera tras el cual se considera que el agent no está disponible.'
        - macro: '{$CPU.UTIL.CRIT}'
          (...)
          config:
            type: TEXT
            priority: '2'
            section_name: Thresholds
            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: 'Genera un trigger cuando el estado operativo de la interfaz cambia a "Link down".'
            options:
              - checked: '1'
                unchecked: '0'
        (...)

Paneles de control de template

zabbix_export:
  (...)
  templates:
    (...)
      dashboards:
        - uuid: c689ad3115fd46a4b927d1f70ee2e5a4
          name: Filesystems
          pages:
            - name: Overview
              widgets: (see table below)
        (...)

Widgets del dashboard de template

zabbix_export:
  (...)
  templates:
    (...)
      dashboards:
        - uuid: c689ad3115fd46a4b927d1f70ee2e5a4
          name: Filesystems
          pages:
            - name: Overview
              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})]: Space utilization chart (relative to 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})]: Space usage graph, in % (relative to max available)'
                    - type: STRING
                      name: reference
                      value: AAAEC
        (...)

Mapas de valores de template

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