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

概要

低レベルディスカバリ（LLD）は、ホスト上のさまざまなエンティティに対してアイテム、トリガー、グラフを自動的に作成する方法を提供します。 たとえば、Zabbixは、各ファイルシステムやネットワークインターフェースのアイテムを手動で作成することなく、マシン上のファイルシステムやネットワークインターフェースの監視を自動的に開始できます。 LLDは、ハイパーバイザー上で検出された仮想マシンを自動的にホストとして作成したり、ネストされたディスカバリルールを作成して多段階のディスカバリを実現したりすることもできます。 さらに、Zabbixを設定して、定期的に実行されるディスカバリの実際の結果に基づいて不要なエンティティを自動的に削除することも可能です。

ユーザーは、特定のJSONプロトコルに従うことで、独自のディスカバリタイプを定義できます。

ディスカバリプロセスの一般的なアーキテクチャは以下の通りです。

まず、ユーザーはデータ収集 > テンプレートのディスカバリ列でディスカバリルールを作成します。 ディスカバリルールは、（1）必要なエンティティ（たとえば、ファイルシステムやネットワークインターフェース）を検出するアイテムと、（2）そのアイテムの値に基づいて作成されるアイテム、トリガー、グラフのプロトタイプで構成されます。

必要なエンティティを検出するアイテムは、他の場所で見られる通常のアイテムと同様です。サーバーはZabbixエージェント（またはアイテムのタイプに設定されているもの）にそのアイテムの値を要求し、エージェントはテキスト値で応答します。 違いは、エージェントが応答する値がJSON形式の検出されたエンティティのリストを含む必要があることです。 この形式の詳細はカスタムディスカバリチェックの実装者にとってのみ重要ですが、返される値にはマクロ→値のペアのリストが含まれていることを知っておく必要があります。 たとえば、アイテム「net.if.discovery」は、2つのペア「{#IFNAME}」→「lo」と「{#IFNAME}」→「eth0」を返す場合があります。

これらのマクロは、名前、キー、およびその他のプロトタイプフィールドで使用され、実際のアイテム、トリガー、グラフ、さらには検出された各エンティティのホストを作成するために受信した値に置き換えられます。 LLDマクロの使用に関するオプションの完全なリストを参照してください。

サーバーがディスカバリアイテムの値を受信すると、マクロ→値のペアを調べ、各ペアに基づいてプロトタイプから実際のアイテム、トリガー、グラフを生成します。 上記の「net.if.discovery」の例では、サーバーはループバックインターフェース「lo」用のアイテム、トリガー、グラフのセットと、インターフェース「eth0」用の別のセットを生成します。

Zabbix 4.2以降、低レベルディスカバリルールによって返されるJSONの形式が変更されていることに注意してください。 JSONに「data」オブジェクトが含まれていることは期待されなくなりました。 低レベルディスカバリは、アイテム値の前処理やJSONドキュメント内の低レベルディスカバリマクロ値へのカスタムパスなどの新機能をサポートするために、配列を含む通常のJSONを受け入れるようになりました。

組み込みのディスカバリキーは、JSONドキュメントのルートでLLD行の配列を返すように更新されています。 配列フィールドが{#MACRO}構文をキーとして使用している場合、Zabbixはマクロと値を自動的に抽出します。 新しいネイティブディスカバリチェックは、「data」要素なしで新しい構文を使用します。 低レベルディスカバリ値を処理する際、最初にルート（$.または$.dataの配列）が特定されます。

「data」要素はディスカバリに関連するすべてのネイティブアイテムから削除されていますが、後方互換性のためにZabbixは「data」要素を含むJSON表記も引き続き受け入れますが、その使用は推奨されません。 JSONが「data」配列要素のみを持つオブジェクトを含む場合、自動的にJSONPath $.dataを使用して要素の内容を抽出します。 低レベルディスカバリは、JSONPath構文で指定されたカスタムパスを持つユーザー定義のLLDマクロもオプションで受け入れるようになりました。

参照: 検出されたエンティティ

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

ファイルシステムディスカバリの例に基づいて、ローレベルディスカバリを説明します。

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

• データ収集 > テンプレート または ホスト に移動します。
• 適切なテンプレート/ホストの行で ディスカバリ をクリックします。

• 画面右上の ディスカバリルールの作成 をクリックします。
• ディスカバリルールのフォームに必要な詳細を入力します。

ディスカバリールール

ディスカバリールールのフォームには5つのタブがあり、左から右へディスカバリー中のデータフローを表しています:

• ディスカバリールール - ディスカバリーデータを取得するための組み込みアイテムまたはカスタムスクリプトを指定します。
• 前処理 - 検出されたデータに前処理を適用します。
• LLDマクロ - 検出されたアイテムやトリガーなどで使用するマクロ値を抽出できます。
• フィルター - 検出された値をフィルタリングできます。
• オーバーライド - 特定の検出オブジェクトに適用する際に、アイテム、トリガー、グラフ、ホストプロトタイプを変更できます。

ディスカバリールールタブには、ディスカバリーに使用するアイテムキー（およびいくつかの一般的なディスカバリールール属性）が含まれています:

すべての必須入力フィールドには赤いアスタリスクが付いています。

前処理

前処理タブでは、ディスカバリの結果に適用する変換ルールを定義できます。 このステップでは、1つまたは複数の変換が可能です。 変換は定義された順序で実行されます。 すべての前処理はZabbixサーバーによって実行されます。

関連情報:

• 前処理の詳細
• 前処理のテスト

ディスカバリルールがテンプレート経由でホストに適用されている場合、このタブの内容は読み取り専用であることに注意してください。

カスタムマクロ

LLDマクロタブでは、カスタムのローレベルディスカバリマクロを指定できます。

カスタムマクロは、返されるJSONに必要なマクロがすでに定義されていない場合に便利です。 例えば、以下のような場合です。

• ファイルシステムディスカバリ用のネイティブなvfs.fs.discoveryキーは、{#FSNAME}、{#FSTYPE}などのいくつかの事前定義されたLLDマクロを持つJSONを返します。 これらのマクロは、アイテムやトリガープロトタイプ（ページの後続セクションを参照）で直接使用できます。カスタムマクロを定義する必要はありません。
• vfs.fs.getエージェントアイテムもファイルシステムデータを含むJSONを返しますが、事前定義されたLLDマクロはありません。 この場合、マクロを自分で定義し、JSONPathを使用してJSON内の値にマッピングできます。

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

フィルター

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

オーバーライド

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

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

すべての必須パラメータは赤いアスタリスクでマークされています。

操作の設定

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

フォームボタン

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

検出されたエンティティ

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

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

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

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

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

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

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

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

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

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

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

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