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

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

Pandora FMS performs all the checks through Modules, allowing to process different types of data depending on the element to monitor. The complete list of default Modules contained in Pandora FMS can be checked in the following section Management → Resources → Module types.

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

There are different module types in Pandora FMS:

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

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

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

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

A component is a Generic Module that can be applied repeatedly on an Agent, as if it were a “master copy” of a Module, generating a Module associated to an Agent. With this tool you may create and maintain a list of the most used components to apply them to new agents.

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

• Network components: Group all remote modules (WMI, TCP, SNMP, ICMP, plugin, etc).
• Local components: Include the definition of the Software Agent modules, as “chunks” of text to be incorporated into the configuration file of the Agent that has the remote configuration enabled.

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

Network components can be grouped in templates, so that multiple network components can be applied directly on an Agent. Several modules can thus be created simultaneously through the network components associated with a template.

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

The Recon server applies the network components associated with a template on the detected hosts, adding the specified modules automatically and thus enabling automatic monitoring deployment.

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

Menu Management → Configuration → Templates → Remote components.

メニュー 管理(Management) → 設定(Configuration) → テンプレート(Templates) → リモートコンポーネント(Remote components)。

In this list you may search for existing components (filtering by groups or by free search text), view their configuration in details, modify or create new components. To edit the properties of any module, click on its name.

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

To create a network component use the Configuration → Templates → Remote components menu, and at the bottom of the page, from the drop-down menu, select a network component from the four possible ones (Network, Plugin, Wizard, WMI) and then click Create.

ネットワーク コンポーネントを作成するには、設定(Configuration) → テンプレート(Templates) → リモートコンポーネント(Remote componetnts) メニューを使用し、ページの下部にあるドロップダウンメニューから、4 つの選択可能なネットワークコンポーネント (ネットワーク(Network)、プラグイン(Plugin)、ウィザード(Wizard)、WMI) からネットワークコンポーネントを選択して、作成(Create) をクリックします。

Because it is a generic component, some parameters such as snmp community, user, password can be different according to the agents to which the Module will be applied later, in those cases they can be left blank. If a common user policy is available for the systems, the modules can be left fully configured by entering user names, passwords and other data that are common to all agents.

これは汎用コンポーネントであるため、 snmp community、user、password などの一部のパラメータは、後でモジュールが適用されるエージェントに応じて変更する必要がある場合があります。その場合は、空白のままにすることができます。システムに共通のユーザポリシーが使用可能な場合は、ユーザ名、パスワード、およびすべてのエージェントに共通するその他のデータを入力して、モジュールを完全に設定した状態にすることができます。

The same process is performed for plugin components, by selecting Plugin in the list, in the interface the fields defined in the macros of the selected plugin will appear.

プラグインコンポーネントに対しても同じ処理が実行され、リストで プラグイン(Plugin) を選択すると、選択したプラグインのマクロで定義されたフィールドがインターフェイスに表示されます。

Menu Management → Configuration → Templates → Local components.

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

The local components refer to the components that can be applied to Software Agents. These components can be applied automatically to all the agents through policies or manually (one by one) in the remote configuration editor of the Agent. Pandora FMS has dozens of local modules to apply to policies and agents automatically, sorted by categories.

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

The list of existing local modules can be filtered by different parameters (group, operating system, free text query) and you may also view, modify and create new components. To edit any module, click on its name.

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

To create a new local component, go to the main local component management page, menu Management → Configuration → Templates → Local components and click Create at the bottom right of the page.

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

The page with the new local component creation form will appear. The form is filled in with the above information and click Create again to save.

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

From Pandora FMS versions 5 onwards, it is possible to define macros within local components. These macros are used in the module_exec parameter. They follow the structure of _field1_ , _field2_ … _fieldN_.

Pandora FMS バージョン 5.0 以降では、ローカルコンポーネントにマクロを定義することができます。マクロは、 module_exec パラメータに設定し、_field1_ , _field2_ … _fieldN_ という構造です。

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

Each macro has three fields: Description, Default value and Help.

それぞれのマクロには、説明(Description)、デフォルト値(Default value)、ヘルプ(Help) の 3つのフィールドがあります。

