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

概要

Zabbix のエクスポート/インポート機能を使用すると、ある Zabbix システムと別の Zabbix システムの間で、さまざまな設定エンティティを交換できます。

この機能の一般的な使用例は次のとおりです。

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

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

エクスポート形式

データは Zabbix Webインターフェース または Zabbix API を使用してエクスポートできます。対応しているエクスポート形式は YAML、XML、JSON です。

エクスポートの詳細

  • サポートされているすべての要素は、1つのファイルにエクスポートされます。
  • リンクされたテンプレートから継承されたホストおよびテンプレートのエンティティ(アイテム、トリガー、グラフ、ディスカバリルール)はエクスポートされません。 これらのエンティティに対してホストレベルで行われた変更(たとえば、アイテムの間隔の変更、正規表現の修正、または low-level discovery ルールへのプロトタイプの追加)は、エクスポート時に失われます。インポート時には、リンクされたテンプレートのすべてのエンティティが元のリンク先テンプレートと同じように再作成されます。
  • low-level discovery によって作成されたエンティティ、およびそれらに依存するエンティティはエクスポートされません。たとえば、LLDルールによって生成されたアイテム用に作成されたトリガーはエクスポートされません。
  • エクスポート対象のホスト/テンプレートにタイムアウトをサポートするエンティティが含まれている場合、それらのエンティティに個別のタイムアウトが設定されていれば、そのタイムアウト値もエクスポートされます。

インポートの詳細

  • インポートは最初のエラーで停止します。
  • 画像インポート中に既存の画像を更新する場合、"imagetype" フィールドは無視されます。つまり、インポートによって画像タイプを変更することはできません。
  • "Delete missing" オプションを使用してホスト/テンプレートをインポートする場合、インポートファイルに存在しないホスト/テンプレートマクロは、インポート後にホスト/テンプレートから削除されます。
  • アイテム、トリガー、グラフ、discoveryRules、itemPrototypes、triggerPrototypes、graphPrototypes の空のタグは意味を持ちません。つまり、存在しない場合と同じです。
  • インポートされたホスト/テンプレートのエンティティに独自のタイムアウト設定がある場合は、それが適用されます。そうでない場合は、プロキシ/グローバルのタイムアウトが適用されます。
  • インポートは YAML、XML、JSON をサポートします。インポートファイルには正しい拡張子が必要です。YAML は .yaml および .yml、XML は .xml、JSON は .json です。サポートされる XML バージョンについては、互換性情報 を参照してください。
  • インポートは UTF-8 エンコーディングの設定ファイルのみをサポートします (BOM の有無は問いません)。その他のエンコーディング (UTF16LE、UTF16BE、UTF32LE、UTF32BE など) は、インポート変換エラーになります。

YAMLベース形式

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

  • Zabbix YAMLエクスポートのルートノード
  • エクスポートバージョン
zabbix_export:
  version: '8.0'

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

XML形式

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

  • XMLドキュメントのデフォルトヘッダー
  • Zabbix XMLエクスポートのルートタグ
  • エクスポートバージョン
<?xml version="1.0" encoding="UTF-8"?>
<zabbix_export>
    <version>8.0</version>
</zabbix_export>

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

JSON形式

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

  • Zabbix JSONエクスポートのルートオブジェクト
  • エクスポートバージョン
{
    "zabbix_export": {
        "version": "8.0"
    }
}

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