4 Hosts

Übersicht

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

Der Host-Export enthält:

• Verknüpfte Host-Gruppen
• Host-Daten
• Vorlagen-Verknüpfung
• Host-Gruppen-Verknüpfung
• Host-Schnittstellen
• Direkt verknüpfte Datenpunkte
• Direkt verknüpfte Auslöser
• Direkt verknüpfte Discovery-Regeln mit allen Prototypen
• Direkt verknüpfte Webszenarien
• Host-Makros
• Host-Inventardaten
• Wertezuordnungen
• Verknüpfte Graphen

Exportieren

Um Hosts zu exportieren, gehen Sie wie folgt vor:

1. Gehen Sie zu Datenerfassung → Hosts.
2. Aktivieren Sie die Kontrollkästchen der zu exportierenden Hosts.
3. Klicken Sie unterhalb der Liste auf Exportieren.

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

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

Importieren

Um Hosts zu importieren, gehen Sie wie folgt vor:

1. Gehen Sie zu Datenerfassung → Hosts.
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:

Im Frontend wird eine Erfolgs- oder Fehlermeldung des Imports angezeigt.

Exportformat

Wenn ein Host exportiert wird, erzeugt Zabbix ein strukturiertes YAML-, JSON- oder XML-Format. Der Export umfasst Host-Elemente wie Host-Metadaten, Datenpunkte, Makros, Auslöser 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 ein Host mit der Vorlage MySQL by Zabbix agent 2 verwendet. Zu Demonstrationszwecken für die Elemente wird die Vorlage nach der Erstellung des Hosts getrennt. Durch das Trennen bleiben alle Elemente in der Konfiguration erhalten (anders als beim Trennen und Löschen, wodurch sie entfernt werden).

Eine Auslassung (...) kennzeichnet Elemente, die der Kürze halber weggelassen wurden. Der Hinweis (siehe Tabelle unten) wird verwendet, wenn das Element in späteren Abschnitten ausführlicher erläutert wird.

Host-Metadaten

zabbix_export:
  version: '8.0'
  host_groups:
    - uuid: 748ad4d098d447d492bb935c907f652f
      name: Databases
  hosts: (siehe Tabelle unten)
  graphs: (siehe Tabelle unten)

Hosts

zabbix_export:
  (...)
  hosts:
    - host: 'MySQL server'
      name: 'MySQL server'
      groups:
        - name: Databases
      interfaces: (siehe Tabelle unten)
      items: (siehe Tabelle unten)
      discovery_rules: (siehe Tabelle unten)
      tags:
        - tag: location
          value: Riga
      macros:
        (...)
        - macro: '{$MYSQL.DSN}'
          value: 192.0.2.0
        (...)
        - macro: '{$MYSQL.PASSWORD}'
          type: SECRET_TEXT
          description: 'Passwort des MySQL-Benutzers.'
        (...)
      valuemaps: (siehe Tabelle unten)
  (...)

Host-Schnittstellen

zabbix_export:
  (...)
  hosts:
    - host: 'MySQL server'
      (...)
      interfaces:
        - ip: 192.0.2.0
          interface_ref: if1
      (...)

Host-Datenpunkte