• 説明(Description): モジュールフォームのフィールドに近いラベル。
• デフォルト値(Default value): モジュールフォームでデフォルトで設定される値。
• ヘルプ(help): フィールドの追加情報に追加される文字列。設定すると、その文字列がフィールドの近くに表示されます。

モジュールコンポーネントにマクロが含まれている場合、デフォルトで表示を簡素化するために、構成データは非表示のままになります。

ただし、表示および編集することもできます。

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

Click on Configuration → Templates → Module templates to manage the module templates.

モジュールテンプレートを管理するには、設定(Configuration) → テンプレート(Templates) → モジュールテンプレート(Module templates) をクリックします。

テンプレート管理画面が表示されます。デフォルトの設定がされています。

詳細を見るには、テンプレートをクリックします。右のごみ箱アイコンをクリックすると削除できます。新しいテンプレートを作成する場合は、作成(Create)ボタンをクリックします。

By clicking on the name of a template you will see its details, for example, the screenshot below shows the details for the basic monitoring module template.

テンプレートの名前をクリックすると、その詳細が表示されます。たとえば、以下のスクリーンショットでは、Basic Monitoring のモジュールテンプレート詳細が表示されています。

Below is the list of modules included in this template. In order to delete a module from that template, in the right column, click Delete and the corresponding trash icon.

以下は、このテンプレートに含まれるモジュールの一覧です。テンプレートからモジュールを削除するには、右側の 削除(Delete) 列のごみ箱アイコンをクリックします。

Finally, there is the form for adding modules when clicking on Add components. You may filter by module group, and then select the module and add it.

最後に、コンポーネントの追加(Add components) をクリックすると、モジュール追加のためのフォームが表示されます。モジュールグループによってフィルタリングし、モジュールを選択して追加できます。

In order to create a new module template, go to the main management page, Configuration → Templates → Module templates and click on Create at the bottom-right side of the page.

新たなモジュールテンプレートを作成するには、システム管理メニューから、設定(Configuration) → テンプレート(Templates) → モジュールテンプレート(Module templates) へ行きます。そして、ページ右下の 作成(Create) ボタンをクリックします。

新たなコンポーネントの作成フォームが表示されます。

新たなテンプレートの名前と説明を入力し、 作成(Create) ボタンをクリックします。

Then you may add modules to the template by clicking on Add components.

次に、コンポーネントの追加(Add components) をクリックすることにより、テンプレートにモジュールを追加できます。

Select the modules at the bottom, filtering them by group if necessary and click on OK.

下の方でモジュールを選択し (必要であればグループでフィルタリングして) OK をクリックします。

Keep in mind that you may delete the unwanted modules by selecting them and clicking Delete.

不要なモジュールは、選択して 削除(Delete) ボタンを押すことによって削除できます。

To finish off, remember to save the added modules by clicking on Update.

最後に、 更新(Update) をクリックして、追加したモジュールを保存することを忘れないでください。

In order to apply one of the existing monitoring module templates or a recently created one, go to agent configuration through the menu Resources → Manage agents.

既存のモニタリングモジュールテンプレートや新たに作成したテンプレートをエージェントに適用するには、リソース(Resources) → エージェント管理(Manage agents) へ行きます。

From the agent list, select one through the corresponding Modules link (see previous picture).

エージェント一覧から、対応する モジュール リンクの 1つを選択します。(上記画像を参照)

Once you see this window, click on Module templates at the top of the page.

以下のような画面が表示されるので、ページの上の モジュールテンプレート(Module templates) をクリックします。

On the following picture, modules that already contain an agent and existing module templates are displayed.

次の画面には、エージェントと既存のモジュールテンプレートがすでに含まれているモジュールが表示されています。

Select a template and click Assign. The modules contained in this template will be added automatically. Once the template is applied, delete some of the modules by clicking on the trash can icon, or you may edit them clicking on the tool icon.

テンプレートを選択し、 割当(Assign) ボタンをクリックします。選択したテンプレートに含まれるモジュールが自動的に追加されます。テンプレートが適用されたら、ごみ箱アイコンをクリックしてモジュールの一部を削除したり、ツールアイコンをクリックしてモジュールを編集できます。

Added modules will have an automatic description based on the template's name:

