コンポーネントウィザード

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

Within the capabilities of the wizard SNMP and wizard WMI, there are remote component types called Wizard components.

SNMP ウィザードおよび WMI ウィザードの機能には、コンポーネントウィザード と呼ばれるリモートコンポーネントタイプがあります。

These components allow establishing a base configuration for the modules that will be generated in the agents when executing any of the Wizard (SNMP or WMI). It also offers the possibility of dynamically generating several modules with a single component.

これらのコンポーネントを使用すると、ウィザード (SNMP または WMI) の実行時にエージェントで生成されるモジュールの基本設定を確立できます。 また、単一のコンポーネントで複数のモジュールを動的に生成することもできます。

To create these components use the menu Management → Configuration → Templates → Remote components. The Create a new wizard component option is selected and the Create button is clicked.

これらのコンポーネントを作成するには、メニュー 管理(Management) → 設定(Configuration) → テンプレート(Templates) → Remote components(リモートコンポーネント) を使用します。 新しいウィザード コンポーネントを作成(Create a new wizard component) オプションを選択し、作成(Create) ボタンをクリックします。

In the creation dialog box there is an important option: the Module protocol to be used. There are two protocols available, SNMP (default) and WMI, and although both share common fields they also differ in other fields.

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

• Enabled: Enabling this token indicates that the component will attempt to scan when launching the wizard.
• Add by default: Allows to choose if the modules generated by the component will be marked to be added by default when launching the wizard.
• Module name: Name that the component will have, and default name for the modules generated by it. Some macros can be used.
• Module type: Type of data to be obtained by the modules generated by the component.
• Component group: Group to which the component will belong. Allows you to organize the way the modules will be presented.
• Module unit: Unit of the data obtained by the modules generated by the component.
• Warning: In this section you can set a default threshold for the warning status of the modules generated by the wizard.
• Critical status: In this section you can set a default threshold for the critical state of the modules generated by the wizard.
• Description: Description of the component and the modules generated by it. Some macros can be used.

• 有効化(Enabled): この トークン を有効にすると、コンポーネントが ウィザード の実行時にスキャンを試行します。
• デフォルトで追加(Add by default): ウィザード の実行時に、コンポーネントによって生成されたモジュールがデフォルトで追加されるようにマークされるかどうかを選択できます。
• モジュール名(Module name): コンポーネントが持つ名前、およびコンポーネントによって生成されるモジュールのデフォルト名。 一部のマクロが利用できます。
• モジュールタイプ(Module type): コンポーネントによって生成されたモジュールによって取得されるデータのタイプ。
• コンポーネントグループ(Component group): コンポーネントが属するグループ。 モジュールの表示方法を整理できます。
• モジュール単位(Module unit): コンポーネントによって生成されたモジュールによって取得されるデータの単位。
• 警告(Warning): このセクションでは、ウィザード によって生成されたモジュールの警告状態のデフォルトのしきい値を設定できます。
• 障害状態(Critical status): このセクションでは、ウィザード によって生成されたモジュールの障害状態のデフォルトのしきい値を設定できます。
• 説明(Description): コンポーネントとそれによって生成されるモジュールの説明。 一部のマクロが利用できます。

Scan type: Allows you to choose between two exploration modes that wizards will be able to perform with this component:

スキャンタイプ(Scan type): ウィザード がこのコンポーネントで実行できる 2 つのスキャンモードを選択できます。

• Fixed: The component will generate only one module.
• Dynamic: The component may generate one or more modules.

• 固定(Fixed): コンポーネントはモジュールを 1 つだけ生成します。
• 動的(Dynamic): コンポーネントは 1 つ以上のモジュールを生成する場合があります。

Execution type: This field indicates the execution type for the modules generated by the component. It is used to determine the Pandora FMS server to which the modules will belong at the moment of their creation, depending on where the wizard is executed from:

実行タイプ(Execution type): このフィールドは、コンポーネントによって生成されたモジュールの実行タイプを示します。 これは、ウィザード がどこから実行されるかに応じて、モジュール作成時にモジュールが属する Pandora FMS サーバを決定するために使用されます。

• Network: The modules generated by the component will obtain their data with the Pandora FMS own mechanisms for SNMP and WMI modules. These are: the network servers, WMI server y satellite server.
• Plugin: The modules generated by the component will obtain their data from the execution of custom commands, plugins or scripts. In this way, they will be executed by the plug-in server or by the satellite server through modules of type exec.

• ネットワーク(Network): コンポーネントによって生成されたモジュールは、Pandora FMS 独自の SNMP および WMI モジュールのメカニズムを使用してデータを取得します。 これらは次のとおりです: ネットワークサーバ、WMI サーバ、および サテライト サーバ。
• プラグイン(Plugin): コンポーネントによって生成されたモジュールは、カスタムコマンド プラグイン または スクリプト の実行結果からデータを取得します。 これらは プラグインサーバ またはタイプ exec のモジュールを介してサテライトサーバによって実行されます。

