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. Wechseln Sie zu Datenerfassung > Vorlagen.
2. Markieren Sie die Kontrollkästchen der zu exportierenden Vorlagen.
3. Klicken Sie unterhalb der Liste auf Export, um im standardmäßigen YAML-Format zu exportieren, oder klicken Sie auf den Pfeil, um ein anderes Exportformat auszuwählen.

Abhängig vom ausgewählten Format werden Vorlagen in eine lokale Datei mit einem Standardnamen exportiert:

• zabbix_export_templates.yaml - beim YAML-Export;
• zabbix_export_templates.xml - beim XML-Export;
• zabbix_export_templates.json - beim JSON-Export.

Importieren

Gehen Sie zum Importieren von Vorlagen wie folgt vor:

1. Gehen Sie zu Datensammlung > Vorlagen.
2. Klicken Sie oben rechts auf Importieren.
3. Wählen Sie die Importdatei aus.
4. Aktivieren Sie die Kontrollkästchen der Importregeln, die Sie anwenden möchten (siehe unten).
5. Klicken Sie unten rechts im Konfigurationsformular auf Importieren.

Wenn Sie das Kontrollkästchen Erweiterte Optionen aktivieren, wird eine detaillierte Liste aller importierbaren Elemente angezeigt. Aktivieren oder deaktivieren Sie die einzelnen Importregeln nach Bedarf.

Wenn Sie das Kontrollkästchen in der Zeile Alle aktivieren, werden alle darunter aufgeführten Elemente aktiviert bzw. deaktiviert.

Importregeln:

Auf dem nächsten Bildschirm können Sie den Inhalt einer importierten 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 rot hervorgehoben und unveränderte Elemente auf einem grauen Hintergrund aufgelistet.

Über das Menü auf der linken Seite können Sie durch die Liste der Änderungen navigieren. Der Abschnitt Aktualisiert hebt alle Änderungen an vorhandenen Vorlagenelementen hervor. Der Abschnitt Hinzugefügt listet neue Vorlagenelemente auf. Die Elemente in den einzelnen Abschnitten sind nach Elementtyp gruppiert. Klicken Sie auf den grauen Pfeil, um die Elementgruppe ein- oder auszublenden.

Überprüfen Sie die Änderungen an der Vorlage und klicken Sie anschließend auf Importieren, um den Vorlagenimport durchzuführen. Im Frontend wird eine Erfolgs- oder Fehlermeldung zum Import 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.

Vorlagen-Metadaten

zabbix_export:
  version: '8.2'
  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.2 oder neuer. (...)
      wizard_ready: 'YES'
      readme: |
        ## Übersicht

        Dies ist eine offizielle Linux-Vorlage. Sie erfordert Zabbix Agent 8.2 oder neuer. (...)
      vendor:
        name: Zabbix
        version: 8.2-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 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)
    (...)

Datenpunkte der Vorlage

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

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

Vorlagenregeln für die Low-Level-Erkennung

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

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

Vorlage-Dashboards

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

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.