追加されたモジュールには、テンプレート名にもとづいた自動的な説明がつきます。

すべての SNMP デバイスには独自の OID があります。これは、各デバイスのブランドとモデルに限定されたものです。どの製造元からのものかを示す文字列に対応する 7番目を占める数値があります。

This is the manufacturer's Private Enterprise Number (PEN ) and it is registered on IANA. These PEN can be configured in Pandora FMS to use them together with module templates and therefore add dynamic monitoring.

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

Go to Configuration → Templates → Private Enterprise Numbers to have acces to the list of registered PENs.

登録済の PEN 一覧へアクセスするには、設定(Configuration) → テンプレート(Templates) → プライベート Enterprise 番号(Private Enterprise Numbers) へ行きます。

You may edit and/or delete each of the registered PENs by clicking on the corresponding icons from the Options column.

オプション(Option) 列から対応するアイコンをクリックすると、登録されている各 PEN を編集または削除できます。

To register a new manufacturer, click on Register manufacturer. Just insert the manufacturer's corresponding PEN, indicate its name and a description. That way it will be added to the existing list.

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

In module templates, one or several PENs will be indicated so when there is a discovery task, Pandora FMS is able to retrieve the information about the device's manufacturer and add the appropriate monitoring information.

モジュールテンプレートでは、1つまたは複数の PEN が示されるため、検出タスクがある場合、Pandora FMS はデバイスの製造元に関する情報を取得し、適切な監視情報を追加できます。

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

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

These components can be created from the menu Configuration → Templates → Remote components,

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

Select the option Create a new wizard component and click Create.

新規ウィザードコンポーネント作成(Create a new wizard component) オプションを選択し、作成(Create) をクリックします。

In the creation box, there is a key option: the protocol of the Module to be used. There are two protocols available, SNMP (by default) and WMI, and although both of them share common fields, they also have different fields.

作成ボックスには、使用するモジュールのプロトコルという重要なオプションがあります。 SNMP(デフォルト) と WMI の2つのプロトコルを使用できます。どちらも共通フィールドは同じですが、個別のフィールドもあります。

共通フィールドは次の通りです:

• 有効化(Enabled): このトークンを有効化すると、ウィザードの起動時にコンポーネントがスキャンを試みます。
• デフォルトで追加(Add by default): コンポーネントによって生成されたモジュールが、ウィザードの起動時にデフォルトで追加されるようにするかどうかを選択できます。つまり、トークンが有効化されると、コンポーネントによって生成されたモジュールは、デフォルトでは後で確認できるビューでチェックされ、エージェントに追加されます。このアクションは変更することができ、このビューでは、変更を加えたり、必要に応じてチェックを外したり確認したり、しきい値や説明などを変更したりできます。
• モジュール名(Module name): コンポーネントが持つ名前と、コンポーネントによって生成されるモジュールのデフォルトの名前です。一部のマクロが使用できます(後ほど示します)。
• モジュールプロトコル(Module protocol): コンポーネントを構成するウィザード(SNMP または WMI)を示します。選択したプロトコルに応じて、フォームには各ウィザードの特定のフィールドが表示されます。これについては後で説明します。
• コンポーネントグループ(Component group): コンポーネントが属するグループです。これにより、モジュールの表示方法を整理できます。
• モジュールタイプ(Module type): このドロップダウンリストでは、コンポーネントによって生成されるモジュールが取得するデータのタイプを選択できます。
• モジュール単位(Module unit): コンポーネントによって生成されたモジュールによって取得されたデータの単位。これは完全に編集可能なフィールドなので、必要なものを追加できます。
• 警告状態(Warning status): このセクションでは、ウィザードで生成されたモジュールの警告状態のデフォルトしきい値を設定できます。ここでは範囲が示されていますが、見つかったすべてのモジュールを収集する最終画面で、モジュールごとにそれをカスタマイズすることができます。
• 障害状態(Critical status): このセクションでは、ウィザードで生成されたモジュールの障害状態のデフォルトしきい値を設定できます。ここでは範囲が示されていますが、見つかったすべてのモジュールを収集する最終画面で、モジュールごとにそれをカスタマイズすることができます。
• 説明(Description): これは、コンポーネントとそれが生成したモジュールの説明です。いくつかのマクロを使用できます。(後ほど示します)。
• スキャンタイプ(Scan type): このコンポーネントを使用して、ウィザードで実行できる 2つのスキャンモードを選択できます。このフィールドは、コンポーネントが 1つまたは複数のモジュールを生成するかどうかを決定します。選択した値は、各ウィザードの他の特定のフィールドへの入力に影響します。
  • 固定(Fixed): コンポーネントは 1つのモジュールのみを生成します。たとえば、SNMP によってデバイスの稼働時間を取得します。
  • 動的(Dynamic): コンポーネントは 1つ以上のモジュールを生成します。 たとえば、WMI によるディスク装置の使用率を取得する場合など。
