Hosty

Przegląd

Hosty są eksportowane wraz z wieloma powiązanymi obiektami i relacjami między obiektami.

Eksport hosta zawiera:

• Powiązane grupy hostów
• Dane hosta
• Powiązania z szablonami
• Powiązania z grupami hostów
• Interfejsy hosta
• Bezpośrednio powiązane pozycje
• Bezpośrednio powiązane wyzwalacze
• Bezpośrednio powiązane reguły wykrywania wraz ze wszystkimi prototypami
• Bezpośrednio powiązane scenariusze web
• Makra hosta
• Dane inwentarza hosta
• Mapowania wartości
• Powiązane wykresy

Eksportowanie

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

1. Przejdź do Data collection > Hosts.
2. Zaznacz pola wyboru hostów do wyeksportowania.
3. Kliknij Export pod listą, aby wyeksportować w domyślnym formacie YAML, lub kliknij strzałkę, aby wybrać inny format eksportu.

W zależności od wybranego formatu hosty są eksportowane do lokalnego pliku o domyślnej nazwie:

• zabbix_export_hosts.yaml - w eksporcie YAML;
• 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 sekcji Data collection > Hosts.
2. Kliknij przycisk Import w prawym górnym rogu.
3. Wybierz plik importu.
4. Zaznacz pola wyboru reguł importu, które chcesz zastosować (zobacz poniżej).
5. Kliknij przycisk Import w prawym dolnym rogu formularza konfiguracji.

Jeśli zaznaczysz pole wyboru Advanced options, zostanie wyświetlona szczegółowa lista wszystkich elementów, które można zaimportować — zaznacz lub odznacz poszczególne reguły importu zgodnie z wymaganiami.

Jeśli klikniesz pole wyboru w wierszu All, wszystkie znajdujące się poniżej elementy zostaną zaznaczone lub odznaczone.

Reguły importu:

Podczas importu nie można przejrzeć zmian dotyczących hostów. Komunikat o pomyślnym lub nieudanym imporcie zostanie wyświetlony w frontendzie.

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ą rolę i może zawierać elementy zagnieżdżone.

W poniższych 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 usuwa je).

Wielokropek (...) oznacza elementy pominięte ze względu na zwięzłość. Uwaga (see table below) jest używana, gdy element jest wyjaśniany bardziej szczegółowo w późniejszych sekcjach.

Metadane hosta

zabbix_export:
  version: '8.2'
  host_groups:
    - uuid: 748ad4d098d447d492bb935c907f652f
      name: Databases
  hosts: (see table below)
  graphs: (see table below)

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: 'Hasło użytkownika MySQL.'
        (...)
      valuemaps: (see table below)
  (...)

Interfejsy hosta

zabbix_export:
  (...)
  hosts:
    - host: 'MySQL server'
      (...)
      interfaces:
        - ip: 192.0.2.1
          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 zmieś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 przetwarzania wstępnego 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: Nie udało się pobrać danych informacyjnych'
              event_name: 'MySQL: Nie udało się pobrać danych informacyjnych (lub brak danych przez 30m)'
              priority: INFO
              description: 'Zabbix nie otrzymał żadnych danych dla pozycji w ciągu ostatnich 30 minut.'
              dependencies:
                - name: 'MySQL: Usługa jest niedostępna'
                  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: Usługa została uruchomiona ponownie'
              event_name: 'MySQL: Usługa została uruchomiona ponownie (uptime < 10m)'
              priority: INFO
              description: 'Czas działania MySQL jest krótszy niż 10 minut.'
              tags:
                - tag: scope
                  value: notice
        (...)

Reguły wykrywania niskopoziomowego 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 nadpisywania reguły wykrywania niskiego poziomu hosta

Scenariusze web hosta

Kroki scenariusza web hosta

Wykresy hosta

zabbix_export:
  (...)
  graphs:
    - name: 'MySQL: Bandwidth'
      graph_items: (see table below)
    (...)

Elementy 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: Example value map
          mappings:
            - value: '1'
              newvalue: Example value
  (...)

Przypisy

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