Management → Configuration → Templates → Remote components → Create a new wizard component → Create → Module protocol → SNMP menu.

管理(Management) → 設定(Configuration) → テンプレート(Templates) → リモートコンポーネント(Remote components) → 新しいウィザードコンポーネントの作成(Create a new wizard component) → 作成(Create) → モジュールプロトコル(Module protocol) → SNMP メニュー。

Specific fields:

特定のフィールド:

• Name OID: Allows to indicate an OID from which a value will be obtained that can be added to the module name by means of a macro. The value of this OID is stored in the macro _nameOID_, that can be used in the Module name field. If All is indicated as manufacturer, the component will be scanned for any PEN registered in Pandora FMS.
• Manufacturer ID: Allows to indicate the ID of a specific manufacturer for which the wizard SNMP component will take effect.
• When Execution type is established in Network: Value OID.
• ​​​When Execution type is established in Plugin: Macros OID, Value operation, Satellite execution, Server plugin.

• OID 名(Name OID): マクロを使用してモジュール名に追加できる値を取得する OID を指定できます。 この OID の値はマクロ _nameOID_ に保存され、モジュール名 フィールドで使用できます。 ベンダに すべて が示されている場合、コンポーネントは Pandora FMS に登録されている PEN に対してスキャンされます。
• ベンダID(Manufacturer ID): SNMP コンポーネント ウィザード が有効になる特定のベンダの ID を指定できます。
• 実行タイプがネットワークの場合: OID値。
• 実行タイプがプラグインに設定されている場合: マクロOID、値操作、サテライト実行、サーバプラグイン。

Management → Configuration → Templates → Remote components → Create a new wizard component → Create → Module protocol → SNMP (Execution type → Network) menu.

管理(Management) → 設定(Configuration) → テンプレート(Templates) → リモートコンポーネント(Remote components) → 新しいウィザードコンポーネントの作成(Create a new wizard components) → 作成(Create) → モジュールプロトコル(Module protocol) → SNMP (実行タイプ(Execution type) → ネットワーク(Network)) メニュー。

When the execution type is Network the Value OID allows to indicate the OID from which the data of the modules generated by the component will be obtained.

実行タイプが ネットワーク の場合、OID値 により、コンポーネントによって生成されたモジュールのデータが取得される OID を示すことができます。

• If used in dynamic components, the OID indicated in this field must be an SNMP branch and not an end OID.
• If used on fixed components, the OID indicated in this field must be a final OID.

• 動的コンポーネントで使用する場合、このフィールドに指定される OID は、終了 OID ではなく SNMP ブランチである必要があります。
• 固定コンポーネントで使用する場合、このフィールドに示される OID は最終 OID である必要があります。

Management → Configuration → Templates → Remote components → Create a new wizard component → Create → Module protocol → SNMP (Execution type → Plugin) menu.

管理(Management) → 設定(Configuration) → テンプレート(Templates) → リモートコンポーネント(Remote components) → 新しいウィザードコンポーネントの作成(Create a new wizard component) → 作成 → モジュールプロトコル(Module protocol) → SNMP (実行タイプ(Execution type) → プラグイン(Plugin)) メニュー。

The main purpose of using components of type plugin is to be able to perform operations with the values of one or more OIDs in the same device. That is why in these components you can indicate as many OIDs as you need to use them in other fields.

プラグイン タイプのコンポーネントを使用する主な目的は、同じデバイス内の 1 つ以上の OID の値を使用して操作を実行できるようにすることです。 このため、これらのコンポーネントでは、他のフィールドで使用するために必要な数の OID を指定できます。

Macros OID → _oid_N_

OID マクロ → _oid_N_

In addition, these OIDs, or their values, can be used from the _oid_N_ macros. Depending on which of the following fields the macro is used in, either the OID value or the OID itself will be used.

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

If used on dynamic components, the OIDs indicated in these fields must be an SNMP branch and not an end OID. If used on fixed components, the OIDs indicated in these fields must be an end OID.

動的コンポーネントで使用する場合、これらのフィールドに示される OID は、終了 OID ではなく SNMP ブランチである必要があります。 固定コンポーネントで使用する場合、これらのフィールドに示される OID は終了 OID である必要があります。

Value operation

値の操作

Allows you to specify an arithmetic operation with which the current value of each module generated by the component will be obtained in the wizard module preview. In any case it does not affect the final execution of the generated modules.

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

Accepts the characters + - * / ( ) ., numbers and macros _oid_N_ from which the values for the operation will be obtained.