• 実行タイプ(Execution type): このフィールドは、コンポーネント生成モジュールの実行タイプを示します。ウィザードの起動元に応じて、作成時にモジュールが属する Pandora FMS サーバを決定すると便利です。
  • ネットワーク(Network): コンポーネントによって生成されたモジュールは、SNMP および WMI モジュール用の Pandora FMS 独自のシステムでデータを取得します。これらは、ネットワーク、WMI、およびサテライトサーバです。
  • プラグイン(Plugin): コンポーネントによって生成されたモジュールは、コマンド、プラグイン、またはカスタマイズされたスクリプトの実行からデータを取得します。したがって、それらは exec モジュールを介してプラグインまたはサテライトサーバによって実行されます。

SNMP ウィザードコンポーネント特有のフィールドは次の通りです:

• Name OID
• Manufacturer ID
• When Execution type is set in Network:
  • Value OID
• When Execution type is set in Plugin:
  • OID Macros
  • Value operation
  • Satellite execution
  • Server plugin

• 名前 OID(Name OID)
• 製造元 ID(Manufacturer ID)
• 実行タイプ(Execution type) が Network の場合:
  • Value OID
• 実行タイプ(Execution type) が Plugin の場合:
  • OID Macros
  • Value operation
  • Satellite execution
  • Server plugin

名前 OID(Name OID)

マクロを介してモジュール名に追加できる値を取得する OID を設定することができます。 これは、動的コンポーネントによって生成された複数のモジュールを取得するときに特に役立ちます。 これにより、デフォルトで異なる名前が付けられます。ただし、固定スキャンコンポーネントにも使用できるため、動的コンポーネントに限定されません。

この OID の値は、マクロ _nameOID_ に格納され、モジュール名(Module name) フィールドで使用できます。

動的コンポーネントで使用する場合、このフィールドに示される OID は、最終的な OID ではなく、SNMP のブランチのものである必要があります。例えば、OID .1.3.6.1.4.1.2021.10.1.2 が示されている場合、各モジュールでマクロが持つ値は、OID .1.3.6.1.4.1.2021.10.1.2. x から取得されます。 ここで x はブランチが持つ最後を表します。

固定コンポーネントで使用する場合、このフィールドに示される OID は最終的な OID でなければなりません。 例えば、OID .1.3.6.1.2.1.5.0 が示されている場合、マクロがモジュールに持つ値は、その OID から直接取得されます。

製造元 ID(Manufacturer ID)

SNMP ウィザードコンポーネントが有効になる特定の製造元の ID を指定することができます。 このようにして、ウィザードが起動され、コンポーネントに割り当てられた製造元 ID の Pandora FMS にプライベートエンタープライズ番号(PEN)が登録されているすべてのデバイスに対して、生成されたモジュールの取得が試行されます。 たとえば、general_snmp に割り当てられたコンポーネントは、PEN 2021 および 8072 のすべてのデバイスに対してスキャンされます。

製造元として すべて(All) を指定すると、Pandora に登録されている任意の PEN に対してコンポーネントのスキャンが行われます。

実行タイプが ネットワーク(Netrowrk) の場合は次の通りです:

値 OID(Value OID)

