3 ローレベルディスカバリ

概要

Low-level discovery (LLD) は、ホスト上のさまざまなエンティティに対して、アイテム、トリガー、グラフを自動的に作成する方法を提供します。
たとえば、Zabbix は、各ファイルシステムやネットワークインターフェースごとにアイテムを手動で作成しなくても、マシン上のファイルシステムやネットワークインターフェースの監視を自動的に開始できます。
LLD はホストも作成でき、たとえばハイパーバイザー上で検出された 仮想マシンを登録する ことができます。
さらに、定期的に実行されるディスカバリの実際の結果に基づいて、不要になったエンティティを自動的に削除するよう Zabbix を設定することも可能です。

ユーザーは、特定の JSON プロトコルに従う限り、独自のディスカバリタイプを定義できます。

ディスカバリ処理の一般的なアーキテクチャは次のとおりです。

まず、ユーザーは Data collection > Templates の Discovery 列でディスカバリルールを作成します。
ディスカバリルールは、(1) 必要なエンティティ（たとえばファイルシステムやネットワークインターフェース）を検出するアイテムと、(2) そのアイテムの値に基づいて作成されるアイテム、トリガー、グラフのプロトタイプで構成されます。

必要なエンティティを検出するアイテムは、他の場所で見られる通常のアイテムと同様です。サーバーは Zabbix エージェント（またはそのアイテムに設定されたタイプのもの）にそのアイテムの値を要求し、エージェントはテキスト値で応答します。
違いは、エージェントが返す値に、検出されたエンティティの一覧が JSON 形式で含まれている必要があることです。
この形式の詳細はカスタムディスカバリチェックの実装者にとってのみ重要ですが、返される値には macro → value のペアの一覧が含まれていることを知っておく必要があります。
たとえば、アイテム net.if.discovery は 2 つのペア、{#IFNAME} → lo と {#IFNAME} → eth0 を返す場合があります。

これらのマクロは、名前、キー、その他のプロトタイプフィールドで使用され、そこで受け取った値に置き換えられて、検出された各エンティティに対する実際のアイテム、トリガー、グラフ、さらにはホストを作成します。
LLD マクロの使用方法については、オプション の一覧を参照してください。

サーバーがディスカバリアイテムの値を受け取ると、macro → value のペアを確認し、各ペアに対して、そのプロトタイプに基づいて実際のアイテム、トリガー、グラフを生成します。
上記の "net.if.discovery" の例では、サーバーはループバックインターフェース "lo" 用のアイテム、トリガー、グラフのセットを 1 つ生成し、インターフェース "eth0" 用にもう 1 セット生成します。

Zabbix 4.2 以降、low-level discovery ルールが返す JSON の形式が変更されています。
JSON に "data" オブジェクトが含まれていることは、もはや期待されません。
low-level discovery は、アイテム値の前処理や JSON ドキュメント内の low-level discovery マクロ値へのカスタムパスなどの新機能をサポートするため、配列を含む通常の JSON を受け入れるようになりました。

組み込みのディスカバリキーは、JSON ドキュメントのルートに LLD 行の配列を返すよう更新されています。
配列フィールドがキーとして {#MACRO} 構文を使用している場合、Zabbix はマクロと値を自動的に抽出します。
今後追加されるネイティブのディスカバリチェックでは、"data" 要素を使わない新しい構文が使用されます。
low-level discovery の値を処理する際は、まずルートが特定されます（$. または $.data の配列）。

"data" 要素はディスカバリに関連するすべてのネイティブアイテムから削除されましたが、後方互換性のため、Zabbix は引き続き "data" 要素を含む JSON 表記を受け入れます。ただし、その使用は推奨されません。
JSON に 1 つの "data" 配列要素のみを持つオブジェクトが含まれている場合、その内容は JSONPath $.data を使用して自動的に抽出されます。
low-level discovery は現在、JSONPath 構文で指定されたカスタムパスを持つ、任意のユーザー定義 LLD マクロも受け入れます。

こちらも参照: 検出されたエンティティ

ローレベルディスカバリの設定

ここでは、ファイルシステムのディスカバリを例に、ローレベルディスカバリについて説明します。

ディスカバリを設定するには、次の手順を実行します。

1. Data collection > Templates または Hosts に移動します。
2. 対象のテンプレート/ホストの行にある Discovery をクリックします。

3. 画面右上の Create discovery rule をクリックします。
4. 必要な詳細を入力して、ディスカバリルールのフォームを完成させます。

ディスカバリルール

ディスカバリルールのフォームには5つのタブがあり、左から右へ、ディスカバリ中のデータフローを表しています。

• ディスカバリルール - 主に、ディスカバリデータを取得するための組み込みアイテムまたはカスタムスクリプトを指定します。
• 前処理 - 検出されたデータに前処理を適用します。
• LLDマクロ - 検出されたアイテム、トリガーなどで使用するためのマクロ値を抽出できます。
• フィルター - 検出された値を絞り込めます。
• オーバーライド - 特定の検出オブジェクトに適用する際に、アイテム、トリガー、グラフ、またはホストプロトタイプを変更できます。

ディスカバリルール タブには、ディスカバリに使用するアイテムキー（およびいくつかの一般的なディスカバリルール属性）が含まれます。

必須の入力フィールドには赤いアスタリスクが付いています。

前処理

前処理 タブでは、ディスカバリの結果に適用する変換ルールを定義できます。
この手順では、1つまたは複数の変換を指定できます。
変換は、定義された順序で実行されます。
すべての前処理は Zabbix サーバーによって実行されます。

関連項目:

• 前処理の詳細
• 前処理のテスト

このディスカバリルールがテンプレート経由でホストに適用されている場合、このタブの内容は読み取り専用になります。

カスタムマクロ

LLDマクロ タブでは、カスタムの低レベルディスカバリマクロを指定できます。

カスタムマクロは、返された JSON に必要なマクロがすでに定義されていない場合に便利です。
たとえば、次のようなケースです。

• ファイルシステムディスカバリ用のネイティブな vfs.fs.discovery キーは、{#FSNAME}、{#FSTYPE} などの事前定義済み LLD マクロを含む JSON を返します。
  これらのマクロは、アイテム、トリガープロトタイプ（このページの後続セクションを参照）で直接使用できます。カスタムマクロを定義する必要はありません。
• vfs.fs.get エージェントアイテムも filesystem data を含む JSON を返しますが、事前定義済みの LLD マクロは含まれません。
  この場合は、マクロを自分で定義し、JSONPath を使用して JSON 内の値にマッピングできます。

抽出された値は、ディスカバーされたアイテム、トリガーなどで使用できます。
値は、ディスカバリの結果と、これまでに実行された前処理ステップの結果から抽出されることに注意してください。

フィルター

フィルターは、条件に一致するエンティティに対してのみ、実際のアイテム、トリガー、およびグラフを生成するために使用できます。
Filters タブには、ディスカバリ値をフィルタリングできるディスカバリルールのフィルター定義が含まれています。

たとえば、C:, D:, E: のファイルシステムだけに関心がある場合は、Macro フィールドに {#FSNAME} を、Regular expression フィールドに ^C|^D|^E を指定します。
フィルタリングは、{#FSTYPE} マクロを使用してファイルシステムタイプでも可能です（例: ^ext|^reiserfs）。また、{#FSDRIVETYPE} マクロを使用してドライブタイプでも可能です（Windows エージェントでのみサポート、例: fixed）。

正規表現をテストするには、たとえば grep -E を使用できます。

for f in ext2 nfs reiserfs smbfs; 
do echo $f | grep -E '^ext|^reiserfs' || echo "SKIP: $f"; 
done

上書き

Overrides タブでは、検出されたオブジェクトのうち、指定した条件に一致するものに対して、アイテム、トリガー、グラフ、ホストのプロトタイプ、またはそれらの属性を変更するルールを設定できます。

上書きがある場合は、並べ替え可能なドラッグ＆ドロップの一覧に表示され、定義された順序で実行されます。新しい上書きの詳細を設定するには、Overrides ブロックの をクリックします。
既存の上書きを編集するには、上書き名をクリックします。
ポップアップウィンドウが開き、上書きルールの詳細を編集できます。

必須パラメータには赤いアスタリスクが付いています。

操作の設定

新しい操作の詳細を設定するには、Operations ブロックの をクリックします。
既存の操作を編集するには、操作の横にある をクリックします。
操作の詳細を編集できるポップアップウィンドウが開きます。

Parameter			Description
Object			4 種類のオブジェクトを使用できます: アイテムプロトタイプ トリガープロトタイプ グラフプロトタイプ ホストプロトタイプ
Condition			操作を適用する対象エンティティをフィルタリングできます。
	Operator		サポートされる演算子: equals - このプロトタイプに適用 does not equal - これ以外のすべてのプロトタイプに適用 contains - プロトタイプ名にこの文字列が含まれる場合に適用 does not contain - プロトタイプ名にこの文字列が含まれない場合に適用 matches - プロトタイプ名が正規表現に一致する場合に適用 does not match - プロトタイプ名が正規表現に一致しない場合に適用
	Pattern		正規表現 または検索する文字列。
	Object: Item prototype
		Create enabled	チェックボックスをオンにすると、元のアイテムプロトタイプ設定を上書きするためのボタンが表示されます: Yes - アイテムは有効な状態で追加されます。 No - アイテムは検出されたエンティティに追加されますが、無効な状態になります。
		Discover	チェックボックスをオンにすると、元のアイテムプロトタイプ設定を上書きするためのボタンが表示されます: Yes - アイテムが追加されます。 No - アイテムは追加されません。
		Update interval	チェックボックスをオンにすると、アイテムの間隔を変更するための 2 つのオプションが表示されます: Delay - アイテムの更新間隔。User macros、LLD macros、および time suffixes（例: 30s、1m、2h、1d）がサポートされます（LLD macro のサポートは Zabbix 7.0.27 で復元されました）。Custom interval を使用する場合は 0 に設定してください。 Custom interval - をクリックして、柔軟な間隔/スケジュール間隔を指定します。詳細は Custom intervals を参照してください。
		History	チェックボックスをオンにすると、アイテムの履歴保存期間を変更するためのボタンが表示されます: Do not store - 選択すると、履歴は保存されません。 Store up to - 選択すると、右側に保存期間を指定する入力欄が表示されます。User macros と LLD macros がサポートされます（LLD macro のサポートは Zabbix 7.0.27 で復元されました）。
		Trends	チェックボックスをオンにすると、アイテムのトレンド保存期間を変更するためのボタンが表示されます: Do not store - 選択すると、トレンドは保存されません。 Store up to - 選択すると、右側に保存期間を指定する入力欄が表示されます。User macros と LLD macros がサポートされます（LLD macro のサポートは Zabbix 7.0.27 で復元されました）。
		Tags	チェックボックスをオンにすると、タグと値のペアを指定するための新しいブロックが表示されます。User macros と LLD macros がサポートされます。 これらのタグは、タグ名が一致していても、アイテムプロトタイプで指定されたタグに追加されます。
	Object: Trigger prototype
		Create enabled	チェックボックスをオンにすると、元のトリガープロトタイプ設定を上書きするためのボタンが表示されます: Yes - トリガーは有効な状態で追加されます。 No - トリガーは検出されたエンティティに追加されますが、無効な状態になります。
		Discover	チェックボックスをオンにすると、元のトリガープロトタイプ設定を上書きするためのボタンが表示されます: Yes - トリガーが追加されます。 No - トリガーは追加されません。
		Severity	チェックボックスをオンにすると、トリガーの深刻度ボタンが表示され、トリガーの深刻度を変更できます。
		Tags	チェックボックスをオンにすると、タグと値のペアを指定するための新しいブロックが表示されます。User macros と LLD macros がサポートされます。 これらのタグは、タグ名が一致していても、トリガープロトタイプで指定されたタグに追加されます。
	Object: Graph prototype
		Discover	チェックボックスをオンにすると、元のグラフプロトタイプ設定を上書きするためのボタンが表示されます: Yes - グラフが追加されます。 No - グラフは追加されません。
	Object: Host prototype
		Create enabled	チェックボックスをオンにすると、元のホストプロトタイプ設定を上書きするためのボタンが表示されます: Yes - ホストは有効な状態で作成されます。 No - ホストは無効な状態で作成されます。
		Discover	チェックボックスをオンにすると、元のホストプロトタイプ設定を上書きするためのボタンが表示されます: Yes - ホストが検出されます。 No - ホストは検出されません。
		Link templates	チェックボックスをオンにすると、テンプレートを指定する入力欄が表示されます。テンプレート名を入力し始めるか、フィールドの横にある Select をクリックして、ポップアップウィンドウの一覧からテンプレートを選択します。 この上書きで指定したテンプレートは、ホストプロトタイプにすでにリンクされているすべてのテンプレートに追加されます。
		Tags	チェックボックスをオンにすると、タグと値のペアを指定するための新しいブロックが表示されます。User macros と LLD macros がサポートされます。 これらのタグは、タグ名が一致していても、ホストプロトタイプで指定されたタグに追加されます。
		Host inventory	チェックボックスをオンにすると、ホストプロトタイプに対して異なるインベントリ mode を選択するためのボタンが表示されます: Disabled - ホストインベントリを入力しない Manual - 手動で詳細を入力する Automated - 収集したメトリクスに基づいてホストインベントリデータを自動入力する。

フォームのボタン

フォームの下部にあるボタンでは、いくつかの操作を実行できます。

	ディスカバリルールを追加します。このボタンは、新しいディスカバリルールでのみ使用できます。
	ディスカバリルールのプロパティを更新します。このボタンは、既存のディスカバリルールでのみ使用できます。
	現在のディスカバリルールのプロパティに基づいて、別のディスカバリルールを作成します。
	ディスカバリルールに基づいて、ただちにディスカバリを実行します。ディスカバリルールは、すでに存在している必要があります。詳細はこちらを参照してください。 注：ただちにディスカバリを実行した場合、設定キャッシュは更新されないため、ディスカバリルール設定に対するごく最近の変更は結果に反映されません。
	ディスカバリルールの設定をテストします。このボタンを使用すると、変更を永続的に適用することなく、設定内容（接続性やパラメータの正確性など）を確認できます。
	ディスカバリルールを削除します。
	ディスカバリルールのプロパティの編集をキャンセルします。

検出されたエンティティ

以下のスクリーンショットは、検出されたアイテム、トリガー、グラフがホストの設定でどのように表示されるかを示しています。
検出されたエンティティには、それらの元となったディスカバリルールへのオレンジ色のリンクが接頭表示されます。

同じ一意性条件を持つ既存のエンティティがすでに存在する場合、検出されたエンティティは作成されないことに注意してください。例えば、同じキーを持つアイテムや同じ名前を持つグラフなどです。
この場合、Webインターフェースには、ローレベルディスカバリルールが特定のエンティティを作成できなかったことを示すエラーメッセージが表示されます。
ただし、エンティティを作成できずスキップされたものがあっても、ディスカバリルール自体が未サポートになることはありません。
ディスカバリルールは引き続き他のエンティティの作成/更新を行います。

検出されたエンティティ（ホスト、ファイルシステム、インターフェースなど）が検出されなくなった場合（またはフィルターを通過しなくなった場合）、それに基づいて作成されたエンティティは自動的に無効化され、最終的に削除されることがあります。

失われたリソースは、Disable lost resources パラメータの値に基づいて自動的に無効化されることがあります。
これは、失われたホスト、アイテム、トリガーに影響します。

失われたリソースは、Delete lost resources パラメータの値に基づいて自動的に削除されることがあります。
これは、失われたホスト、ホストグループ、アイテム、トリガー、グラフに影響します。

検出されたエンティティが「Not discovered anymore」になると、エンティティ一覧に有効期間インジケーターが表示されます。
その上にマウスポインターを移動すると、状態の詳細を示すメッセージが表示されます。

エンティティが削除対象としてマークされていても、想定された時刻に削除されなかった場合（ディスカバリルールまたはアイテムのホストが無効な場合）、次回ディスカバリルールが処理されたときに削除されます。

削除対象としてマークされた他のエンティティを含むエンティティは、ディスカバリルールレベルで変更されても更新されません。
例えば、LLDベースのトリガーは、削除対象としてマークされたアイテムを含んでいる場合、更新されません。

その他のディスカバリの種類

その他の標準搭載のディスカバリの詳細および実施方法については、以下のセクションを参照してください。

• ネットワークインターフェースのディスカバリ
• CPUおよびCPUコアのディスカバリ
• SNMP OIDのディスカバリ
• JMXオブジェクトのディスカバリ
• ODBC SQLクエリを使用したディスカバリ
• Windowsサービスのディスカバリ
• Zabbixにおけるホストインターフェースのディスカバリ

ディスカバリアイテムのJSON形式の詳細、および独自のファイルシステムディスカバラをPerlスクリプトとして実装する方法の例については、カスタムLLDルールの作成を参照してください。