文字 + - * / ( ) .、数字、および操作の値を取得するマクロ _oid_N_ が利用できます。

Satellite execution

サテライト実行

It offers the possibility of indicating the execution to be performed by a Satellite Server for the modules generated when the wizard is executed from a Satellite Server by using the exec server. This is the command, plugin or script to be used in a Satellite Server module_exec. Accepts the use of macros for the SNMP wizard and _oid_N_ macros to obtain the OIDs used in each module.

exec server を使用して、サテライトサーバから ウィザード を実行するときに生成されるモジュールに対して、サテライトサーバによって実行できるようにします。 これは、サテライトサーバの module_exec で使用されるコマンド プラグイン または スクリプト です。 SNMP ウィザード用のマクロと、各モジュールで使用される OID を取得するための _oid_N_ マクロを利用できます。

The Satellite Server distributes a series of plugins recommended for these components:

サテライトサーバは、次の一連のコンポーネントに必要な プラグイン を配布します。

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

Server plugin

サーバプラグイン

Through this list you can indicate a plugin previously registered in the Pandora FMS Console, which will be used by the plugins server with each module generated by the component. The choice of a plugin shows in turn in the form the specific fields to use it.

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

The plugin's own fields accept the use of macros for the SNMP wizard and _oid_N_ macros to obtain the OIDs used in each module.

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

Pandora FMS console has already registered plugins recommended for these components: Wizard SNMP module and Wizard SNMP process. Depending on the use of one or the other, the rest of the respective fields should be completed to carry out the monitoring through SNMP.

Pandora FMS コンソールには、SNMP モジュールウィザード および SNMP プロセスウィザード のコンポーネントに推奨されるプラグインがすでに登録されています。 どちらかの使用に応じて、SNMP を介して監視を実行するには、それぞれのフィールドの残りの部分を設定する必要があります。

Management → Configuration → Templates → Remote components → Create a new wizard component → Create → Module protocol → WMI menu.

管理(Management) → 設定(Configuration) → テンプレート(Templates) → リモートコンポーネント(Remote components) → 新しいウィザードコンポーネントの作成(Create a new wizard component) → 作成(Create) → モジュールプロトコル(Module protocol) → WMI メニュー。

Management → Configuration → Templates → Remote components → Create a new wizard component → Create → Module protocol → WMI (Execution type → Network) menu.

管理(Management) → 設定(Configuration) → テンプレート(Templates) → リモートコンポーネント(Remote components) → 新しいウィザードコンポーネントの作成(Create a new wizard component) → 作成(Create4) → モジュールプロトコル(Module protocol) → WMI (実行タイプ(Execution type) → ネットワーク(Network)) メニュー。

When the execution type is Network:

実行タイプがネットワークの場合:

• WMI class: Allows you to specify the WMI class to query. WMI classes are predefined classes that are included in each Windows Management Instrumentation® (WMI) kernel namespace.
• Query filters → Execution: This space allows to indicate 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 fields (_FIELDNAME_) to obtain the value of each record in that field.
• Field value: To indicate the number of the WMI query field from which the module value is to be obtained, where field 0 is the key field of the class and fields 1 and above are the additional fields of the class.
• Key string: Allows to convert the module value to boolean (1 or 0) depending on whether the value of the field indicated in Field value matches the string indicated in this field.

• WMI クラス(WMI class): クエリを実行する WMI クラスを指定できます。 WMI クラスは、各 Windows Management Instrumentation® (WMI) カーネル名前空間に含まれる事前定義されたクラスです。
• クエリフィルタ(Query filters) → 実行(Execution): このスペースを使用すると、コンポーネントによって生成された各モジュールによって起動される WMI クエリの条件を示すことができます。 クエリフィールドの名前 (_FIELDNAME_) を指定したマクロの利用ができ、そのフィールドの各レコードの値を取得します。
• フィールド値(Field value): モジュール値を取得する WMI クエリフィールドの番号を示します。フィールド 0 はクラスのキーフィールド、フィールド 1 以降はクラスの追加フィールドです。
• キー文字列(Key string): フィールド値 で示されるフィールドの値がこのフィールドで示される文字列と一致するかどうかに応じて、モジュール値を boolean (1 または 0) に変換できます。

Management → Configuration → Templates → Remote components → Create a new wizard component → Create → Module protocol → WMI (Execution type → Plugin) menu.

管理(Management) → 設定(Configuration) → テンプレート(Templates) → リモートコンポーネント(Remote components) → 新しいウィザードコンポーネントの作成(Create a new wizard component) → 作成(Create) → モジュールプロトコル(Module protocol) → WMI (実行タイプ(Execution type) → プラグイン(Plugin)) メニュー。

When the execution type is Plugin:

実行タイプがプラグインの場合:

