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: のファイルシステムだけに関心がある場合は、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）がサポートされます（LLD macro のサポートは Zabbix 7.4.11 で復元されました）。Custom interval を使用する場合は 0 に設定してください。 Custom interval - をクリックして、柔軟な間隔/スケジュール間隔を指定します。詳細は Custom intervals を参照してください。
		History	チェックボックスをオンにすると、アイテムの履歴保存期間を変更するためのボタンが表示されます: Do not store - 選択すると、履歴は保存されません。 Store up to - 選択すると、右側に保存期間を指定する入力欄が表示されます。User macros と LLD macros がサポートされます（LLD macro のサポートは Zabbix 7.4.11 で復元されました）。
		Trends	チェックボックスをオンにすると、アイテムのトレンド保存期間を変更するためのボタンが表示されます: Do not store - 選択すると、トレンドは保存されません。 Store up to - 選択すると、右側に保存期間を指定する入力欄が表示されます。User macros と LLD macros がサポートされます（LLD macro のサポートは Zabbix 7.4.11 で復元されました）。
		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 をクリックして、ポップアップウィンドウの一覧からテンプレートを選択します。 この上書きで指定したテンプレートは、すでに host prototype にリンクされているすべてのテンプレートに追加されます。
		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ルールの作成を参照してください。