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		正規表現 または検索する文字列。
	Object: Item prototype
		Create enabled	チェックボックスをオンにすると、元の item prototype 設定を上書きするボタンが表示されます: Yes - アイテムは有効な状態で追加されます。 No - アイテムは検出されたエンティティに追加されますが、無効な状態になります。
		Discover	チェックボックスをオンにすると、元の item prototype 設定を上書きするボタンが表示されます: 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 をサポートします。 これらのタグは、タグ名が一致していても、item prototype で指定されたタグに追加されます。
	Object: Trigger prototype
		Create enabled	チェックボックスをオンにすると、元の trigger prototype 設定を上書きするボタンが表示されます: Yes - トリガーは有効な状態で追加されます。 No - トリガーは検出されたエンティティに追加されますが、無効な状態になります。
		Discover	チェックボックスをオンにすると、元の trigger prototype 設定を上書きするボタンが表示されます: Yes - トリガーが追加されます。 No - トリガーは追加されません。
		Severity	チェックボックスをオンにすると、トリガーの深刻度ボタンが表示され、トリガーの深刻度を変更できます。
		Tags	チェックボックスをオンにすると、タグと値のペアを指定できる新しいブロックが表示されます。User macros と LLD macros をサポートします。 これらのタグは、タグ名が一致していても、trigger prototype で指定されたタグに追加されます。
	Object: Graph prototype
		Discover	チェックボックスをオンにすると、元の graph prototype 設定を上書きするボタンが表示されます: Yes - グラフが追加されます。 No - グラフは追加されません。
	Object: Host prototype
		Create enabled	チェックボックスをオンにすると、元の host prototype 設定を上書きするボタンが表示されます: Yes - ホストは有効な状態で作成されます。 No - ホストは無効な状態で作成されます。
		Discover	チェックボックスをオンにすると、元の host prototype 設定を上書きするボタンが表示されます: Yes - ホストが検出されます。 No - ホストは検出されません。
		Link templates	チェックボックスをオンにすると、テンプレートを指定する入力欄が表示されます。テンプレート名の入力を開始するか、フィールドの横にある Select をクリックして、ポップアップウィンドウの一覧からテンプレートを選択します。 このオーバーライドのテンプレートは、ホストプロトタイプにすでにリンクされているすべてのテンプレートに追加されます。
		Tags	チェックボックスをオンにすると、タグと値のペアを指定できる新しいブロックが表示されます。User macros と LLD macros をサポートします。 これらのタグは、タグ名が一致していても、host prototype で指定されたタグに追加されます。
		Host inventory	チェックボックスをオンにすると、host prototype に対して別の inventory mode を選択するボタンが表示されます: Disabled - ホストインベントリを入力しない Manual - 詳細を手動で指定する Automated - 収集したメトリクスに基づいてホストインベントリデータを自動入力する。
	Object: Discovery prototype
		Create enabled	チェックボックスをオンにすると、元の discovery prototype 設定を上書きするボタンが表示されます: Yes - ディスカバリルールは有効な状態で追加されます。 No - ディスカバリルールは無効な状態で追加されます。
		Discover	チェックボックスをオンにすると、元の discovery prototype 設定を上書きするボタンが表示されます: 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ルールの作成を参照してください。