zabbix_export:
  (...)
  hosts:
    - host: 'MySQL server'
      (...)
      items:
        (...)
        - name: 'Binlog-Cache-Festplattennutzung'
          type: DEPENDENT
          key: mysql.binlog_cache_disk_use
          value_type: FLOAT
          description: 'Anzahl der Transaktionen, die einen temporären Festplatten-Cache verwendet haben, weil sie nicht in den regulären Binärlog-Cache passten und größer als `binlog_cache_size` waren.'
          preprocessing: (siehe Tabelle unten)
          master_item:
            key: 'mysql.get_status_variables["{$MYSQL.DSN}","{$MYSQL.USER}","{$MYSQL.PASSWORD}"]'
          tags:
            - tag: component
              value: cache
        (...)
        - name: 'Buffer-Pool-Auslastung'
          type: CALCULATED
          key: mysql.buffer_pool_utilization
          value_type: FLOAT
          units: '%'
          params: |
            ( last(//mysql.innodb_buffer_pool_pages_total) - 
            last(//mysql.innodb_buffer_pool_pages_free) ) / 
            ( last(//mysql.innodb_buffer_pool_pages_total) + 
            ( last(//mysql.innodb_buffer_pool_pages_total) = 0 ) ) * 100 * 
            ( last(//mysql.innodb_buffer_pool_pages_total) > 0 )
          description: 'Verhältnis der verwendeten zur Gesamtzahl der Seiten im Buffer Pool.'
          tags:
            - tag: component
              value: memory
          triggers: (siehe Tabelle unten)
        (...)
        - name: Laufzeit
          type: DEPENDENT
          key: mysql.uptime
          units: uptime
          description: 'Anzahl der Sekunden, die der Server bereits läuft.'
          preprocessing: (siehe Tabelle unten)
          master_item:
            key: 'mysql.get_status_variables["{$MYSQL.DSN}","{$MYSQL.USER}","{$MYSQL.PASSWORD}"]'
          tags:
            - tag: component
              value: application
          triggers: (siehe Tabelle unten)
        (...)

Vorverarbeitungsschritte für Datenpunktwerte des Host

zabbix_export:
  (...)
  hosts:
    - host: 'MySQL server'
      (...)
      items:
        (...)
        - name: 'Binlog cache disk use'
          (...)
          preprocessing:
            - type: JSONPATH
              parameters:
                - $.Binlog_cache_disk_use
            - type: DISCARD_UNCHANGED_HEARTBEAT
              parameters:
                - 6h
          (...)

Host-Datenpunkt-Auslöser

zabbix_export:
  (...)
  hosts:
    - host: 'MySQL server'
      (...)
      items:
        (...)
        - name: Uptime
          (...)
          triggers:
            - expression: 'nodata(/MySQL server/mysql.uptime,30m)=1'
              name: 'MySQL: Failed to fetch info data'
              event_name: 'MySQL: Failed to fetch info data (or no data for 30m)'
              priority: INFO
              description: 'Zabbix has not received any data for items for the last 30 minutes.'
              dependencies:
                - name: 'MySQL: Service is down'
                  expression: 'last(/MySQL server/mysql.ping["{$MYSQL.DSN}","{$MYSQL.USER}","{$MYSQL.PASSWORD}"])=0'
              tags:
                - tag: scope
                  value: availability
            - expression: 'last(/MySQL server/mysql.uptime)<10m'
              name: 'MySQL: Service has been restarted'
              event_name: 'MySQL: Service has been restarted (uptime < 10m)'
              priority: INFO
              description: 'MySQL uptime is less than 10 minutes.'
              tags:
                - tag: scope
                  value: notice
        (...)

Host-Regeln für Low-Level-Discovery

zabbix_export:
  (...)
  hosts:
    - host: 'MySQL server'
      (...)
      discovery_rules:
        - name: 'Database discovery'
          key: 'mysql.db.discovery["{$MYSQL.DSN}","{$MYSQL.USER}","{$MYSQL.PASSWORD}"]'
          delay: 1h
          filter: (siehe Tabelle unten)
          description: 'Durchsuchen von Datenbanken im DBMS.'
          interface_ref: if1
          item_prototypes:
            - name: 'Größe der Datenbank {#DATABASE}'
              key: 'mysql.db.size["{$MYSQL.DSN}","{$MYSQL.USER}","{$MYSQL.PASSWORD}","{#DATABASE}"]'
              delay: 5m
              units: B
              description: 'Datenbankgröße.'
              preprocessing:
                - type: DISCARD_UNCHANGED_HEARTBEAT
                  parameters:
                    - 1h
              interface_ref: if1
              tags:
                - tag: component
                  value: storage
                - tag: database
                  value: '{#DATABASE}'
          lld_macro_paths:
            - lld_macro: '{#DATABASE}'
              path: $.Database
          preprocessing:
            - type: DISCARD_UNCHANGED_HEARTBEAT
              parameters:
                - 1d
        (...)

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

zabbix_export:
  (...)
  hosts:
    - host: 'MySQL server'
      (...)
      discovery_rules:
        - name: 'Database discovery'
          (...)
          filter:
            evaltype: AND
            conditions:
              - macro: '{#DATABASE}'
                value: '{$MYSQL.DBNAME.MATCHES}'
              - macro: '{#DATABASE}'
                value: '{$MYSQL.DBNAME.NOT_MATCHES}'
                operator: NOT_MATCHES_REGEX
          (...)

Überschreibungsoperationen für Host-Regeln der Low-Level-Discovery

Host-Webszenarien

Schritte des Host-Webszenarios

Host-Diagramme

zabbix_export:
  (...)
  graphs:
    - name: 'MySQL: Bandbreite'
      graph_items: (siehe Tabelle unten)
    (...)

Host-Grafik-Datenpunkte

zabbix_export:
  (...)
  graphs:
    - name: 'MySQL: Bandwidth'
      graph_items:
        - drawtype: GRADIENT_LINE
          color: 199C0D
          item:
            host: 'MySQL server'
            key: mysql.bytes_received.rate
        - sortorder: '1'
          drawtype: GRADIENT_LINE
          color: F63100
          item:
            host: 'MySQL server'
            key: mysql.bytes_sent.rate
    (...)

Host-Wertzuordnungen

zabbix_export:
  (...)
  hosts:
    - host: 'MySQL server'
      (...)
      valuemaps:
        - name: Example value map
          mappings:
            - value: '1'
              newvalue: Example value
  (...)

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.