テンプレートとコンポーネント

Pandora FMS ドキュメント一覧に戻る

Pandora FMS は全てのチェックをモジュールを通して行います。これらは、Pandora FMS が処理できる異なるデータタイプごとに異なります。Pandora FMS のデフォルトのモジュールリストは、管理(Management) → リソース(Resources) → モジュールタイプ(Module Types) から参照できます。

Pandora FMS には、異なるモジュールのタイプとグループがあります。

• async: 非同期データ
• generic: 一般的なデータ
• keep_alive: エージェントへの最終接続状態を制御するのに便利な特別な keepalive モジュール
• icmp: ICMP チェック (ping)
• snmp: SNMP チェック
• tcp: TCP チェック
• web: ウェブチェック

これらのほとんどには、いくつかのチェックタイプがあります。

• data: 数値データ
• proc: ブーリアン値。1 か 0 を返します。
• string: テキスト文字列
• inc: インクリメンタルデータ (例えば、ネットワークインタフェースから送信されたパケットの総量などの増加するデータ)
• inc_abs: 絶対インクリメンタルデータ。前回からの増分の値を示します。

コンポーネントは、モジュールの「マスターコピー」であるかのようにエージェントに繰り返し適用できる 汎用モジュール であり、エージェントに関連付けられたモジュールを生成します。このツールを使用すると、最もよく使用されるコンポーネントのリストを作成して管理し、新しいエージェントに適用できます。

• ネットワークコンポーネント(Network components): すべてのリモートモジュール (WMI、TCP、SNMP、ICMP、プラグインなど) のグループです。
• ローカルコンポーネント(Local components): リモート設定が有効になっているエージェントの設定ファイルに組み込まれるテキストの「チャンク」として、エンドポイントモジュールの定義を含めます。

ネットワークコンポーネントは テンプレート にグループ化できるため、複数のネットワークコンポーネントをエージェントに直接適用できます。これにより、テンプレートに関連付けられたネットワークコンポーネントを通じて複数のモジュールを同時に作成できます。

自動検出サーバ は、検出されたホストにテンプレートに関連付けられたネットワークコンポーネントを適用し、指定されたモジュールを自動的に追加して、監視の自動展開を可能にします。

この一覧では、既存のコンポーネントを検索 (グループまたはフリー検索テキストでフィルタリング) したり、その設定の詳細を表示したり、新しいコンポーネントを変更または作成したりできます。モジュールのプロパティを編集するには、その名前をクリックします。

ネットワークコンポーネントを作成するには、メニュー 管理(Management) → 設定(Configuration) → テンプレート(Templates) → リモートコンポーネント(Remote components) を使用し、ページの下部にあるドロップダウン メニューでネットワークコンポーネントを選択して、作成(Create) ボタンをクリックします。

ネットワークコンポーネントは共通フィールドのグループを共有します。そのうちのいくつかは重要です。

• 情報(Information): ステータス（警告、重大、不明）に応じた説明と指示。
• しきい値(Thresholds): しきい値とそのすべての可能な組み合わせ。
• データ(Data): 再試行回数、タイムアウト、予想される最大値と最小値、履歴値の保存（デフォルトでは無効）、いくつかの測定単位。
• 分類(Categorization): 将来のモジュールが属する モジュールグループ を選択したり、カスタムカテゴリ (管理(Management) → リソース(Resources) → モジュールカテゴリ(Module categories)) を選択したり、モジュールタグ を割り当てたりすることができます。
• マクロ(Macros): 必要な数だけ、名前と値を 1 つずつ指定します。

ドロップダウンフィールド モジュールタイプ(Module type) で、リモート監視 の 2 つの基本的なチェックが可能になります。

• Remote ICMP network agent, boolean data: デバイスがオンラインかどうかを yes または no (true または false) でチェックします。
• Remote ICMP network agent (latency): 前回のクエリを実行するために使用された時間。

リモート監視 の次のステップは、基本的に TCP を使用して、一連の命令 (フィールド TCP 送信(TCP send)、モジュールタイプ Remote TCP network agent) を、それぞれのエージェントで設定されている IP アドレスまたは URL を使用して特定のポート番号に送信することです。