これにより、コンポーネントが生成したモジュールデータを取得する OID を設定できます。 動的コンポーネントで使用する場合、このフィールドに示される OID は、最終的な OID ではなく、SNMP のブランチのものである必要があります。例えば、OID .1.3.6.1.4.1.2021.10.1.3 が示されている場合、各モジュールでマクロが持つ値は、OID .1.3.6.1.4.1.2021.10.1.3.x から取得されます。 また、各 OID の X ノードは、名前 OID フィールドの X ノードにと同じ値を使用する必要があります。

固定コンポーネントで使用する場合、このフィールドに示される OID は最終的な OID でなければなりません。 例えば、OID .1.3.6.1.4.1.2021.11.9.0 が示されている場合、マクロがモジュールに持つ値は、その OID から直接取得されます。

実行タイプが プラグイン(Plugin) の場合は次の通りです:

OID マクロ(OID Macros) → _oid_N_

プラグインタイプのコンポーネントを使用する主な目的は、使用済みメモリ量と使用可能な合計メモリ量から使用済メモリの割合を取得するなど、同じデバイスで 1つ以上の OID の値を使用して操作を実行できるようにすることです。

そのため、これらのコンポーネントでは、他のフィールドで使用するために必要な数の OID を指定できます。

さらに、これらの OID またはその値は、_oid_N_ マクロから使用できます。マクロが使用される次のフィールドに応じて、OIDの値または OID 自体が使用されます。

動的コンポーネントで使用する場合、このフィールドに示される OID は、最終的な OID ではなく、SNMP のブランチのものである必要があります。例えば、OID .1.3.6.1.4.1.2021.10.1.3 が示されている場合、各モジュールでマクロが持つ値は、OID .1.3.6.1.4.1.2021.10.1.3.x から取得されます。 また、各 OID の X ノードは、名前 OID フィールドの X ノードにと同じ値を使用する必要があります。

固定コンポーネントで使用する場合、このフィールドに示される OID は最終的な OID でなければなりません。 例えば、OID .1.3.6.1.4.1.2021.4.6.0 が示されている場合、マクロがモジュールに持つ値は、その OID から直接取得されます。

値の計算(Value operation)

ここでは、ウィザードモジュールのプレビューにおいてコンポーネントで生成された各モジュールの現在の値に対する算術計算を設定できます。生成されたモジュールの最終的な実行には影響しません。

“+ - * / ( ) .” を利用できます。数値および _oid_N_ マクロの値が計算に利用されます。例:

(_oid_1_ * 100) / _oid_2_

サテライト実行(Satellite execution)

ここでは、exec server を使用してサテライトサーバからウィザードが起動されたときに、サテライトサーバが生成されたモジュールに対して実行する内容を指定できます。これは、サテライトサーバの module_exec で利用するコマンド、プラグイン、またはスクリプトです。

各モジュールで使用される OID を取得するために、SNMP ウィザードのマクロ(後で詳しく説明します)および _oid_N_ マクロを利用できます。

サテライトサーバは、これらのコンポーネントに推奨される一連のプラグインを配布します。

       	- /etc/pandora/satellite_plugins/wizard_snmp_module
      	- /etc/pandora/satellite_plugins/wizard_snmp_process

サーバプラグイン(Server plugin)

このドロップダウンから、以前に Pandora FMS コンソールに登録されたプラグインを指定することができます。これは、コンポーネントによって生成された各モジュールでプラグインサーバによって使用されます。プラグインを選択すると、フォームで特定のフィールドが同時に表示されます。

独自のプラグインフィールドでは、SNMP ウィザードのマクロと、各モジュールで使用される OID を取得するための _oid_N_ マクロを利用できます。

Pandora FMS コンソールには、これらのコンポーネントに必要な一連の登録済みプラグインがあります。

      	- Wizard SNMP module.
      	- Wizard SNMP process.

プラグインタイプの実行フィールドで利用可能な SNMP ウィザードコンポーネント特有のマクロは次の通りです。

