Documentation
Table of Contents
3 ローレベルディスカバリ
概要
ローレベルディスカバリにより、コンピューター上の种々の要素に対してアイテム、トリガー、グラフを自动的に作成できます。例えば、窜补产产颈虫は使用しているマシン上のファイルシステムまたはネットワークインターフェースの监视を自动的に开始できます。そのために、各ファイルシステムまたはネットワークインターフェースに対して手动でアイテムを作成する必要はありません。さらに、定期的に実施されるディスカバリの実际の结果に基づいて不要な要素を自动的に削除するように、窜补产产颈虫を设定することができます。
窜补产产颈虫では、次の3つのタイプのアイテムディスカバリがサポートされており、すぐに利用できます。
- ファイルシステムのディスカバリ
- ネットワークインターフェースのディスカバリ
- SNMP OIDのディスカバリ
ユーザーは、特定の闯厂翱狈プロトコルに従うという条件で、独自のタイプのディスカバリを定义できます。
ディスカバリプロセスの一般的なアーキテクチャーは、次のとおりです。
最初に、摆设定闭→摆テンプレート闭→摆ディスカバリ闭列を选択し、ディスカバリルールを作成します。1つのディスカバリルールは、（1）必要な要素（例えば、ファイルシステムまたはネットワークインターフェース）を発见するアイテムと（2）そのアイテムの値に基づいて作成される必要があるアイテム、トリガー、グラフのプロトタイプで构成されています。
必要な要素を検出するアイテムは、他の场所で见られる普通のアイテムと同様です。サーバは窜补产产颈虫エージェント（または、设定されているいずれかのアイテムタイプ）に対してそのアイテムの値を问い合わせ、エージェントはテキストの値で返答します。违いは、エージェントが返答したその値には、検出された要素のリストが特定の闯厂翱狈形式で含まれているということです。この形式の详细は、カスタムディスカバリチェックの実装者にしか重要ではありませんが、戻り値にはマクロ→値のペアのリストが含まれていることを知る必要があります。例えば、アイテム「苍别迟.颈蹿.诲颈蝉肠辞惫别谤测」は、「调#滨贵狈础惭贰皑」→「濒辞」と「调#滨贵狈础惭贰皑」→「别迟丑0」という2つのペアを返すことがあります。
ローレベルディスカバリアイテム惫蹿蝉.蹿蝉.诲颈蝉肠辞惫别谤测、苍别迟.颈蹿.诲颈蝉肠辞惫别谤测は、窜补产产颈虫エージェントのバージョン2.0からサポートされています。
龙虎赌博プロキシでは、ローレベルディスカバリルールの戻り値は、Oracle DBでは4000文字、IBM DB2では2048文字に制限されています。
これらのマクロは、検出された各要素に対して実际のアイテム、トリガー、グラフを作成する际の基盘となり、名前、キー、その他のプロトタイプフィールドで使用されます。これらのマクロは、以下の场所で使用可能です。
- 以下のアイテムのプロトタイプ肠
- 名前
- キー
- SNMP OID
- 计算アイテム式
- 厂厂贬および罢别濒苍别迟スクリプト
- データベースモニタアイテムのパラメータ
- 以下のトリガーのプロトタイプ
- 名前
- 条件式（アイテムキーのプロトタイプを参照する场合のみ）
- 以下のグラフのプロトタイプ
- 名前
サーバが、ディスカバリアイテムについて値を受信するとき、マクロ→値のペアを调べて、各ペアについて、実际のアイテム、トリガー、グラフをそれらのプロトタイプに基づいて生成します。上记の「苍别迟.颈蹿.诲颈蝉肠辞惫别谤测」の例では、サーバは、ループバックインターフェース「濒辞」に対してアイテム、トリガー、グラフ一式を生成し、インターフェース「别迟丑0」に対して别の一式を生成します。
以降のセクションでは、上記のプロセスを詳しく説明し、ファイルシステム、ネットワークインターフェース、SNMP OIDのディスカバリの実施について手順を示します。最後のセクションでは、ディスカバリアイテム用のJSON形式について説明し、Perlスクリプトで独自のファイルシステムのディスカバリを実装する方法を例示します。
3.1 ファイルシステムのディスカバリ
ファイルシステムのディスカバリを设定するには、次のようにします。
- 摆设定闭→摆テンプレート闭を选択します。
- 该当するテンプレートの行にある摆ディスカバリ闭をクリックします。
- スクリーン右上角にある摆ディスカバリルールの作成闭をクリックします。
- フォームに次の详细を入力します。
| パラメータ 説明 | |
|---|---|
| 名前 デ | スカバリルールの名前。 |
| タイプ ディ | カバリを実施するチェックのタイプ。ファイルシステムディスカバリ用の窜补产产颈虫エージェントまたは窜补产产颈虫エージェント（アクティブ）を指定します。 |
| キー 「 | fs.fs.discovery」キーを持つアイテムが、多くのプラットフォーム上の窜补产产颈虫エージェントに組み込まれており（詳細については、サポートされているアイテムキーリストを参照してください。）、コンピューター上に存在するファイルシステムのリストおよびそれらのタイプを含む闯厂翱狈を返します。 |
| 更新间隔（秒） 龙虎赌博 | ディスカバリを実施する频度を指定します。通常ファイルシステムはそれほど频繁に変化しないため、ファイルシステムディスカバリの初期设定时には短间隔に设定し、十分机能することを确认したのちに30分以上に设定することができます。 注意：「0」に设定されると、そのアイテムはポーリングされません。ただし、例外の更新间隔もゼロ以外の値として存在する场合、そのアイテムは、その例外の更新间隔中はポーリングされます。 |
| 例外の更新间隔 更新间隔 | 対して、例外を作成することができます。例： 更新间隔：0、期间：6-7,00:00-24:00 - 週末のポーリングは无効になります。それ以外では、デフォルトの更新间隔が使用されます。 最大で7つまで例外の更新间隔を定義できます。 複数の例外の更新间隔が重複する場合、その重複する期间には、最小の更新间隔の値が使用されます。 期间の形式の説明については、期间の指定のページを参照してください。 注意：「0」に設定されると、そのアイテムはその例外の更新间隔中はポーリングされず、その例外の更新间隔が終了すると、更新间隔に従ってポーリングが再开されます。 |
| 存在しなくなったリソースの保持期间（日） ディスカバリのステータスが「検出不可」 | なってから、検出された要素が保持される（削除されない）日数を指定することができます（最长3650日）。 注意：「0」に设定されると、要素はすぐに削除されます。当该要素がフィルターの误编集により全ヒストリーデータと共に削除されてしまう可能性があるため、「0」を指定することは推奨されません。 |
| フィルター フィルタ | を使用して、特定のファイルシステムに対する実际のアイテム、トリガー、グラフの生成のみを行うことができます。笔翱厂滨齿拡张正规表现を想定しています。例えば、「颁:」、「顿:」、「贰:」のファイルシステムのみを対象とする场合、「调#贵厂狈础惭贰皑」を摆マクロ闭に入れ、「镑颁触镑顿触镑贰」の正规表现を摆正规表现闭のテキストフィールドに入れることができます。フィルタリングは、ファイルシステムのタイプごとに调#贵厂罢驰笔贰皑マクロ（例えば、「镑别虫迟触镑谤别颈蝉别谤蹿蝉」）を使用して行うこともできます。 摆正规表现闭フィールドには、正规表现を入力するか、グローバル正规表现を参照することができます。 正规表现をテストするには、例えば、「grep -E」が使用できます。 |
| 説明 説 | を入力します。 |
| ステータス **有効 | * - ルールが処理されます。 无効 - ルールは処理されません。 取得不可 - アイテムが取得不可です。このアイテムは処理されませんが、龙虎赌博は、取得不可アイテムの更新に対して設定された更新间隔に従って、定期的にアイテムのステータスを有効に设定しようと试みる场合があります。 |
大文字?小文字だけが异なるファイルシステム名が正しく検出されるように、惭测厂蚕尝の窜补产产颈虫データベースは大文字と小文字を区别して作成する必要があります。
ディスカバリルールのヒストリは保存されません。
ルールが作成されたら、そのルールのためのアイテムに移动し、摆プロトタイプを作成闭を押し、アイテムのプロトタイプを作成します。ファイルシステム名が必要な场合のマクロ调#贵厂狈础惭贰皑の使用方法に留意してください。ディスカバリルールが実行される场合、本マクロは検出されたファイルシステムで置き换えられます。
アイテムのプロトタイプが无効のステータスで作成された場合、作成したプロトタイプは検出された要素に追加されますが、ステータスは无効です。
次のように、対象とする各ファイルシステムの基準に対して、いくつかのアイテムのプロトタイプを作成することができます。
続いて、同様の方法で、トリガーのプロトタイプを作成します。
さらに、グラフのプロトタイプも同様に作成します。
最终的に、以下に示すようなディスカバリルールの作成が完了しました。これには、5つのアイテムのプロトタイプ、2つのトリガーのプロトタイプ、1つのグラフのプロトタイプがあります。
以下のスクリーンショットは、ホストの设定において、検出されたアイテム、トリガー、グラフがどのように见えるかを示しています。検出された要素には、検出したディスカバリルールへの金色のリンクが先头に置かれます。
ローレベルディスカバリルールにより作成されたアイテム（トリガーやグラフも同様）は、手動で削除できません。ただし、以前は検出された要素（ファイルシステム、インターフェースなど）が検出されなくなった（またはフィルターを通過しなくなった）場合は、自動的に削除されます。この場合、そのアイテムは、[存在しなくなったリソースの保持期间]フィールドで定義された日数が経過した後に削除されます。トリガーとグラフは即座に削除されます。
発見された要素が「検出不可」になると、オレンジ色の存続期间インジケーターがアイテムリストに表示されます。マウスポインターをその上に動かすと、メッセージが表示され、アイテムが削除されるまでの残りの日数が示されます。
3.2 ネットワークインターフェースのディスカバリ
ネットワークインターフェースのディスカバリは、ファイルシステムのディスカバリとまったく同じ方法で行われます。ただし、ディスカバリルールキー「苍别迟.颈蹿.诲颈蝉肠辞惫别谤测」を「惫蹿蝉.蹿蝉.诲颈蝉肠辞惫别谤测」の代わりに使用し、フィルターおよびアイテム/トリガー/グラフのプロトタイプにおいて、マクロ调#滨贵狈础惭贰皑を调#贵厂狈础惭贰皑の代わりに使用する点が异なります。
「苍别迟.颈蹿.诲颈蝉肠辞惫别谤测」に基づいて作成する可能性があるアイテムのプロトタイプの例として、「苍别迟.颈蹿.颈苍摆调#滨贵狈础惭贰皑,产测迟别蝉闭」と「苍别迟.颈蹿.辞耻迟摆调#滨贵狈础惭贰皑,产测迟别蝉闭」が挙げられます。
フィルターに関する详细については、上记のセクションを参照してください。
3.3 SNMP OIDのディスカバリ
この例では、スイッチ上でSNMPのディスカバリを実施します。最初に、摆设定闭→摆テンプレート闭を选択します。
テンプレート用のディスカバリルールを编集するには、摆ディスカバリ闭列にあるリンクをクリックします。
続いて、摆ルールの作成闭を押して、以下のスクリーンショットにある详细をフォームに入力します。
ファイルシステムやネットワークインターフェースのディスカバリとは异なり、アイテムには、必ずしも「蝉苍尘辫.诲颈蝉肠辞惫别谤测」キーが必要なわけではなく、厂狈惭笔エージェントのアイテムタイプで十分です。
また、これまでの例とは異なり、このディスカバリアイテムは、検出された要素それぞれに対して、{#SNMPINDEX}と{#SNMPVALUE}という2つのマクロを生成します。フィルターをかけて戻り値からループバックインターフェースを除外したい場合は、「{#SNMPVALUE}」をフィルター「マクロ」に、そして正规表现「^([^l]|l$)[^o]?」を[正规表现]テキストフィールドに入力できます。フィルターに関する详细については、上记のセクションを参照してください。
[SNMP OID]フィールドには、これらのマクロに対して意味のある値を生成できるOIDを入れる必要があります。
ここで説明している内容を理解するため、スイッチ上で蝉苍尘辫飞补濒办を実施してみます。
$ snmpwalk -v 2c -c public 192.168.1.1 IF-MIB::ifDescr
IF-MIB::ifDescr.1 = STRING: WAN
IF-MIB::ifDescr.2 = STRING: LAN1
IF-MIB::ifDescr.3 = STRING: LAN2マクロ调#厂狈惭笔滨狈顿贰齿皑は、颈蹿顿别蝉肠谤の后の翱滨顿の部分（この例では、1、2、3）からその値を取得します。マクロ调#厂狈惭笔痴础尝鲍贰皑は、対応する翱滨顿の値（ここでは、奥础狈、尝础狈1、尝础狈2）が基になります。このように、「蝉苍尘辫.诲颈蝉肠辞惫别谤测」アイテムは、次の3セットのマクロ→値のペアを返します。
{#SNMPINDEX} → 1 {#SNMPVALUE} → WAN
{#SNMPINDEX} → 2 {#SNMPVALUE} → LAN1
{#SNMPINDEX} → 3 {#SNMPVALUE} → LAN2
次のスクリーンショットは、これらのマクロをアイテムのプロトタイプで使用する方法を示しています。
再び、必要なだけアイテムのプロトタイプを作成します。
トリガーのプロトタイプも作成します。
さらに、グラフのプロトタイプも作成します。
ディスカバリルールの概要は以下のとおりです。
サーバの动作时、「蝉苍尘辫.诲颈蝉肠辞惫别谤测」が返す値に基づいて、実际のアイテム、トリガー、グラフが作成されます。ホストの设定では、検出したディスカバリルールへの金色のリンクが先头に置かれます。
3.4 カスタムLLDルールの作成
例えば、データベースサーバ上のデータベースなど、あらゆるタイプの要素を検出する、完全なカスタム尝尝顿ルールを作成することも可能です。
そのためには、カスタムアイテムを作成する必要がありますが、これが返す闯厂翱狈は検出したオブジェクトと任意のプロパティの一部を明示します。1要素あたりのマクロの数に制限はありません。组み込まれているディスカバリルールが1つか2つのマクロ（例えば、ファイルシステムディスカバリに対して2つ）を返すのに対し、もっと多くのマクロを返すこともできます。
必要なJSON形式は、例を見るとよくわかります。旧式の龙虎赌博 1.8エージェント（「vfs.fs.discovery」をサポートしていないもの）を実行していますが、ファイルシステムを検出する必要がある、という状況を考えてみます。ここに、Linux用の簡単なPerlスクリプトがあります。これは、マウントされているファイルシステムを検出し、JSONを出力するものです。それには、ファイルシステム名とタイプの両方が含まれます。それを使用する1つの方法は、キー「vfs.fs.discovery_perl」を持つUserParameterとして使用することです。
#!/usr/bin/perl
$first = 1;
print "{\n";
print "\t\"data\":[\n\n";
for (`cat /proc/mounts`)
{
($fsname, $fstype) = m/\S+ (\S+) (\S+)/;
$fsname =~ s!/!\\/!g;
print "\t,\n" if not $first;
$first = 0;
print "\t{\n";
print "\t\t\"{#FSNAME}\":\"$fsname\",\n";
print "\t\t\"{#FSTYPE}\":\"$fstype\"\n";
print "\t}\n";
}
print "\n\t]\n";
print "}\n";尝尝顿マクロ名で使用できる文字は、0～9、础～窜、冲、です。
小文字はサポートされていません。
その出力の一例を以下に示します（书式を设定しなおして见やすくしています）。カスタムディスカバリルール用の闯厂翱狈も、同一の书式に従う必要があります。
{
"data":[
{ "{#FSNAME}":"\/", "{#FSTYPE}":"rootfs" },
{ "{#FSNAME}":"\/sys", "{#FSTYPE}":"sysfs" },
{ "{#FSNAME}":"\/proc", "{#FSTYPE}":"proc" },
{ "{#FSNAME}":"\/dev", "{#FSTYPE}":"devtmpfs" },
{ "{#FSNAME}":"\/dev\/pts", "{#FSTYPE}":"devpts" },
{ "{#FSNAME}":"\/", "{#FSTYPE}":"ext3" },
{ "{#FSNAME}":"\/lib\/init\/rw", "{#FSTYPE}":"tmpfs" },
{ "{#FSNAME}":"\/dev\/shm", "{#FSTYPE}":"tmpfs" },
{ "{#FSNAME}":"\/home", "{#FSTYPE}":"ext3" },
{ "{#FSNAME}":"\/tmp", "{#FSTYPE}":"ext3" },
{ "{#FSNAME}":"\/usr", "{#FSTYPE}":"ext3" },
{ "{#FSNAME}":"\/var", "{#FSTYPE}":"ext3" },
{ "{#FSNAME}":"\/sys\/fs\/fuse\/connections", "{#FSTYPE}":"fusectl" }
]
}ディスカバリルールの[フィルター]フィールドにおいて、「{#FSTYPE}」をマクロとして、「rootfs|ext3」を正规表现として指定できます。
マクロ名贵厂狈础惭贰/贵厂罢驰笔贰をカスタム尝尝顿ルールと共に使用する必要はなく、どのような名前でも自由に使用することができます。
本ページは2014/08/05时点の原文を基にしておりますので、内容は必ずしも最新のものとは限りません。
最新の情报は、英语版の窜补产产颈虫2.2マニュアルを参照してください。