4 Hosty

Przegląd

Hosty są eksportowane z wieloma powiązanymi obiektami i relacjami obiektów.

Eksport hosta zawiera:

• Połączone grupy hostów
• Dane hosta
• Powiązanie szablonu
• Powiązanie grupy hosta
• Interfejsy hosta
• Bezpośrednio połączone pozycje
• Bezpośrednio połączone wyzwalacze
• Bezpośrednio połączone reguły wykrywania ze wszystkimi prototypami
• Bezpośrednio połączone scenariusze sieci WWW
• Makra hosta
• Dane inwentarza hosta
• Mapy wartości
• Połączone wykresy

Eksportowanie

Aby wyeksportować hosty, wykonaj następujące kroki:

1. Przejdź do Data collection → Hosts.
2. Zaznacz pola wyboru hostów, które chcesz wyeksportować.
3. Kliknij Export pod listą.

W zależności od wybranego formatu hosty są eksportowane do pliku lokalnego z domyślną nazwą:

• zabbix_export_hosts.yaml — w eksporcie YAML (domyślna opcja eksportu);
• zabbix_export_hosts.xml — w eksporcie XML;
• zabbix_export_hosts.json — w eksporcie JSON.

Importowanie

Aby zaimportować hosty, wykonaj następujące czynności:

1. Przejdź do Data collection → Hosts.
2. Kliknij Import w prawym górnym rogu.
3. Wybierz plik importu.
4. Kliknij Import w prawym dolnym rogu formularza konfiguracji.

Jeśli zaznaczysz pole wyboru Advanced options, zostanie wyświetlona szczegółowa lista wszystkich elementów możliwych do importu — zaznacz lub odznacz każdą regułę importu zgodnie z potrzebami.

Jeśli klikniesz pole wyboru w wierszu All, wszystkie elementy poniżej zostaną zaznaczone/odznaczone.

Reguły importu:

Komunikat o powodzeniu lub niepowodzeniu importu zostanie wyświetlony we frontend.

Format eksportu

Gdy host jest eksportowany, Zabbix generuje uporządkowany format YAML, JSON lub XML. Eksport obejmuje elementy hosta, takie jak metadane hosta, pozycje, makra, wyzwalacze i inne.

Każdy element pełni określoną funkcję i może zawierać elementy zagnieżdżone.

W kolejnych sekcjach opisano każdy element w formacie eksportu. W przykładach użyto hosta z szablonem MySQL by Zabbix agent 2. Na potrzeby demonstracji elementów szablon jest odłączany po utworzeniu hosta. Odłączenie zachowuje wszystkie elementy w konfiguracji (w przeciwieństwie do odłączenia i wyczyszczenia, które je usuwa).

Wielokropek (...) oznacza elementy pominięte dla zwięzłości. Uwaga (see table below) jest używana, gdy dany element jest bardziej szczegółowo wyjaśniony w dalszych sekcjach.

Metadane hosta

zabbix_export:
  version: '8.0'
  host_groups:
    - uuid: 748ad4d098d447d492bb935c907f652f
      name: Databases
  hosts: (zobacz tabelę poniżej)
  graphs: (zobacz tabelę poniżej)

Hosty

zabbix_export:
  (...)
  hosts:
    - host: 'MySQL server'
      name: 'MySQL server'
      groups:
        - name: Databases
      interfaces: (zobacz tabelę poniżej)
      items: (zobacz tabelę poniżej)
      discovery_rules: (zobacz tabelę poniżej)
      tags:
        - tag: location
          value: Riga
      macros:
        (...)
        - macro: '{$MYSQL.DSN}'
          value: 192.0.2.0
        (...)
        - macro: '{$MYSQL.PASSWORD}'
          type: SECRET_TEXT
          description: 'Hasło użytkownika MySQL.'
        (...)
      valuemaps: (zobacz tabelę poniżej)
  (...)

Interfejsy hosta

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

Pozycje hosta

zabbix_export:
  (...)
  hosts:
    - host: 'MySQL server'
      (...)
      items:
        (...)
        - name: 'Binlog cache disk use'
          type: DEPENDENT
          key: mysql.binlog_cache_disk_use
          value_type: FLOAT
          description: 'Liczba transakcji, które użyły tymczasowej pamięci podręcznej na dysku, ponieważ nie mieściły się w zwykłej pamięci podręcznej dziennika binarnego, będąc większe niż `binlog_cache_size`.'
          preprocessing: (zobacz tabelę poniżej)
          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: 'Stosunek używanych stron do całkowitej liczby stron w puli buforów.'
          tags:
            - tag: component
              value: memory
          triggers: (zobacz tabelę poniżej)
        (...)
        - name: Uptime
          type: DEPENDENT
          key: mysql.uptime
          units: uptime
          description: 'Liczba sekund, przez które serwer działał.'
          preprocessing: (zobacz tabelę poniżej)
          master_item:
            key: 'mysql.get_status_variables["{$MYSQL.DSN}","{$MYSQL.USER}","{$MYSQL.PASSWORD}"]'
          tags:
            - tag: component
              value: application
          triggers: (zobacz tabelę poniżej)
        (...)

Kroki wstępnego przetwarzania wartości pozycji hosta

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

Wyzwalacze pozycji hosta

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

Reguły wykrywania niskiego poziomu hosta

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

Filtry reguły wykrywania niskiego poziomu hosta

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

Operacje nadpisania reguły wykrywania niskopoziomowego hosta

Scenariusze WWW hosta

Kroki scenariusza WWW hosta

Wykresy hosta

zabbix_export:
  (...)
  graphs:
    - name: 'MySQL: Bandwidth'
      graph_items: (zobacz tabelę poniżej)
    (...)

Pozycje wykresu hosta

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

Mapy wartości hosta

zabbix_export:
  (...)
  hosts:
    - host: 'MySQL server'
      (...)
      valuemaps:
        - name: Przykładowa mapa wartości
          mappings:
            - value: '1'
              newvalue: Przykładowa wartość
  (...)

Przypisy

¹ Wartości całkowite API w nawiasach, na przykład ENABLED (0), są podane wyłącznie w celach informacyjnych. Więcej informacji można znaleźć na stronie powiązanego obiektu API wskazanej w odpowiednim wpisie tabeli lub na końcu każdej sekcji.