• _address_: SNMP ウィザードで使われる IP アドレス。このマクロは、ウィザードがポリシー内で実行された場合は置き換えできません。
• _port_: SNMP ウィザードで使われるポート番号。
• _version_: SNMP ウィザードで使われる SNMP バージョン。1, 2c または 3 の値を利用できます。
• _community_: SNMP ウィザードで使われる SNMP コミュニティ。
• _sec_level_: SNMP ウィザードで使われる SNMPv3 セキュリティレベル。noAuthNoPriv, authNoPriv または authPriv のいずれかです。
• _auth_user_: SNMP ウィザードで使われる SNMPv3 ユーザ。
• _auth_method_: SNMP ウィザードで使われる SNMPv3 認証手法。MD5 または SHA のいずれかです。
• _auth_pass_: SNMP ウィザードで使われる SNMPv3 認証パスワード。
• _priv_method_: SNMP ウィザードで使われる SNMPv3 暗号化手法。DES または AES のいずれかです。
• _priv_pass_: SNMP ウィザードで使われる SNMPv3 暗号化パスワード。

When the type of execution is Network:

実行タイプが ネットワーク(Network) の場合は次の通りです。

​​​​WMI class

WMI クラス

It allows to specify the WMI class to check. WMI classes are predefined and included in each namespace from Windows Management Instrumentation® (WMI) core.

チェックする WMI クラスを指定できます。 WMI クラスは事前定義されており、WindowsManagementInstrumentation®（WMI）コアの各名前空間に含まれています。

Query key field ( _field_wmi_0_ )

クエリキーフィールド(Query key field) ( _field_wmi_0_ )

Query extra fields ( _field_wmi_1_ )

追加フィールドクエリ(Query extra fields) ( _field_wmi_1_ )

Query filters → Execution:

クエリフィルタ(Query filters) → 実行(Execution)

This space allows indicating the conditions for the WMI query launched by each module generated by the component. It accepts the use of macros with the names of the query felds (_FIELDNAME_) to obtain the value of each field log. For instance:

これにより、コンポーネントによって生成された各モジュールによって起動された WMI クエリの条件を示すことができます。 各フィールドログの値を取得するために、クエリフィールド (_FIELDNAME_) の名前を持つマクロの使用ができます。 例：

DriveType = 3 AND DeviceID = '_DeviceID_'.

The query is the final execution of a module generated by the component to obtain the free space of the C: disk unit is:

以下のクエリは、C: ドライブの空き領域を取得取得します。

SELECT DeviceID, FreeSpace FROM Win32_LogicalDisk WHERE DriveType = 3 AND DeviceID = 'C:'

Field value

フィールド値(Field value)

Indicate the number of the field of the WMI query from which you want to obtain the module value. Field 0 is the key field of its class and fields 1, and higher, the additional ones of their class.

モジュール値を取得する WMI クエリのフィールドの番号を示します。フィールド 0 はそのクラスのキーフィールドであり、フィールド 1 以上はそれらのクラスの追加フィールドです。

Key string

キー文字列(Key string)

It will allow to convert the module value into boolean (1 or 0) depending on whether the value of the field indicated in Field value matches the text string indicated in this field.

フィールド値 に示されているフィールドの値がこのフィールドに示されているテキスト文字列と一致するかどうかによって、モジュール値をブール値(1 または 0)に変換できます。

When there is a plugin execution:

実行タイプが プラグイン(Plugin) の場合は次の通りです:

It has common fields with Network execution until field Scan (Query filters).

スキャン（クエリフィルター）フィールドまでは、ネットワーク 実行と共通のフィールドです。

Value operation

値の計算(Value operation)

The main purpose of using plugin type components is to be able to perform operations with the values of different query fields, such as obtaining the used-disk percentage from the free-disk bytes and the total disk bytes available.

プラグインタイプのコンポーネントを使用する主な目的は、空きディスク容量と使用可能な合計ディスク容量からディスク使用率を取得するなど、さまざまなクエリフィールドの値を使用して計算を実行できるようにすることです。

This field allows to indicate an arithmetic operation with which you will obtain the current value of each module generated by the component in the wizard's module preview. It does not affect in any case the final execution of the generated modules.

このフィールドでは、ウィザードのモジュールプレビューでコンポーネントによって生成された各モジュールの現在の値を取得する算術演算を設定できます。 生成されたモジュールの最終的な実行には影響しません。

It accepts the characters + - * / ( ) ., numbers and the macros with the names of the fields this type (_FIELDNAME_), from which the values for the operation will be obtained. For example:

計算した値を得るために、“+ - * / ( ) .”、数値、およびフィールド名のマクロ(_FIELDNAME_)を利用できます。例:

