3 Vorlagen

Übersicht

Vorlagen werden zusammen mit vielen zugehörigen Objekten und Objektbeziehungen exportiert.

Der Export einer Vorlage enthält:

• Verknüpfte Vorlagengruppen
• Verknüpfte Host-Gruppen (falls in der Konfiguration von Host-Prototypen verwendet)
• Vorlagendaten
• Verknüpfungen zu anderen Vorlagen
• Verknüpfungen zu Vorlagengruppen
• Direkt verknüpfte Datenpunkte
• Direkt verknüpfte Auslöser
• Direkt verknüpfte Diagramme
• Direkt verknüpfte Dashboards
• Direkt verknüpfte Discovery-Regeln mit allen Prototypen
• Direkt verknüpfte Webszenarien
• Wertezuordnungen

Exportieren

Um Vorlagen zu exportieren, gehen Sie wie folgt vor:

1. Gehen Sie zu Datensammlung → Vorlagen.
2. Markieren Sie die Kontrollkästchen der zu exportierenden Vorlagen.
3. Klicken Sie unterhalb der Liste auf Exportieren.

Je nach ausgewähltem Format werden Vorlagen in eine lokale Datei mit einem Standardnamen exportiert:

• zabbix_export_templates.yaml - beim YAML-Export (Standardoption für den Export);
• zabbix_export_templates.xml - beim XML-Export;
• zabbix_export_templates.json - beim JSON-Export.

Importieren

Um Vorlagen zu importieren, gehen Sie wie folgt vor:

1. Gehen Sie zu Datenerfassung → Vorlagen.
2. Klicken Sie oben rechts auf Importieren.
3. Wählen Sie die Importdatei aus.
4. Klicken Sie unten rechts im Konfigurationsformular auf Importieren.

Wenn Sie das Kontrollkästchen Erweiterte Optionen aktivieren, wird eine detaillierte Liste aller importierbaren Elemente angezeigt – markieren oder deaktivieren Sie jede Importregel nach Bedarf.

Wenn Sie auf das Kontrollkästchen in der Zeile Alle klicken, werden alle darunterliegenden Elemente markiert/deaktiviert.

Importregeln:

Auf dem nächsten Bildschirm können Sie den Inhalt einer zu importierenden Vorlage anzeigen. Wenn es sich um eine neue Vorlage handelt, werden alle Elemente grün aufgelistet. Wenn eine vorhandene Vorlage aktualisiert wird, werden neue Vorlagenelemente grün hervorgehoben; entfernte Vorlagenelemente werden rot hervorgehoben; Elemente, die sich nicht geändert haben, werden auf grauem Hintergrund aufgelistet.

Das Menü auf der linken Seite kann verwendet werden, um durch die Liste der Änderungen zu navigieren. Der Abschnitt Aktualisiert hebt alle Änderungen hervor, die an vorhandenen Vorlagenelementen vorgenommen wurden. Der Abschnitt Hinzugefügt listet neue Vorlagenelemente auf. Die Elemente in jedem Abschnitt sind nach Elementtyp gruppiert; klicken Sie auf den grauen Pfeil, um die Elementgruppe ein- oder auszuklappen.

Überprüfen Sie die Änderungen an der Vorlage und klicken Sie dann auf Importieren, um den Vorlagenimport durchzuführen. Im Frontend wird eine Erfolgs- oder Fehlermeldung zum Import angezeigt.

Exportformat

Wenn eine Vorlage exportiert wird, erzeugt Zabbix ein strukturiertes YAML-, JSON- oder XML-Format. Der Export umfasst Vorlagenelemente wie Vorlagenmetadaten, Datenpunkte, Makros, Auslöser, Dashboards und mehr.

Jedes Element erfüllt einen bestimmten Zweck und kann verschachtelte Elemente enthalten.

In den folgenden Abschnitten wird jedes Element im Exportformat beschrieben. In den Beispielen wird die Vorlage Linux by Zabbix agent verwendet.

Eine Auslassung (...) kennzeichnet Elemente, die der Kürze halber ausgelassen wurden. Der Hinweis (see table below) wird verwendet, wenn das Element in späteren Abschnitten ausführlicher erläutert wird.

Metadaten der Vorlage

zabbix_export:
  version: '8.0'
  template_groups:
    - uuid: 846977d1dfed4968bc5f8bdb363285bc
      name: 'Templates/Operating systems'
  templates: (siehe Tabelle unten)
  triggers: (siehe Tabelle unten)
  graphs: (siehe Tabelle unten)

Vorlagen

zabbix_export:
  (...)
  templates:
    - uuid: f8f7908280354f2abeed07dc788c3747
      template: 'Linux by Zabbix agent'
      name: 'Linux by Zabbix agent'
      description: |
        Dies ist eine offizielle Linux-Vorlage. Sie erfordert Zabbix agent 8.0 oder neuer. (...)
      wizard_ready: 'YES'
      readme: |
        ## Übersicht

        Dies ist eine offizielle Linux-Vorlage. Sie erfordert Zabbix agent 8.0 oder neuer. (...)
      vendor:
        name: Zabbix
        version: 8.0-2
      groups:
        - name: 'Templates/Operating systems'
      items: (siehe Tabelle unten)
      discovery_rules: (siehe Tabelle unten)
      tags:
        - tag: class
          value: os
        - tag: target
          value: linux
      macros:
        - macro: '{$AGENT.TIMEOUT}'
          value: 3m
          description: 'Zeitüberschreitung, nach der der Agent als nicht verfügbar betrachtet wird. Funktioniert nur für Agents, die vom Zabbix Server/Proxy aus erreichbar sind (passiver Modus).'
          config: (siehe Tabelle unten)
        - macro: '{$CPU.UTIL.CRIT}'
          value: '90'
          description: 'Kritischer Schwellenwert der CPU-Auslastung, ausgedrückt in %.'
          config: (siehe Tabelle unten)
        (...)
      dashboards: (siehe Tabelle unten)
      valuemaps: (siehe Tabelle unten)
    (...)

