Szablony

Omówienie

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

Eksport szablonu zawiera:

• Powiązane grupy szablonów
• Powiązane grupy hostów (jeśli są używane w konfiguracji prototypu hosta)
• Dane szablonu
• Powiązania z innymi szablonami
• Powiązania z grupami szablonów
• Bezpośrednio powiązane pozycje
• Bezpośrednio powiązane wyzwalacze
• Bezpośrednio powiązane wykresy
• Bezpośrednio powiązane pulpity
• Bezpośrednio powiązane reguły wykrywania ze wszystkimi prototypami
• Bezpośrednio powiązane scenariusze web
• Mapy wartości

Eksportowanie

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

1. Przejdź do Data collection > Templates.
2. Zaznacz pola wyboru szablonó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 szablony są eksportowane do lokalnego pliku o domyślnej nazwie:

• zabbix_export_templates.yaml - w eksporcie YAML;
• zabbix_export_templates.xml - w eksporcie XML;
• zabbix_export_templates.json - w eksporcie JSON.

Importowanie

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

1. Przejdź do sekcji Zbieranie danych > Szablony.
2. Kliknij przycisk Importuj 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 Importuj w prawym dolnym rogu formularza konfiguracji.

Jeśli zaznaczysz pole wyboru Opcje zaawansowane, 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 Wszystkie, wszystkie znajdujące się poniżej elementy zostaną zaznaczone lub odznaczone.

Reguły importu:

Na następnym ekranie będzie można wyświetlić zawartość importowanego szablonu. Jeśli jest to nowy szablon, wszystkie elementy zostaną wyświetlone na zielono. Jeśli aktualizujesz istniejący szablon, nowe elementy szablonu zostaną wyróżnione na zielono, usunięte elementy szablonu zostaną wyróżnione na czerwono, a elementy, które nie uległy zmianie, zostaną wyświetlone na szarym tle.

Menu po lewej stronie służy do poruszania się po liście zmian. Sekcja Zaktualizowane wyróżnia wszystkie zmiany wprowadzone w istniejących elementach szablonu. Sekcja Dodane zawiera listę nowych elementów szablonu. Elementy w każdej sekcji są pogrupowane według typu elementu; kliknij szarą strzałkę, aby rozwinąć lub zwinąć grupę elementów.

Przejrzyj zmiany w szablonie, a następnie kliknij przycisk Importuj, aby wykonać import szablonu. Komunikat o pomyślnym lub nieudanym imporcie zostanie wyświetlony w frontend.

Format eksportu

Gdy szablon jest eksportowany, Zabbix generuje uporządkowany format YAML, JSON lub XML. Eksport obejmuje elementy szablonu, takie jak metadane szablonu, pozycje, makra, wyzwalacze, pulpity 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 szablonu Linux by Zabbix agent.

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

Metadane szablonu

zabbix_export:
  version: '8.0'
  template_groups:
    - uuid: 846977d1dfed4968bc5f8bdb363285bc
      name: 'Templates/Operating systems'
  templates: (see table below)
  triggers: (see table below)
  graphs: (see table below)

Szablony

zabbix_export:
  (...)
  templates:
    - uuid: f8f7908280354f2abeed07dc788c3747
      template: 'Linux by Zabbix agent'
      name: 'Linux by Zabbix agent'
      description: |
        To jest oficjalny szablon Linux. Wymaga Zabbix agent 8.0 lub nowszego. (...)
      wizard_ready: 'YES'
      readme: |
        ## Omówienie

        To jest oficjalny szablon Linux. Wymaga Zabbix agent 8.0 lub nowszego. (...)
      vendor:
        name: Zabbix
        version: 8.0-2
      groups:
        - name: 'Templates/Operating systems'
      items: (see table below)
      discovery_rules: (see table below)
      tags:
        - tag: class
          value: os
        - tag: target
          value: linux
      macros:
        - macro: '{$AGENT.TIMEOUT}'
          value: 3m
          description: 'Limit czasu, po którym agent jest uznawany za niedostępny. Działa tylko dla agentów osiągalnych z serwer/proxy Zabbix (tryb pasywny).'
          config: (see table below)
        - macro: '{$CPU.UTIL.CRIT}'
          value: '90'
          description: 'Krytyczny próg użycia CPU wyrażony w %.'
          config: (see table below)
        (...)
      dashboards: (see table below)
      valuemaps: (see table below)
    (...)

Pozycje szablonu