((_Size_ - _FreeSpace_) * 100) / _Size_

Satellite execution

サテライト実行(Satellite execution)

It allows to indicate the execution that a Satellite Server should perform for the generated modules when the wizard is launched from a Satellite Server by using the exec server. It is the command, plugin or script that must be used in a Satellite server module_exec.

exec server を使用してサテライトサーバからウィザードを起動したときに、生成されたモジュールに対してサテライトサーバが実行するものを指定することができます。 これは、サテライトサーバの module_exec で使用するコマンド、プラグイン、またはスクリプトです。

It accepts the use of macros for the WMI wizard and of _class_wmi_ macros to obtain the name of the WMI class and _field_wmi_N_ to obtain the names of the fields of the class used in each module.

これは、WMI ウィザードのマクロと _class_wmi_ マクロを使用して WMI クラスの名前を取得し、_field_wmi_N_ を使用して各モジュールで使用されるクラスのフィールドの名前を取得できます。

The Satellite Server distributes a recommended plugin for these components:

サテライトサーバには、これらのコンポーネントが要求するプラグインがあります。

/etc/pandora/satellite_plugins/wizard_wmi_module.

Server plugin

サーバプラグイン(Server plugin)

It allows to indicate a plugin registered in Pandora FMS console that will be used by the plugin server with each module generated by the component. The choice of a plugin shows at the same time the specific fields for its use in the form.

コンポーネントによって生成された各モジュールでプラグインサーバによって使用される Pandora FMS コンソールに登録されたプラグインを指定することができます。プラグインを選択すると、それ用の特定のフィールドがフォームに表示されます。

The own plugin fields accept the use of macros for the WMI wizard and _class_wmi_ macros to get the name of the WMI class and _field_wmi_N_ to get the names of the fields of the class used in each module.

独自のプラグインフィールドでは、WMI ウィザードのマクロの使用ができ、_class_wmi_ マクロは WMI クラスの名前を取得し、 _field_wmi_N_ は各モジュールで使用されるクラスのフィールドの名前を取得します。

Pandora FMS console has an already registered and recommended plugin for these components: Wizard WMI module.

Pandora FMS コンソールには、これらのコンポーネント用の登録済みのプラグインがあります。

The specific macros for the WMI wizard components that can be used in the plugin execution fields are

プラグイン実行フィールドで使用できる WMI ウィザードコンポーネントの特定のマクロは次のとおりです。

• _address_ : IP address used in the WMI wizard. This macro will not be replaced when the wizard is launched in a policy.
• _namespace_wmi_ : Namespace used in the WMI wizard.
• _user_wmi_ : User used in the WMI wizard.
• _pass_wmi_ : Password used in the WMI wizard.

• _address_: WMI ウィザードで利用される IP アドレス。ウィザードがポリシーから起動された場合は、このマクロは置き換えられません。
• _namespace_wmi_: WMI ウィザードで利用されるネームスペース。
• _user_wmi_: WMI ウィザードで利用されるユーザ。
• _pass_wmi_: WMI ウィザードで利用されるパスワード。

The specified fields for WMI Wizard components are:

WMI ウィザードコンポーネントに指定されているフィールドは次のとおりです。

• WMI class: It refers to the WMI class that will be used in the queries of the modules generated by the component. For example: Win32_LogicalDisk.

• WMI class: これは、コンポーネントによって生成されたモジュールのクエリで使用されるWMIクラスを指します。例: Win32_LogicalDisk.

It can be used in other fields from the same form through the macro _class_wmi_.

Query key field ( _field_wmi_0_ )

クエリキーフィールド(Query key field) (_field_wmi_0_)

It is the name of the key field that will be obtained in the WMI query used in the generated modules. Usually, WMI classes have a key field they always return in any query, whether indicated or not. That is the field that should be indicated here. For instance, the key field of class Win32_Processor would be DeviceID.

生成されたモジュールで使用される WMI クエリで取得されるキーフィールドの名前です。 一般に、WMI クラスにはキーフィールドがあり、設定されているかどうかに関係なく、常にクエリで返されます。これは、それに指定するフィールドです。 たとえば、Win32_Processor クラスのキーフィールドは DeviceID になります。