予想される応答は次のようになります。

• true または false の値。モジュールタイプ(Module type) では boolean data を使用します。
• 任意の数値（ numeric data を使用）、または最後から 2 番目の応答を基準に増加する数値（ incremental data を使用）。
• 文字列値、数字、文字（alphanumeric data を使用）。TCP 受信(TCP receive) フィールドに設定されている値と比較することで、ステータス（正常、警告、障害）を判定します。

SNMPモニタリングでは、OID（オブジェクトID）またはオブジェクト識別子（Object Identifiers）を把握することが非常に重要です。そのためには、SNMPブラウザ（SNMP Walkボタン）があり、認証情報（SNMPバージョン3）、IPアドレス、ポート番号を入力することで、監視対象デバイスのSNMPコミュニティに応じて利用可能なOIDを取得できます。

SNMP OID が設定されたら、応答 (数値、増分数値、真/偽、または英数字) に基づいてモジュールタイプを選択し、ステータス (正常、警告、障害) を決定するためのしきい値を設定する必要があります。

Pandora FMS には、WMI クエリ という定義済みの WMI クエリが 使用するネットワークコンポーネント(Using network component) リストに分類されています。必要なオプションを選択すると、利用可能なオプションを含む 2 番目のリストが表示されます。その中から 1 つを選択すると、将来のモジュールの名前が付けられ、WMI クエリ が割り当てられます。モジュールタイプもそれに応じて変更されます。

このタイプのリモートコンポーネントを手動で作成する場合、または前述のアシスタントを使用する場合は、基本(Basic) → グループ(Group) タブで、コンポーネントの性質に応じてグループまたはサブグループを選択することをお勧めします。これにより、後でリモートコンポーネントを検索できるようになります。

入力したコマンドと実行時の応答に基づいて、適切なモジュールタイプ (数値、ブール値、英数字、増分データ) を選択する必要があります。

登録済みプラグイン に従って、基本(Basic) → プラグイン(Plugin) タブで、それぞれのケースのカスタム手順に従って、いずれかのプラグインを選択し、入力する必要があります。

モジュールプロトコルに応じて、SNMP と WMI の 2 つのタイプが許可されます。

SNMP:

まず、製造元を登録 (製造元 ID(Manufacturer ID)) し、実行タイプ(Execution type) → ネットワーク(Network) を選択して、値OID を追加する必要があります。これらは最も重要なフィールドですが、他にも入力すべきフィールドがあります（モジュールタイプ、使用単位、しきい値など）。

メニュー 管理(Management) → 設定(Configuration) → テンプレート(Templates) → ローカルコンポーネント(Local components)。

ローカル コンポーネントとは、エンドポイントに適用できるコンポーネントを指します。これらのコンポーネントは、ポリシーを通じてすべてのエージェントに自動的に適用することも、エージェントのリモート設定エディタで手動で (1 つずつ) 適用することもできます。Pandora FMS には、ポリシーとエージェントに自動的に適用する多数のローカルモジュールがあり、カテゴリ別に分類されています。

既存のローカルモジュールの一覧は、さまざまなパラメーター (グループ、オペレーティングシステム、フリーテキスト検索) でフィルター処理できます。また、新しいコンポーネントを表示、変更、作成することもできます。モジュールを編集するには、その名前をクリックします。

新たなローカルコンポーネントを作成するには、管理(Management) → 設定(Configuration) → テンプレート(Templates) → ローカルコンポーネント(Local components) をクリックし、ページの右下にある 作成(Create) をクリックします。

新しいローカルコンポーネント作成フォームのページが表示されます。フォームに上記の情報を入力し、もう一度 作成(Create) をクリックして保存します。

ローカルコンポーネントでマクロを定義することができます。これらのマクロは、パラメータ module_exec で使用され、_field1_、_field2_ … _fieldN_ という構造です。

マクロは、ユーザにとって透過的な通常のフィールドとしてモジュール編集フォームに表示されます。