zabbix_export:
  (...)
  templates:
    (...)
      items:
        - uuid: f94f9f4699e94c369e6c98b2a2f485ce
          name: 'Ping agenta Zabbix'
          key: agent.ping
          description: 'agent zawsze zwraca „1” dla tej pozycji. Można jej użyć w połączeniu z `nodata()` do sprawdzania dostępności.'
          valuemap:
            name: 'Stan pingowania agenta Zabbix'
          tags:
            - tag: component
              value: system
        (...)
        - uuid: 58818005e76d46dda14d6592f601ab00
          name: 'Liczba zainstalowanych pakietów'
          key: system.sw.packages.get
          delay: 1h
          preprocessing: (zobacz tabelę poniżej)
          tags:
            - tag: component
              value: os
          triggers: (zobacz tabelę poniżej)
        - uuid: 403cebed115441369e94d35d070ca7b8
          name: 'Wykorzystanie pamięci'
          type: DEPENDENT
          key: vm.memory.utilization
          value_type: FLOAT
          units: '%'
          description: 'Procent wykorzystanej pamięci jest obliczany jako `100-pavailable`.'
          preprocessing: (zobacz tabelę poniżej)
          master_item:
            key: 'vm.memory.size[pavailable]'
          tags:
            - tag: component
              value: memory
          triggers: (zobacz tabelę poniżej)
        (...)

Kroki przetwarzania wstępnego wartości pozycja szablonu

zabbix_export:
  (...)
  templates:
    (...)
      items:
        (...)
        - uuid: 58818005e76d46dda14d6592f601ab00
          (...)
          preprocessing:
            - type: JSONPATH
              parameters:
                - $.length()
            - type: DISCARD_UNCHANGED_HEARTBEAT
              parameters:
                - 12h
          (...)

Wyzwalacze pozycji szablonu

zabbix_export:
  (...)
  templates:
    (...)
      items:
        (...)
        - uuid: 58818005e76d46dda14d6592f601ab00
          (...)
          triggers:
            - uuid: b950c306394f4b3c902060a8273cbcde
              expression: 'change(/Linux by Zabbix agent/system.sw.packages.get)<>0'
              name: 'Linux: Liczba zainstalowanych pakietów została zmieniona'
              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: Wysokie wykorzystanie pamięci'
              event_name: 'Linux: Wysokie wykorzystanie pamięci (>{$MEMORY.UTIL.MAX}% przez 5m)'
              priority: AVERAGE
              description: 'Systemowi zaczyna brakować wolnej pamięci.'
              dependencies:
                - name: 'Linux: Brak dostępnej pamięci'
                  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
        (...)

Reguły wykrywania niskiego poziomu szablonu

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

Filtry reguły wykrywania niskiego poziomu szablonu

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

Operacje nadpisania reguły wykrywania niskiego poziomu szablonu

Szablon scenariuszy webowych

Kroki scenariusza web szablonu

Konfiguracja makra szablonu

zabbix_export:
  (...)
  templates:
    - uuid: f8f7908280354f2abeed07dc788c3747
      (...)
      macros:
        - macro: '{$AGENT.TIMEOUT}'
          (...)
          config:
            type: TEXT
            priority: '1'
            label: 'Sekundy od ostatniego wykrycia agenta Zabbix'
            description: 'Limit czasu, po którym agent jest uznawany za niedostępny.'
        - macro: '{$CPU.UTIL.CRIT}'
          (...)
          config:
            type: TEXT
            priority: '2'
            section_name: Thresholds
            label: 'Próg wykorzystania CPU wyrażony'
            description: 'Krytyczny próg wykorzystania CPU wyrażony w %. W zakresie od 0 do 100 włącznie.'
            regex: '^-?([0-9]+|(([0-9]+)\.([0-9]+)))$'
        (...)
        - macro: '{$IFCONTROL}'
          (...)
          config:
            type: CHECKBOX
            priority: '19'
            label: 'Kontrola interfejsów'
            description: 'Wyzwól wyzwalacz, gdy status operacyjny interfejsu zmieni się na "Link down".'
            options:
              - checked: '1'
                unchecked: '0'
        (...)

Pulpity szablonu

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

Widżety pulpitu szablonu

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})]: Wykres wykorzystania przestrzeni (względem całości)'
                    - 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})]: Wykres użycia przestrzeni, w % (względem maksymalnie dostępnej)'
                    - type: STRING
                      name: reference
                      value: AAAEC
        (...)

Mapy wartości szablonu

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

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.