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にすでに {#MACRO} 形式のキーが含まれていない場合に、カスタム LLDマクロ を指定できます。

たとえば、vfs.fs.get エージェントアイテムキーは、事前定義されたLLDマクロを含まないJSON filesystem data を返します。
ここでは、マクロを手動で定義し、JSONPath 式を使用してJSON内の値にマッピングします。

検出ルールは、ルート ($.) にJSON配列を返す必要があります。
後方互換性のため、単一の "data" 配列を含むJSONオブジェクトも受け入れられます。この場合、"data" 配列は自動的に展開されます。

{"data":[{"foo":"bar"}, {"foo":"baz"}]}

フィルター

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

フォームボタン

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

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

検出されたエンティティ

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

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

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

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

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

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

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

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

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

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

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

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