the name of this field can be obtained in other form fields through the macro _field_wmi_0_, and the value the field has for the WMI query log can be obtained through a macro with the same field name ( _FIELDNAME_ ). These macros _FIELDNAME_ can be used, among others, in component Module name and Description fields, to generate names and descriptions dinamically. For instance, for field DeviceID the macro with value would be _DeviceID_.

このフィールドの名前は、_field_wmi_0_ マクロを介して他のフォームで利用でき、フィールドが WMI クエリの各レコードに対して持つ値は、フィールドの同じ名前のマクロ(_フィールド名_)を介して取得できます。 これらの _FIELDNAME_ マクロは、とりわけ、コンポーネントフィールド モジュール名 および 説明 で利用して、名前と説明を動的に生成できます。 たとえば、DeviceID フィールドの場合、値を含むマクロは _DeviceID_ になります。

Query extra fields → _field_wmi_N_:

追加フィールドクエリ(Query extra fields) → _field_wmi_N_

In these fields indicate the names of the additional fields that must be used in the WMI query used in the generated modules.

このフィールドでは、生成されたモジュールで使用される WMI クエリで使用する追加フィールドの名前を指定します。

The names of these fields can be obtained in other form fields through the macros _field_wmi_N_, and the values that the fields for each WMI query log have can be obtained through macros with the same names as those of the fields (_FIELDNAME_). These macros _FIELDNAME_ can be used, among others, in Module name and Description component fields, to generate names and descriptions dinamically. For example for the field FreeSpace the macro with the value would be _FreeSpace_.

これらのフィールドの名前は、_field_wmi_N_ マクロを介してフォームの他のフィールドで利用でき、WMI クエリの各レコードに対してフィールドが持つ値は、フィールドの同じ名前のマクロ(_FIELDNAME_)を介して利用できます。 これらの _FIELDNAME_ マクロは、とりわけ、コンポーネントのフィールド モジュール名 および 説明 で利用して、名前と説明を動的に生成できます。 たとえば、FreeSpace フィールドの場合、値を持つマクロは _FreeSpace_ になります。

Query filters → Scan

クエリフィルタ(Query filters) → スキャン(Scan)

In this space the conditions for the WMI query launched in the scan are indicated, which will allow you to obtain one or more logs. E.g.: DriveType = 3.

ここには、スキャンで起動する WMI クエリの条件を指定します。これにより、1つ以上のレコードを取得できます。 たとえば、DriveType = 3 です。

In WMI wizard components, a different module is generated for each log returned by the WMI scan query. Based on the examples pruvided up to now, the scan query would obtain the free space of the disk units from the Windows computer:

WMI ウィザードコンポーネントでは、WMI スキャンクエリによって返されるレコードごとに異なるモジュールが生成されます。これまでに示した例に基づいて、Windows コンピューターのドライブの空き領域を取得するスキャンクエリは次のようになります。

SELECT DeviceID, FreeSpace FROM Win32_LogicalDisk WHERE DriveType = 3

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

In order to see the existing component groups, go to Resources → Component groups:

定義済みのコンポーネントグループを見るには、リソース(Resources) → コンポーネントグループ(Component Groups) へ行きます。

定義済みのグループとその説明が表示されます。

You may view the details on the groups by clicking on their name, delete them by clicking on the trash icon at the right side, on the Action column, or create new ones by clicking Create at the bottom. you may also select several of them by their respective selection checkbox and clicking Delete.

グループの名前をクリックするとその詳細を見ることができます。削除するには、右側のごみ箱アイコンをクリックします。新たに作成する場合は、作成(Create) ボタンをクリックします。それぞれの選択チェックボックスで複数選択して、削除(Delete) することもできます。

新たなコンポーネントグループを作成したい場合は、作成(Create)ボタンをクリックし、フォームに入力します。

Just provide a name for the group and determine whether it has a parent among the existing groups or not. Then click on Create once you are done.

グループの名前を入力し、既存のグループと親子関係があればそれの選択をするだけです。あとは、 作成(Create) ボタンをクリックします。

これにより、新たなコンポーネントを、作成したコンポーネントグループに追加することができます。