設定のエクスポート/インポート
概要
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"
}
}
その他のオブジェクトは、エクスポートされるオブジェクトに依存します。