モジュールコンポーネントにマクロがある場合、表示を簡素化するために設定データはデフォルトで非表示になりますが、表示および変更することは可能です。ヘルプ(Help) フィールドに文字列が定義されている場合、この文字列を含むフィールドの横にヒントが表示されます。

モジュールテンプレートは、ネットワークチェックモジュールを含むテンプレートです。これらのテンプレートを作成すると、一つ一つモジュールを追加することなく直接エージェントに適用することができます。また、ネットワーク検出タスク にて適用できます。

メニュー 管理(Management) → 設定(Configuration) → テンプレート(Templates) → モジュールテンプレート(Module templates)。

表示された一覧から、いずれかのテンプレートの名前をクリックするとテンプレートを編集でき、右側の列にあるゴミ箱アイコンをクリックするとテンプレートを削除できます。

作成(Create) ボタンは、新しいテンプレートを追加する際に使用します。名前(Name) および PEN フィールドを入力し、作成(Create) を再度クリックすると保存されます。コンポーネントの追加(Add components) ボタンが表示され、グループでフィルタリングし、必要なコンポーネントを選択して、OK をクリックできます。作成プロセスを終了するには、更新(Update) をクリックします。

すべての SNMP デバイスには識別文字列 (OID) があり、これはデバイスのメーカーとモデルごとに一意です。これらの文字列の 7 番目の位置には、デバイスがどのメーカーに属しているかを示す数字があります。

この番号は製造元の プライベートエンタープライズ番号 (PEN) であり、IANA に登録されています。Pandora FMS でこれらの PEN を設定し、モジュールテンプレートと一緒に使用して動的に監視を追加することができます。

管理(Management) → 設定(Configuration) → テンプレート(Template) → プライベートエンタープライズ番号(Private Enterprise Numbers) メニューでは、登録済みの PEN のリストにアクセスできます。オプション(Options) 列の対応するアイコンをクリックすると、登録済みの各 PEN を編集や削除できます。

新しいメーカーを登録するには、メーカーの登録(Register manufacturer) をクリックします。メーカーの対応する PEN を入力し、メーカー名と説明を入力するだけです。これで、既存のリストに追加されます。

モジュールテンプレートでは、1 つまたは複数の PEN が指定されるため、自動検出タスクの実行時に、Pandora FMS はデバイスの製造元を取得し、適切な監視を追加できます。

SNMP および WMI ウィザードの機能には、ウィザードコンポーネント(Wizard components)と呼ばれる種類のリモートコンポーネントがあります。

これらのコンポーネントを使用すると、任意のウィザード(SNMP または WMI)の実行時にエージェントで生成されるモジュールの基本設定を行えます。さらに、1つのコンポーネントのみで複数のモジュールを動的に生成することができます。たとえば、実行中のストレージデバイスのユニットや、プロセスをスキャンするコンポーネントです。

これらのコンポーネントは、管理(Management) → 設定(Configuration) → テンプレート(Templates) → リモートコンポーネント(Remote components)メニューから作成できます。

コンポーネントを並べ替えて分類するために、コンポーネントグループがあります。コンポーネントは、作成時のグループに属します。

既存のコンポーネントグループを表示するには、メニュー 管理(Management) → リソース(Resources) → コンポーネントグループ(Component group) を使用します。既存のグループとその説明が画面に表示されます。グループの詳細を表示するには、グループの名前をクリックします。グループを削除するには、右側の アクション(Action) 列にあるゴミ箱アイコンをクリックします。新しいグループを作成するには、下部の 作成(Create) ボタンをクリックします。対応するチェックボックスを使用して複数のグループを選択し、削除(Delete) ボタンを使用して一括で削除することもできます。

作成(Create) ボタンを使用すると、新しいコンポーネントグループを作成できます。フォームのフィールドに入力し、グループの名前を指定して、既存のグループ内に 親 があるかどうかを選択します。次に、もう一度 作成(Create) をクリックします。これで、新しく作成されたコンポーネントグループに新しいコンポーネントを追加できます。

Pandora FMS ドキュメント一覧に戻る