3 Szablony

Przegląd

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 WWW
• 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 poniżej listy.

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

• zabbix_export_templates.yaml — w eksporcie YAML (domyślna opcja eksportu);
• 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 Data collection → Templates.
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, które można importować — 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:

Na następnym ekranie będzie można wyświetlić zawartość importowanego szablonu. Jeśli jest to nowy szablon, wszystkie elementy będą wyświetlane na zielono. W przypadku aktualizacji istniejącego szablonu nowe elementy szablonu będą wyróżnione na zielono; usunięte elementy szablonu będą wyróżnione na czerwono; elementy, które nie uległy zmianie, będą wyświetlane na szarym tle.

Menu po lewej stronie może służyć do poruszania się po liście zmian. Sekcja Updated wyróżnia wszystkie zmiany wprowadzone w istniejących elementach szablonu. Sekcja Added 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 Import, aby wykonać import szablonu. W frontend zostanie wyświetlony komunikat o powodzeniu lub niepowodzeniu importu.

Format eksportu

Po wyeksportowaniu szablonu 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.

Poniższe sekcje opisują każdy element w formacie eksportu. W przykładach użyto szablonu Linux by Zabbix agent.

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

Metadane szablonu

zabbix_export:
  version: '8.0'
  template_groups:
    - uuid: 846977d1dfed4968bc5f8bdb363285bc
      name: 'Templates/Operating systems'
  templates: (zobacz tabelę poniżej)
  triggers: (zobacz tabelę poniżej)
  graphs: (zobacz tabelę poniżej)

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: |
        ## Przegląd

        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: (zobacz tabelę poniżej)
      discovery_rules: (zobacz tabelę poniżej)
      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 serwera/proxy Zabbix (tryb pasywny).'
          config: (zobacz tabelę poniżej)
        - macro: '{$CPU.UTIL.CRIT}'
          value: '90'
          description: 'Próg krytyczny wykorzystania CPU wyrażony w %.'
          config: (zobacz tabelę poniżej)
        (...)
      dashboards: (zobacz tabelę poniżej)
      valuemaps: (zobacz tabelę poniżej)
    (...)

Pozycje szablonu

zabbix_export:
  (...)
  templates:
    (...)
      items:
        - uuid: f94f9f4699e94c369e6c98b2a2f485ce
          name: 'Ping agenta Zabbix'
          key: agent.ping
          description: 'Agent zawsze zwraca "1" dla tej pozycji. Może być używana w połączeniu z `nodata()` do sprawdzania dostępności.'
          valuemap:
            name: 'Status pingu 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 użytej 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 wstępnego przetwarzania wartości pozycji 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 uległa zmianie'
              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 kończy się wolna pamięć.'
              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: 'Wykrywanie interfejsów sieciowych'
          key: net.if.discovery
          delay: 1h
          filter: (zobacz tabelę poniżej)
          description: 'Wykrywanie interfejsów sieciowych.'
          item_prototypes: (zobacz tabelę poniżej)
          trigger_prototypes: (zobacz tabelę poniżej)
          graph_prototypes: (zobacz tabelę poniżej)
        (...)

Filtry reguł 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

Scenariusze WWW szablonu

Kroki scenariusza WWW szablonu

Konfiguracja makr szablonu

zabbix_export:
  (...)
  templates:
    - uuid: f8f7908280354f2abeed07dc788c3747
      (...)
      macros:
        - macro: '{$AGENT.TIMEOUT}'
          (...)
          config:
            type: TEXT
            priority: '1'
            label: 'Liczba sekund 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: Progi
            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: 'Uruchom wyzwalacz, gdy stan operacyjny interfejsu zmieni się na "Link down".'
            options:
              - checked: '1'
                unchecked: '0'
        (...)

Pulpity szablonów

zabbix_export:
  (...)
  templates:
    (...)
      dashboards:
        - uuid: c689ad3115fd46a4b927d1f70ee2e5a4
          name: Filesystems
          pages:
            - name: Overview
              widgets: (zobacz tabelę poniżej)
        (...)

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})]: Space utilization chart (relative to total)'
                    - 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})]: Space usage graph, in % (relative to max available)'
                    - type: STRING
                      name: reference
                      value: AAAEC
        (...)

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