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

概要

Low-level discovery (LLD) は、ホスト上のエンティティ（例: ファイルシステム、ネットワークインターフェース）を自動的に検出し、各エンティティごとに手動設定を行わなくても、対応するアイテム、トリガー、グラフを作成します。

LLD を使用するには、エンティティを記述する JSON データを収集する discovery rule を作成し、各エンティティに対する prototypes（item、trigger、graph）を用意します。

rule によって返される JSON はオブジェクトの配列でなければならず、各オブジェクトはキーと値のペアを使用して 1 つの検出済みエンティティを表します。たとえば、net.if.discovery を持つ discovery rule は次のような値を返す場合があります。

[
  {"{#IFNAME}": "lo"},
  {"{#IFNAME}": "eth0"}
]

その後、対応するアイテム、トリガー、グラフのセットが prototypes から作成されます。インターフェースごとに 1 つずつ、lo と eth0 の分が作成されます。

オブジェクトに {#MACRO} 形式のキーが含まれている場合、それらのマクロは prototypes で直接使用されます。含まれていない場合、または追加の/カスタムのマクロが必要な場合は、マクロを 手動で定義 し、JSONPath を使用して JSON フィールドにマッピングできます。

LLD は ホスト も作成でき、たとえばハイパーバイザー上で検出された 仮想マシン に対して利用できます。また、複数レベルの検出のために ネストされた discovery rules もサポートします。

もはや検出されなくなったエンティティは、自動的に 無効化または削除 できます。

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

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

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

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エージェントアイテムもファイルシステムデータを含むJSONを返しますが、事前定義済みのLLDマクロは含まれていません。 この場合は、マクロを自分で定義し、JSONPathを使用してJSON内の値にマッピングできます。

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

フィルター

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

たとえば、C:、D:、E:のファイルシステムだけが必要な場合は、マクロフィールドに {#FSNAME} を、正規表現フィールドに ^C|^D|^E を入力できます。
{#FSTYPE} マクロ（例: ^ext|^reiserfs）を使用してファイルシステムのタイプでフィルタリングすることもできます。また、ドライブタイプ（Windowsエージェントでのみサポート）では {#FSDRIVETYPE} マクロ（例: fixed）を使用できます。

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

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

オーバーライド

オーバーライドタブでは、指定した条件に一致する検出済みオブジェクトについて、アイテム、トリガー、グラフ、ホスト、ディスカバリのプロトタイプの一覧または属性を変更するルールを設定できます。

オーバーライド（存在する場合）は、ドラッグアンドドロップで順序を変更できる一覧に表示され、定義された順序で実行されます。新しいオーバーライドの詳細を設定するには、Overrides ブロックの をクリックします。 既存のオーバーライドを編集するには、オーバーライド名をクリックします。 オーバーライドルールの詳細を編集できるポップアップウィンドウが開きます。

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

操作の設定

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

パラメータ			説明
Object			使用できるオブジェクトタイプは5つです。 アイテムプロトタイプ トリガープロトタイプ グラフプロトタイプ ホストプロトタイプ ディスカバリプロトタイプ
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 - アイテムの更新間隔。ユーザーマクロ、LLDマクロ、および時間のサフィックス（例：30s、1m、2h、1d）がサポートされています（LLDマクロのサポートはZabbix 7.4.11で復元されました）。Custom interval を使用する場合は0に設定してください。 Custom interval - をクリックして、柔軟な間隔またはスケジュール間隔を指定します。詳細はカスタム間隔を参照してください。
		History	チェックボックスを選択すると、アイテムに異なるヒストリ保存期間を設定できるボタンが表示されます。 Do not store - 選択すると、ヒストリは保存されません。 Store up to - 選択すると、保存期間を指定する入力フィールドが右側に表示されます。ユーザーマクロおよびLLDマクロがサポートされています（LLDマクロのサポートはZabbix 7.4.11で復元されました）。
		Trends	チェックボックスを選択すると、アイテムに異なるトレンド保存期間を設定できるボタンが表示されます。 Do not store - 選択すると、トレンドは保存されません。 Store up to - 選択すると、保存期間を指定する入力フィールドが右側に表示されます。ユーザーマクロおよびLLDマクロがサポートされています（LLDマクロのサポートはZabbix 7.4.11で復元されました）。
		Tags	チェックボックスを選択すると、タグと値のペアを指定できる新しいブロックが表示されます。ユーザーマクロおよびLLDマクロがサポートされています。 これらのタグは、タグ名が一致する場合でも、アイテムプロトタイプに指定されたタグに追加されます。
	Object: Trigger prototype
		Create enabled	チェックボックスを選択すると、元のトリガープロトタイプの設定を上書きするボタンが表示されます。 Yes - トリガーを有効な状態で追加します。 No - トリガーを検出されたエンティティに追加しますが、無効な状態にします。
		Discover	チェックボックスを選択すると、元のトリガープロトタイプの設定を上書きするボタンが表示されます。 Yes - トリガーを追加します。 No - トリガーを追加しません。
		Severity	チェックボックスを選択すると、トリガーの深刻度ボタンが表示され、トリガーの深刻度を変更できます。
		Tags	チェックボックスを選択すると、タグと値のペアを指定できる新しいブロックが表示されます。ユーザーマクロおよびLLDマクロがサポートされています。 これらのタグは、タグ名が一致する場合でも、トリガープロトタイプに指定されたタグに追加されます。
	Object: Graph prototype
		Discover	チェックボックスを選択すると、元のグラフプロトタイプの設定を上書きするボタンが表示されます。 Yes - グラフを追加します。 No - グラフを追加しません。
	Object: Host prototype
		Create enabled	チェックボックスを選択すると、元のホストプロトタイプの設定を上書きするボタンが表示されます。 Yes - ホストを有効な状態で作成します。 No - ホストを無効な状態で作成します。
		Discover	チェックボックスを選択すると、元のホストプロトタイプの設定を上書きするボタンが表示されます。 Yes - ホストを検出します。 No - ホストを検出しません。
		Link templates	チェックボックスを選択すると、テンプレートを指定する入力フィールドが表示されます。テンプレート名の入力を開始するか、フィールドの横にある Select をクリックして、ポップアップウィンドウの一覧からテンプレートを選択します。 このオーバーライドのテンプレートは、ホストプロトタイプにすでにリンクされているすべてのテンプレートに追加されます。
		Tags	チェックボックスを選択すると、タグと値のペアを指定できる新しいブロックが表示されます。ユーザーマクロおよびLLDマクロがサポートされています。 これらのタグは、タグ名が一致する場合でも、ホストプロトタイプに指定されたタグに追加されます。
		Host inventory	チェックボックスを選択すると、ホストプロトタイプの異なるインベントリモードを選択できるボタンが表示されます。 Disabled - ホストインベントリにデータを入力しません。 Manual - 詳細を手動で入力します。 Automated - 収集したメトリクスに基づいてホストインベントリデータを自動入力します。
	Object: Discovery prototype
		Create enabled	チェックボックスを選択すると、元のディスカバリプロトタイプの設定を上書きするボタンが表示されます。 Yes - ディスカバリルールを有効な状態で追加します。 No - ディスカバリルールを無効な状態で追加します。
		Discover	チェックボックスを選択すると、元のディスカバリプロトタイプの設定を上書きするボタンが表示されます。 Yes - ディスカバリルールを追加します。 No - ディスカバリルールを追加しません。
		Update interval	チェックボックスを選択すると、ディスカバリルールに異なる間隔を設定できる2つのオプションが表示されます。 Delay - ルールの更新間隔。ユーザーマクロ、LLDマクロ、および時間のサフィックス（例：30s、1m、2h、1d）がサポートされています。Custom interval を使用する場合は0に設定してください。 Custom interval - をクリックして、柔軟な間隔またはスケジュール間隔を指定します。詳細はカスタム間隔を参照してください。

フォームのボタン

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

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

検出されたエンティティ

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

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

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

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

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

検出されたエンティティが「これ以上検出されない」状態になると、エンティティリストにライフタイムインジケーターが表示されます。 マウスポインターをその上に移動すると、ステータスの詳細を示すメッセージが表示されます。

エンティティが削除対象としてマークされたが、期待された時刻に削除されなかった場合（ディスカバリールールやアイテムホストが無効化された場合）、次回ディスカバリールールが処理される際に削除されます。

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

その他のディスカバリタイプ

他の種類の標準ディスカバリについての詳細やハウツーは、以下のセクションで確認できます。

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

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