テンプレート

概要

テンプレートは、多くの関連オブジェクトおよびオブジェクト間の関係とともにエクスポートされます。

テンプレートのエクスポートには、次の内容が含まれます。

• リンクされたテンプレートグループ
• リンクされたホストグループ（ホストプロトタイプの設定で使用されている場合）
• テンプレートデータ
• 他のテンプレートへのリンク
• テンプレートグループへのリンク
• 直接リンクされたアイテム
• 直接リンクされたトリガー
• 直接リンクされたグラフ
• 直接リンクされたダッシュボード
• すべてのプロトタイプを含む直接リンクされたディスカバリルール
• 直接リンクされたWebシナリオ
• 値マップ

エクスポート

テンプレートをエクスポートするには、次の手順を実行します。

1. データ収集 > テンプレート に移動します。
2. エクスポートするテンプレートのチェックボックスをオンにします。
3. 一覧の下にある エクスポート をクリックして、デフォルトの YAML 形式でエクスポートするか、矢印をクリックして別のエクスポート形式を選択します。

選択した形式に応じて、テンプレートは次のデフォルト名のローカルファイルにエクスポートされます。

• zabbix_export_templates.yaml - YAML エクスポート;
• zabbix_export_templates.xml - XML エクスポート;
• zabbix_export_templates.json - JSON エクスポート。

インポート

テンプレートをインポートするには、次の手順を実行します。

1. データ収集 > テンプレート に移動します。
2. 右上隅の インポート をクリックします。
3. インポートファイルを選択します。
4. 適用するインポートルールのチェックボックスにチェックを入れます（以下を参照）。
5. 設定フォームの右下隅にある インポート をクリックします。

詳細オプション チェックボックスにチェックを入れると、インポート可能なすべての要素の詳細な一覧が表示されます。必要に応じて各インポートルールにチェックを入れる、またはチェックを外します。

すべて 行のチェックボックスをクリックすると、その下にあるすべての要素にチェックを入れる、またはチェックを外すことができます。

インポートルール:

次の画面では、インポートするテンプレートの内容を確認できます。 新しいテンプレートの場合、すべての要素が緑色で表示されます。 既存のテンプレートを更新する場合、新しいテンプレート要素は緑色で強調表示され、削除されたテンプレート要素は赤色で強調表示されます。変更されていない要素は灰色の背景に表示されます。

左側のメニューを使用して、変更一覧を移動できます。 更新 セクションには、既存のテンプレート要素に加えられたすべての変更が表示されます。 追加 セクションには、新しいテンプレート要素が一覧表示されます。 各セクションの要素は要素タイプごとにグループ化されています。灰色の矢印をクリックすると、要素グループを展開または折りたたむことができます。

テンプレートの変更内容を確認し、インポート をクリックしてテンプレートをインポートします。 インポートの成功または失敗を示すメッセージがWebインターフェースに表示されます。

エクスポート形式

テンプレートがエクスポートされると、Zabbix は構造化された YAML、JSON、または XML 形式を生成します。
エクスポートには、テンプレートのメタデータ、アイテム、マクロ、トリガー、ダッシュボードなどのテンプレート要素が含まれます。

各要素には特定の役割があり、入れ子の要素を含む場合があります。

以下のセクションでは、エクスポート形式における各要素について説明します。
例では Linux by Zabbix agent テンプレートを使用しています。

省略記号 (...) は、簡潔にするために省略された要素を示します。
注記 (see table below) は、後続のセクションでその要素がより詳しく説明されることを示します。

テンプレートメタデータ

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)

テンプレート

zabbix_export:
  (...)
  templates:
    - uuid: f8f7908280354f2abeed07dc788c3747
      template: 'Linux by Zabbix エージェント'
      name: 'Linux by Zabbix エージェント'
      description: |
        これは公式の Linux テンプレートです。Zabbix エージェント 8.0 以降が必要です。(...)
      wizard_ready: 'YES'
      readme: |
        ## 概要

        これは公式の Linux テンプレートです。Zabbix エージェント 8.0 以降が必要です。(...)
      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: 'エージェントが利用不可と見なされるまでのタイムアウトです。Zabbix サーバー/プロキシから到達可能なエージェント（パッシブモード）に対してのみ機能します。'
          config: (see table below)
        - macro: '{$CPU.UTIL.CRIT}'
          value: '90'
          description: 'CPU 使用率の重大しきい値（%）です。'
          config: (see table below)
        (...)
      dashboards: (see table below)
      valuemaps: (see table below)
    (...)

