ローレベルディスカバリ

概要

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"}]}

フィルター

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

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

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

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

オーバーライド

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

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

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

操作の設定

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

パラメータ			説明
オブジェクト			5種類のオブジェクトを使用できます。 アイテムプロトタイプ トリガープロトタイプ グラフプロトタイプ ホストプロトタイプ ディスカバリプロトタイプ
条件			操作を適用するエンティティをフィルタリングできます。
	演算子		サポートされる演算子： 等しい - このプロトタイプに適用 等しくない - このプロトタイプを除くすべてのプロトタイプに適用 含む - プロトタイプ名にこの文字列が含まれる場合に適用 含まない - プロトタイプ名にこの文字列が含まれない場合に適用 一致する - プロトタイプ名が正規表現に一致する場合に適用 一致しない - プロトタイプ名が正規表現に一致しない場合に適用
	パターン		検索する正規表現または文字列。
	オブジェクト：アイテムプロトタイプ
		有効として作成	チェックボックスを選択すると、元のアイテムプロトタイプ設定を上書きするボタンが表示されます。 はい - アイテムは有効な状態で追加されます。 いいえ - アイテムは検出済みエンティティに追加されますが、無効な状態になります。
		検出	チェックボックスを選択すると、元のアイテムプロトタイプ設定を上書きするボタンが表示されます。 はい - アイテムが追加されます。 いいえ - アイテムは追加されません。
		更新間隔	チェックボックスを選択すると、アイテムに異なる間隔を設定できる2つのオプションが表示されます。 遅延 - アイテムの更新間隔。ユーザーマクロ、LLDマクロ、および時間のサフィックス（例：30s、1m、2h、1d）がサポートされます。カスタム間隔を使用する場合は0に設定してください。 カスタム間隔 - をクリックして、柔軟な間隔またはスケジュール間隔を指定します。詳細はカスタム間隔を参照してください。
		ヒストリ	チェックボックスを選択すると、アイテムの異なるヒストリ保存期間を設定できるボタンが表示されます。 保存しない - 選択すると、ヒストリは保存されません。 保存期間 - 選択すると、保存期間を指定する入力フィールドが右側に表示されます。ユーザーマクロおよびLLDマクロがサポートされます。
		トレンド	チェックボックスを選択すると、アイテムの異なるトレンド保存期間を設定できるボタンが表示されます。 保存しない - 選択すると、トレンドは保存されません。 保存期間 - 選択すると、保存期間を指定する入力フィールドが右側に表示されます。ユーザーマクロおよびLLDマクロがサポートされます。
		タグ	チェックボックスを選択すると、タグと値のペアを指定できる新しいブロックが表示されます。ユーザーマクロおよびLLDマクロがサポートされます。 これらのタグは、タグ名が一致する場合でも、アイテムプロトタイプで指定されたタグに追加されます。
	オブジェクト：トリガープロトタイプ
		有効として作成	チェックボックスを選択すると、元のトリガープロトタイプ設定を上書きするボタンが表示されます。 はい - トリガーは有効な状態で追加されます。 いいえ - トリガーは検出済みエンティティに追加されますが、無効な状態になります。
		検出	チェックボックスを選択すると、元のトリガープロトタイプ設定を上書きするボタンが表示されます。 はい - トリガーが追加されます。 いいえ - トリガーは追加されません。
		深刻度	チェックボックスを選択すると、トリガーの深刻度ボタンが表示され、トリガーの深刻度を変更できます。
		タグ	チェックボックスを選択すると、タグと値のペアを指定できる新しいブロックが表示されます。ユーザーマクロおよびLLDマクロがサポートされます。 これらのタグは、タグ名が一致する場合でも、トリガープロトタイプで指定されたタグに追加されます。
	オブジェクト：グラフプロトタイプ
		検出	チェックボックスを選択すると、元のグラフプロトタイプ設定を上書きするボタンが表示されます。 はい - グラフが追加されます。 いいえ - グラフは追加されません。
	オブジェクト：ホストプロトタイプ
		有効として作成	チェックボックスを選択すると、元のホストプロトタイプ設定を上書きするボタンが表示されます。 はい - ホストは有効な状態で作成されます。 いいえ - ホストは無効な状態で作成されます。
		検出	チェックボックスを選択すると、元のホストプロトタイプ設定を上書きするボタンが表示されます。 はい - ホストが検出されます。 いいえ - ホストは検出されません。
		テンプレートのリンク	チェックボックスを選択すると、テンプレートを指定する入力フィールドが表示されます。テンプレート名の入力を開始するか、フィールドの横にある選択をクリックし、ポップアップウィンドウの一覧からテンプレートを選択します。 このオーバーライドのテンプレートは、ホストプロトタイプにすでにリンクされているすべてのテンプレートに追加されます。
		ホストインベントリ	チェックボックスを選択すると、ホストプロトタイプの異なるインベントリモードを選択できるボタンが表示されます。 無効 - ホストインベントリにデータを入力しません 手動 - 詳細を手動で入力します 自動 - 収集したメトリクスに基づいてホストインベントリデータを自動入力します。
	オブジェクト：ディスカバリプロトタイプ
		有効として作成	チェックボックスを選択すると、元のディスカバリプロトタイプ設定を上書きするボタンが表示されます。 はい - ディスカバリルールは有効な状態で追加されます。 いいえ - ディスカバリルールは無効な状態で追加されます。
		検出	チェックボックスを選択すると、元のディスカバリプロトタイプ設定を上書きするボタンが表示されます。 はい - ディスカバリルールが追加されます。 いいえ - ディスカバリルールは追加されません。
		更新間隔	チェックボックスを選択すると、ディスカバリルールに異なる間隔を設定できる2つのオプションが表示されます。 遅延 - ルールの更新間隔。ユーザーマクロ、LLDマクロ、および時間のサフィックス（例：30s、1m、2h、1d）がサポートされます。カスタム間隔を使用する場合は0に設定してください。 カスタム間隔 - をクリックして、柔軟な間隔またはスケジュール間隔を指定します。詳細はカスタム間隔を参照してください。

フォームのボタン

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

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

検出されたエンティティ

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

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

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

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

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

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

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

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

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

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

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

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