Hosts

Übersicht

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

Der Host-Export enthält:

• Verknüpfte Hostgruppen
• Host-Daten
• Vorlagenverknüpfung
• Hostgruppenverknüpfung
• Host-Schnittstellen
• Direkt verknüpfte Datenpunkte
• Direkt verknüpfte Auslöser
• Direkt verknüpfte Erkennungsregeln mit allen Prototypen
• Direkt verknüpfte Webszenarien
• Host-Makros
• Host-Inventardaten
• Wertzuordnungen
• Verknüpfte Diagramme

Exportieren

Gehen Sie zum Exportieren von Hosts wie folgt vor:

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

Abhängig vom ausgewählten 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

Gehen Sie zum Importieren von Hosts wie folgt vor:

1. Gehen Sie zu Datenerfassung > Hosts.
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 Erweiterte Optionen 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 Alle anklicken, werden alle darunterliegenden Elemente markiert/deaktiviert.

Importregeln:

Eine Erfolgs- oder Fehlermeldung des Imports wird im Frontend angezeigt.

Exportformat

Wenn ein Host exportiert wird, generiert Zabbix ein strukturiertes YAML-, JSON- oder XML-Format. Der Export umfasst Host-Elemente wie Host-Metadaten, Datenpunkte, Makros, Auslöser und mehr.

Jedes Element dient einem bestimmten Zweck und kann verschachtelte Elemente enthalten.

Die folgenden Abschnitte beschreiben jedes Element im Exportformat. Die Beispiele verwenden einen Host mit der Vorlage MySQL by Zabbix agent 2. Zu Demonstrationszwecken für die Elemente wird die Vorlage nach dem Erstellen des Hosts getrennt. Beim Trennen bleiben alle Elemente in der Konfiguration erhalten (im Gegensatz zu Trennen und Löschen, wodurch sie entfernt werden).

Eine Auslassung (...) kennzeichnet aus Platzgründen weggelassene Elemente. 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: (see table below)
      items: (see table below)
      discovery_rules: (see table below)
      tags:
        - tag: location
          value: Riga
      macros:
        (...)
        - macro: '{$MYSQL.DSN}'
          value: 192.0.2.1
        (...)
        - macro: '{$MYSQL.PASSWORD}'
          type: SECRET_TEXT
          description: 'MySQL user password.'
        (...)
      valuemaps: (see table below)
  (...)

Host-Schnittstellen

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

Host-Datenpunkte

zabbix_export:
  (...)
  hosts:
    - host: 'MySQL server'
      (...)
      items:
        (...)
        - name: 'Binlog cache disk use'
          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 Binary-Log-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 utilization'
          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 Seiten zur Gesamtzahl der Seiten im Buffer Pool.'
          tags:
            - tag: component
              value: memory
          triggers: (siehe Tabelle unten)
        (...)
        - name: Uptime
          type: DEPENDENT
          key: mysql.uptime
          units: uptime
          description: 'Anzahl der Sekunden, seit der Server 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)
        (...)

Host-Datenpunkt-Werte-Vorverarbeitungsschritte

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-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 hat in den letzten 30 Minuten keine Daten für Datenpunkte erhalten.'
              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: 'Die MySQL-Laufzeit beträgt weniger als 10 Minuten.'
              tags:
                - tag: scope
                  value: notice
        (...)

Host Low-Level-Discovery-Regeln

zabbix_export:
  (...)
  hosts:
    - host: 'MySQL server'
      (...)
      discovery_rules:
        - name: 'Database discovery'
          key: 'mysql.db.discovery["{$MYSQL.DSN}","{$MYSQL.USER}","{$MYSQL.PASSWORD}"]'
          delay: 1h
          filter: (see table below)
          description: 'Scanning databases in DBMS.'
          interface_ref: if1
          item_prototypes:
            - name: 'Size of database {#DATABASE}'
              key: 'mysql.db.size["{$MYSQL.DSN}","{$MYSQL.USER}","{$MYSQL.PASSWORD}","{#DATABASE}"]'
              delay: 5m
              units: B
              description: 'Database size.'
              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
        (...)

Host Low-Level-Discovery-Regelfilter

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

Host Low-Level-Discovery-Regel: Überschreibungsoperationen

Host-Webszenarien

Host Web-Szenario-Schritte

Host-Diagramme

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

Host-Graph-Elemente

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-Integerwerte 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.