• It shares common fields with the Network run up to the Query filters (Scan) field.
• Value operation: This field allows you to specify an arithmetic operation to obtain the current value of each module generated by the component in the wizard module preview. In any case it does not affect the final execution of the generated modules. Accepts the characters +, -, *, /, (, ), ., numbers and the macros with the names of the fields of the class _FIELDNAME_, from which the values for the operation will be obtained.
• Satellite execution: Allows to indicate the execution to be performed by a Satellite Server for the modules generated when the wizard is launched from a Satellite Server by using the exec server. This is the command, plugin or script to be used in a Satellite Server module_exec. It accepts the use of the macros for the WMI wizard and the macros _class_wmi_ to get the WMI class name and _field_wmi_N_ to get the names of the class fields used in each module. The Satellite Server distributes a recommended plugin for these components: /etc/pandora/satellite_plugins/wizard_wmi_module.
• Server plugin: It allows to indicate a plugin registered in the Pandora FMS console that will be used by the plugins server with each module generated by the component. The choice of a plugin shows at the same time in the form the specific fields to use it.

• クエリフィルタ(Query filters) (スキャン(Scan)) フィールドまでは、ネットワーク と共通です。
• 値の操作(Value operation): このフィールドを使用すると、ウィザード モジュールプレビュー内のコンポーネントによって生成された各モジュールの現在の値を取得する算術演算を指定できます。 いずれの場合も、生成されたモジュールの最終的な実行には影響しません。 文字 +、-、*、/、(、)、.、数字、および、クラス _FIELDNAME_ フィールドのマクロが利用できます。
• サテライト実行(Satellite execution): exec サーバ を使用して ウィザード がサテライトサーバから起動されるときに生成されるモジュールについて、サテライトサーバによる実行を設定できます。 これは、サテライトサーバの module_exec で使用されるコマンド、プラグイン または スクリプト です。 WMI ウィザード用のマクロと、WMI クラス名を取得するマクロ _class_wmi_ および各モジュールで使用されるクラスフィールドの名前を取得するマクロ _field_wmi_N_ を利用できます。サテライトサーバは、次のコンポーネント用に必要な プラグイン を配布します: /etc/pandora/satellite_plugins/wizard_wmi_module。
• サーバプラグイン(Server plugin): これにより、コンポーネントによって生成された各モジュールとともに プラグイン サーバによって使用される、Pandora FMS コンソールに登録された プラグイン を示すことができます。 プラグイン を選択すると、それを使用する特定のフィールドがフォーム内に同時に表示されます。

Pandora FMS Console has a plugin already registered recommended for these components: Wizard WMI module.

Pandora FMS コンソールには、WMI モジュールウィザードのコンポーネント用に必要な プラグイン がすでに登録されています。

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

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

The specific macros for the WMI wizard components that can be used in the fields of plugin type executions 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 specific fields for WMI wizard components are:

WMI ウィザードコンポーネント特有のフィールドは次のとおりです。

• WMI class: It refers to the WMI class to be used in the queries of the modules generated by the component. For example, Win32_LogicalDisk.
• They can be used in other fields of this same form by means of the macro _class_wmi_.

• WMI class: これは、コンポーネントによって生成されたモジュールのクエリで使用される WMI クラスを指します。 たとえば、Win32_LogicalDisk。
• これらは、マクロ _class_wmi_ を使用して、これと同じ形式の他のフィールドで使用できます。

Query key field ( _field_wmi_0_ )

クエリキーフィールド ( _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 that they always return in any query whether it is indicated or not. That would be the field that should be indicated here. For example, the key field of the Win32_Processor would be DeviceID.

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

The name of this field can be obtained in other fields of the form through the macro _field_wmi_0_, and the value that the field has for each record of the WMI query can be obtained through a macro with the same name of the field _FIELDNAME_. These _FIELDNAME_ macros can be used, among others, in the Module name and Description fields of the component, to generate names and descriptions dynamically. For example, for the DeviceID field the macro with the value would be _DeviceID_.

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

Query extra fields → _field_wmi_N_:

クエリ追加フィールド → _field_wmi_N_:

In these fields the names of the additional fields to be used in the WMI query used in the generated modules will be indicated.

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

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

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

Query filters → Scan

クエリフィルタ → スキャン

In this space the conditions for the WMI query launched in the scan are indicated, which will allow to obtain one or more records. For example: DriveType = 3.

このスペースには、スキャンで起動された WMI クエリの条件が示されており、これにより 1 つ以上のレコードを取得できるようになります。 例: DriveType = 3。

In the WMI wizard components, a separate module will be generated for each record returned by the WMI scan query.

WMI ウィザードコンポーネントでは、WMI スキャンクエリによって返されたレコードごとに個別のモジュールが生成されます。

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