Vorlagen-Datenpunkte

zabbix_export:
  (...)
  templates:
    (...)
      items:
        - uuid: f94f9f4699e94c369e6c98b2a2f485ce
          name: 'Zabbix-Agent-Ping'
          key: agent.ping
          description: 'Der Agent gibt für diesen Datenpunkt immer "1" zurück. Kann in Kombination mit `nodata()` für die Verfügbarkeitsprüfung verwendet werden.'
          valuemap:
            name: 'Zabbix-Agent-Ping-Status'
          tags:
            - tag: component
              value: system
        (...)
        - uuid: 58818005e76d46dda14d6592f601ab00
          name: 'Anzahl installierter Pakete'
          key: system.sw.packages.get
          delay: 1h
          preprocessing: (siehe Tabelle unten)
          tags:
            - tag: component
              value: os
          triggers: (siehe Tabelle unten)
        - uuid: 403cebed115441369e94d35d070ca7b8
          name: 'Speicherauslastung'
          type: DEPENDENT
          key: vm.memory.utilization
          value_type: FLOAT
          units: '%'
          description: 'Der Prozentsatz des verwendeten Speichers wird als `100-pavailable` berechnet.'
          preprocessing: (siehe Tabelle unten)
          master_item:
            key: 'vm.memory.size[pavailable]'
          tags:
            - tag: component
              value: memory
          triggers: (siehe Tabelle unten)
        (...)

Vorlagen-Datenpunkt-Wertvorverarbeitungsschritte

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

Auslöser von Vorlagen-Datenpunkten

zabbix_export:
  (...)
  templates:
    (...)
      items:
        (...)
        - uuid: 58818005e76d46dda14d6592f601ab00
          (...)
          triggers:
            - uuid: b950c306394f4b3c902060a8273cbcde
              expression: 'change(/Linux by Zabbix agent/system.sw.packages.get)<>0'
              name: 'Linux: Number of installed packages has been changed'
              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: High memory utilization'
              event_name: 'Linux: High memory utilization (>{$MEMORY.UTIL.MAX}% for 5m)'
              priority: AVERAGE
              description: 'The system is running out of free memory.'
              dependencies:
                - name: 'Linux: Lack of available memory'
                  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
        (...)

Regeln für Low-Level-Discovery in Vorlagen

zabbix_export:
  (...)
  templates:
    (...)
      discovery_rules:
        - uuid: acfdea9c46ef48c68e6636f43b8f96a2
          name: 'Erkennung von Netzwerkschnittstellen'
          key: net.if.discovery
          delay: 1h
          filter: (siehe Tabelle unten)
          description: 'Die Erkennung von Netzwerkschnittstellen.'
          item_prototypes: (siehe Tabelle unten)
          trigger_prototypes: (siehe Tabelle unten)
          graph_prototypes: (siehe Tabelle unten)
        (...)

Filter für Low-Level-Discovery-Regeln von Vorlagen

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

Operationen zum Überschreiben von Regeln der Low-Level-Discovery von Vorlagen

Vorlagen-Webszenarien

Schritte des Webszenarios der Vorlage

Konfiguration von Vorlagenmakros

zabbix_export:
  (...)
  templates:
    - uuid: f8f7908280354f2abeed07dc788c3747
      (...)
      macros:
        - macro: '{$AGENT.TIMEOUT}'
          (...)
          config:
            type: TEXT
            priority: '1'
            label: 'Sekunden seit dem letzten gesehenen Zabbix-Agent'
            description: 'Zeitüberschreitung, nach der der Agent als nicht verfügbar betrachtet wird.'
        - macro: '{$CPU.UTIL.CRIT}'
          (...)
          config:
            type: TEXT
            priority: '2'
            section_name: Schwellenwerte
            label: 'Schwellenwert der CPU-Auslastung, ausgedrückt'
            description: 'Kritischer Schwellenwert der CPU-Auslastung, ausgedrückt in %. Im Bereich von 0 bis einschließlich 100.'
            regex: '^-?([0-9]+|(([0-9]+)\.([0-9]+)))$'
        (...)
        - macro: '{$IFCONTROL}'
          (...)
          config:
            type: CHECKBOX
            priority: '19'
            label: 'Schnittstellensteuerung'
            description: 'Einen Auslöser auslösen, wenn sich der Betriebsstatus der Schnittstelle auf "Link down" ändert.'
            options:
              - checked: '1'
                unchecked: '0'
        (...)

Vorlagen-Dashboards

zabbix_export:
  (...)
  templates:
    (...)
      dashboards:
        - uuid: c689ad3115fd46a4b927d1f70ee2e5a4
          name: Filesystems
          pages:
            - name: Overview
              widgets: (siehe Tabelle unten)
        (...)

Widgets des Vorlagen-Dashboards

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

Vorlagen-Wertzuordnungen

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

Fußnoten

¹ API-Ganzzahlwerte in Klammern, zum Beispiel ENABLED (0), werden nur als Referenz angegeben. Weitere Informationen finden Sie auf der verlinkten API-Objektseite im Tabelleneintrag oder am Ende jedes Abschnitts.