Vorlagen

Übersicht

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

Der Vorlagenexport enthält:

• Verknüpfte Vorlagengruppen
• Verknüpfte Host-Gruppen (falls in der Konfiguration des Host-Prototyps 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 Erkennungsregeln mit allen Prototypen
• Direkt verknüpfte Webszenarien
• Wertzuordnungen

Exportieren

Gehen Sie zum Exportieren von Vorlagen wie folgt vor:

1. Gehen Sie zu Datenerfassung > Vorlagen.
2. Markieren Sie die Kontrollkästchen der Vorlagen, die exportiert werden sollen.
3. Klicken Sie unterhalb der Liste auf Export.

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 Data collection > Templates.
2. Klicken Sie oben rechts auf Import.
3. Wählen Sie die Importdatei aus.
4. Klicken Sie unten rechts im Konfigurationsformular auf Import.

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

Wenn Sie das Kontrollkästchen in der Zeile All anklicken, 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. Beim Aktualisieren einer vorhandenen Vorlage werden neue Vorlagenelemente grün hervorgehoben; entfernte Vorlagenelemente werden rot hervorgehoben; unveränderte Elemente werden auf grauem Hintergrund angezeigt.

Das Menü auf der linken Seite kann verwendet werden, um durch die Liste der Änderungen zu navigieren. Der Abschnitt Updated hebt alle Änderungen an vorhandenen Vorlagenelementen hervor. Der Abschnitt Added listet neue Vorlagenelemente auf. Die Elemente in jedem Abschnitt sind nach Elementtyp gruppiert; klicken Sie auf den grauen Pfeil, um die Gruppe der Elemente zu erweitern oder zu reduzieren.

Überprüfen Sie die Vorlagenänderungen und klicken Sie dann auf Import, um den Vorlagenimport auszuführen. Eine Erfolgs- oder Fehlermeldung des Imports wird im Frontend angezeigt.

Exportformat

Wenn eine Vorlage exportiert wird, generiert 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.

Die folgenden Abschnitte beschreiben jedes Element im Exportformat. Die Beispiele verwenden die Vorlage Linux by Zabbix agent.

Eine Ellipse (...) kennzeichnet aus Platzgründen ausgelassene Elemente. Der Hinweis (siehe Tabelle unten) wird verwendet, wenn das Element in späteren Abschnitten ausführlicher erläutert wird.

Vorlagenmetadaten

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: 'Vorlagen/Betriebssysteme'
      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 gilt. Funktioniert nur für Agenten, 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 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: 'Number of installed packages'
          key: system.sw.packages.get
          delay: 1h
          preprocessing: (siehe Tabelle unten)
          tags:
            - tag: component
              value: os
          triggers: (siehe Tabelle unten)
        - uuid: 403cebed115441369e94d35d070ca7b8
          name: 'Memory utilization'
          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)
        (...)

Vorverarbeitungsschritte für den Wert eines Vorlagen-Datenpunkts

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

Vorlage-Item-Auslöser

zabbix_export:
  (...)
  templates:
    (...)
      items:
        (...)
        - uuid: 58818005e76d46dda14d6592f601ab00
          (...)
          triggers:
            - uuid: b950c306394f4b3c902060a8273cbcde
              expression: 'change(/Linux by Zabbix agent/system.sw.packages.get)<>0'
              name: 'Linux: Anzahl der installierten Pakete wurde geändert'
              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: Hohe Speicherauslastung'
              event_name: 'Linux: Hohe Speicherauslastung (>{$MEMORY.UTIL.MAX}% für 5m)'
              priority: AVERAGE
              description: 'Dem System geht der freie Speicher aus.'
              dependencies:
                - name: 'Linux: Nicht genügend verfügbarer Speicher'
                  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
        (...)

Vorlage Low-Level-Discovery-Regeln

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

Filter für Low-Level-Discovery-Regeln der Vorlage

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

Überschreibungsoperationen für Low-Level-Discovery-Regeln von Vorlagen

Vorlage-Webszenarien

Vorlage web scenario steps

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: Thresholds
            label: 'Ausgedrückter Schwellenwert der CPU-Auslastung'
            description: 'Kritischer Schwellenwert der CPU-Auslastung 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: 'Löst einen Auslöser aus, wenn sich der Betriebsstatus der Schnittstelle in "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)
        (...)

Vorlage-Dashboard-Widgets

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})]: Diagramm zur Speicherauslastung (relativ zum Gesamtwert)'
                    - 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})]: Diagramm zur Speichernutzung in % (relativ zum maximal verfügbaren Wert)'
                    - 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 zur Referenz angegeben. Weitere Informationen finden Sie auf der verlinkten API-Objektseite im Tabelleneintrag oder am Ende jedes Abschnitts.