4 ホスト

概要

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

ホストのエクスポートには、以下が含まれます。

• リンクされたホストグループ
• ホストデータ
• テンプレートのリンク
• ホストグループのリンク
• ホストインターフェース
• 直接リンクされたアイテム
• 直接リンクされたトリガー
• すべてのプロトタイプを含む、直接リンクされたディスカバリルール
• 直接リンクされたWebシナリオ
• ホストマクロ
• ホストインベントリデータ
• 値マップ
• リンクされたグラフ

エクスポート

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

1. データ収集 → ホスト に移動します。
2. エクスポートするホストのチェックボックスをオンにします。
3. 一覧の下にある エクスポート をクリックします。

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

• zabbix_export_hosts.yaml - YAMLエクスポートの場合（エクスポートのデフォルトオプション）
• zabbix_export_hosts.xml - XMLエクスポートの場合
• zabbix_export_hosts.json - JSONエクスポートの場合。

インポート

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

1. データ収集 → ホスト に移動します。
2. 右上隅の インポート をクリックします。
3. インポートファイルを選択します。
4. 設定フォームの右下隅にある インポート をクリックします。

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

すべて 行のチェックボックスをクリックすると、その下にあるすべての要素がオン/オフされます。

インポートルール:

インポートの成功または失敗のメッセージがWebインターフェースに表示されます。

エクスポート形式

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

各要素は特定の目的を持ち、ネストされた要素を含む場合があります。

以下のセクションでは、エクスポート形式の各要素について説明します。 例では、MySQL by Zabbix agent 2 テンプレートを使用するホストを用いています。 要素の説明を目的として、ホストの作成後にテンプレートのリンクを解除しています。 リンクを解除しても、すべての要素は設定内に保持されます（リンク解除とクリアを行った場合とは異なり、その場合は要素が削除されます）。

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

ホストメタデータ

zabbix_export:
  version: '7.4'
  host_groups:
    - uuid: 748ad4d098d447d492bb935c907f652f
      name: Databases
  hosts: (以下の表を参照)
  graphs: (以下の表を参照)

ホスト

zabbix_export:
  (...)
  hosts:
    - host: 'MySQL server'
      name: 'MySQL server'
      groups:
        - name: Databases
      interfaces: （以下の表を参照）
      items: （以下の表を参照）
      discovery_rules: （以下の表を参照）
      tags:
        - tag: location
          value: Riga
      macros:
        (...)
        - macro: '{$MYSQL.DSN}'
          value: 192.0.2.0
        (...)
        - macro: '{$MYSQL.PASSWORD}'
          type: SECRET_TEXT
          description: 'MySQL user password.'
        (...)
      valuemaps: （以下の表を参照）
  (...)

ホストインターフェース

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

ホストのアイテム

zabbix_export:
  (...)
  hosts:
    - host: 'MySQL server'
      (...)
      items:
        (...)
        - name: 'Binlog cache disk use'
          type: DEPENDENT
          key: mysql.binlog_cache_disk_use
          value_type: FLOAT
          description: '`binlog_cache_size` に収まらないため、通常のバイナリログキャッシュではなく一時ディスクキャッシュを使用したトランザクション数。'
          preprocessing: (下表を参照)
          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: 'バッファプール内の総ページ数に対する使用済みページ数の比率。'
          tags:
            - tag: component
              value: memory
          triggers: (下表を参照)
        (...)
        - name: Uptime
          type: DEPENDENT
          key: mysql.uptime
          units: uptime
          description: 'サーバーが稼働している秒数。'
          preprocessing: (下表を参照)
          master_item:
            key: 'mysql.get_status_variables["{$MYSQL.DSN}","{$MYSQL.USER}","{$MYSQL.PASSWORD}"]'
          tags:
            - tag: component
              value: application
          triggers: (下表を参照)
        (...)

ホストのアイテム値の前処理ステップ

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

ホストのアイテムのトリガー

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

ホストのローレベルディスカバリルール

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

ホストのローレベルディスカバリルールのフィルター

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

ホストのローレベルディスカバリルールの上書き操作

ホストのWebシナリオ

ホストのWebシナリオのステップ

ホストグラフ

zabbix_export:
  (...)
  graphs:
    - name: 'MySQL: Bandwidth'
      graph_items: (以下の表を参照)
    (...)

ホストのグラフアイテム

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

ホストの値のマッピング

zabbix_export:
  (...)
  hosts:
    - host: 'MySQL server'
      (...)
      valuemaps:
        - name: 値のマッピングの例
          mappings:
            - value: '1'
              newvalue: 変換後の値の例
  (...)

脚注

¹ かっこ内のAPI integer値（例: ENABLED (0)）は、参照用としてのみ記載されています。 詳細については、表の該当エントリにあるリンク先のAPIオブジェクトページ、または各セクションの末尾を参照してください。