14. 設定のエクスポート/インポート

概要

Zabbixのエクスポート/インポート機能により、Zabbixシステム間で様々な設定情報を交換することができます。

この機能の典型的な使用例:

• テンプレートやネットワークマップの共有 - Zabbixユーザによる設定パラメータの共有
• テンプレートをZabbix Community templatesにアップロードします。その後、他のユーザーがテンプレートをダウンロードして、ファイルを Zabbix にインポートできます。
• サードパーティツールとの統合 - 汎用的なYAML、XML、JSON形式を使用することで、データのインポート/エクスポートを行ってサードパーティのツールやアプリケーションと統合することができます。

エクスポート/インポートできるもの

エクスポート/インポートできるオブジェクトは次のとおりです。

• ホストグループ (Zabbix API 経由のみ)
• テンプレート
• ホスト
• ネットワークマップ
• メディアタイプ
• images

エクスポート形式

ZabbixのWebインターフェースまたはZabbix APIを使用してデータをエクスポートすることができます。
サポートされているエクスポート形式は YAML、XML、JSONです。

エクスポートに関する詳細

• サポートされているすべての要素が1つのファイルにエクスポートされます。
  
• ホストおよびテンプレートの要素（アイテム、トリガー、グラフ、ディスカバリールール）は、
  リンクされたテンプレートから継承されるため、エクスポートされません。
  ホストレベルでこれらのエンティティに加えられたすべての変更（アイテムの監視間隔の変更、正規表現の変更、
  ローレベルディスカバリルールへのプロトタイプの追加など）は、エクスポート時に失われます。
  インポートする場合、リンクされたテンプレートのすべての要素は、元のリンクされたテンプレートと同じように再作成されます。
  
• ローレベルディスカバリによって作成された要素およびそれに依存する要素は、エクスポートされません。
  例えば、LLD ルールが生成された項目に対して作成されたトリガはエクスポートされません。
  

インポートに関する詳細

• インポートは、最初のエラーで停止します。
• 画像のインポート時に、既存の画像を更新する場合、"imagetype "フィールドは無視されます。つまり、インポートを介してイメージタイプを変更することはできません。
• ホスト/テンプレートを "存在しない場合に削除"オプションでインポートする場合、インポートファイルに存在しないホスト／テンプレートマクロはインポート後にホスト／テンプレートから削除されます。
• アイテム、トリガー、グラフ、ホスト/テンプレート、アプリケーション、ディスカバリルール、アイテムプロトタイプ、トリガープロトタイプ、グラフプロトタイプでは、空のタグには意味がありません。つまり、存在しないのと同じです。
• インポートは、YAML、XML、JSONをサポートしています。YAMLは.yamlと.yml、XMLは.xml、JSONは.jsonと、正しいファイル拡張子が必要です。サポートされているXMLのバージョンに関しては、バージョン間の互換性を参照してください。
• インポートは、UTF-8 エンコーディング (BOM 付き/なし いずれも対応) の設定ファイルのみをサポートしています。他のエンコーディング (UTF16LE, UTF16BE, UTF32LE, UTF32BE 等) を使用した場合、変換エラーが生じます。

YAMLベースフォーマット

YAMLエクスポート形式には次のノードが含まれます:

• Zabbix YAMLエクスポートのルートノード
• エクスポート・バージョン
• エクスポートが作成された日付(ISO 8601の長い形式)

zabbix_export:
         version: '6.0'
         date: '2020-04-22T06:20:11Z'

他のノードはエクスポートされたオブジェクトに依存します。

XMLフォーマット

XMLエクスポート形式には次のタグが含まれます。

• XML文書のデフォルト・ヘッダー
• Zabbix XMLエクスポートのルートタグ
• エクスポート・バージョン
• エクスポートが作成された日付(ISO 8601 の長い形式）

<?xml version="1.0" encoding="UTF-8"?>
       <zabbix_export>
           <version>6.0</version>
           <date>2020-04-22T06:20:11Z</date>
       </zabbix_export>

その他のタグはエクスポートされたオブジェクトに依存します。

JSONフォーマット

JSON エクスポート形式には次のオブジェクトが含まれます。

• Zabbix JSONエクスポートのルートオブジェクト
• エクスポート・バージョン
• エクスポートが作成された日付(ISO 8601 の長い形式）

{
           "zabbix_export": {
               "version": "6.0",
               "date": "2020-04-22T06:20:11Z"
           }
       }

他のオブジェクトはエクスポートされたオブジェクトに依存します。