テンプレートアイテム

zabbix_export:
  (...)
  templates:
    (...)
      items:
        - uuid: f94f9f4699e94c369e6c98b2a2f485ce
          name: 'ZabbixエージェントのPing'
          key: agent.ping
          description: 'このアイテムでは、エージェントは常に「1」を返します。可用性チェックで `nodata()` と組み合わせて使用できます。'
          valuemap:
            name: 'ZabbixエージェントのPingステータス'
          tags:
            - tag: component
              value: system
        (...)
        - uuid: 58818005e76d46dda14d6592f601ab00
          name: 'インストール済みパッケージ数'
          key: system.sw.packages.get
          delay: 1h
          preprocessing: (下表を参照)
          tags:
            - tag: component
              value: os
          triggers: (下表を参照)
        - uuid: 403cebed115441369e94d35d070ca7b8
          name: 'メモリ使用率'
          type: DEPENDENT
          key: vm.memory.utilization
          value_type: FLOAT
          units: '%'
          description: '使用中メモリの割合は `100-pavailable` として計算されます。'
          preprocessing: (下表を参照)
          master_item:
            key: 'vm.memory.size[pavailable]'
          tags:
            - tag: component
              value: memory
          triggers: (下表を参照)
        (...)

テンプレートアイテムの値の前処理ステップ

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

テンプレートアイテムのトリガー

zabbix_export:
  (...)
  templates:
    (...)
      items:
        (...)
        - uuid: 58818005e76d46dda14d6592f601ab00
          (...)
          triggers:
            - uuid: b950c306394f4b3c902060a8273cbcde
              expression: 'change(/Linux by Zabbix agent/system.sw.packages.get)<>0'
              name: 'Linux: インストール済みパッケージ数が変更されました'
              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: メモリ使用率が高い'
              event_name: 'Linux: メモリ使用率が高い (5m間で>{$MEMORY.UTIL.MAX}%)'
              priority: AVERAGE
              description: 'システムの空きメモリが不足しています。'
              dependencies:
                - name: 'Linux: 利用可能メモリ不足'
                  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
        (...)

テンプレートの低レベルディスカバリルール

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

テンプレートの低レベルディスカバリルールのフィルター

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

テンプレートの低レベルディスカバリルールのオーバーライド操作

テンプレートのWebシナリオ

テンプレートのWebシナリオステップ

テンプレートマクロの設定

zabbix_export:
  (...)
  templates:
    - uuid: f8f7908280354f2abeed07dc788c3747
      (...)
      macros:
        - macro: '{$AGENT.TIMEOUT}'
          (...)
          config:
            type: TEXT
            priority: '1'
            label: '最後に Zabbix エージェントが検出されてからの経過秒数'
            description: 'エージェントが利用不可と見なされるまでのタイムアウト。'
        - macro: '{$CPU.UTIL.CRIT}'
          (...)
          config:
            type: TEXT
            priority: '2'
            section_name: Thresholds
            label: 'CPU 使用率のしきい値'
            description: 'CPU 使用率の重大なしきい値を % で表します。0 から 100 までの範囲です。'
            regex: '^-?([0-9]+|(([0-9]+)\.([0-9]+)))$'
        (...)
        - macro: '{$IFCONTROL}'
          (...)
          config:
            type: CHECKBOX
            priority: '19'
            label: 'インターフェース制御'
            description: 'インターフェースの動作状態が "Link down" に変化したときにトリガーを発生させます。'
            options:
              - checked: '1'
                unchecked: '0'
        (...)

テンプレートダッシュボード

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

テンプレートダッシュボードウィジェット

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

テンプレートの値マップ

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

脚注

¹ 括弧内の API の整数値、たとえば ENABLED (0) は、参照用としてのみ記載されています。 詳細については、表の項目内にあるリンク先の API オブジェクトページ、または各セクションの末尾を参照してください。