仮想環境監視

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

Red Hat® Enterprise Virtualization (RHEV) is one of the most widely used technologies by companies based on the Red Hat operating system in their Data Center. Pandora FMS offers the possibility of monitoring RHEV-based virtual architectures through the RHEV Monitoring Plugin.

Red Hat Enterprise Virtualization (RHEV) は、RedHat を利用するデータセンター企業で使われている仮想化技術の一つです。Pandora FMS は、RHEV Monitoring Plugin というプラグインを通してRHEV を使った仮想アーキテクチャをモニタすることができます。これは、簡単に RHEV の仮想アーキテクチャに関連するすべての値を制御することができます。

• Data Centers.
• Host Clusters.
• Storage Domains.
• Networks.
• Hosts.
• Virtual Machines.

• データセンター.
• ホストクラスタ.
• ストレージドメイン.
• ネットワーク.
• ホスト.
• 仮想マシン.

Pandora FMS uses the official API provided by the RHEV virtualization system.

これを実現するために、Pandora では RHEV 仮想化システムによって公式に提供されている API を利用しています。

RHEV virtual environment monitoring is based on the following components:

RHEV 環境のモニタリングは、以下のコンポーネントに基づいています。

1. An Agent plugin that performs autodiscovery and data collection tasks. The Agent plugin is responsible for sending the information to Pandora FMS.
2. A reconnaissance script that updates various values for the discovered entities, necessary for the correct operation of the plugin extensions.
3. RHEV Viewer and RHEV Manager: These are extensions that provide the operation of shutting down/starting virtual machines, all from the Pandora FMS web Console.

1. 自動検出動作を行うエージェントプラグインとデータ収集タスク。このエージェントプラグインは、Pandora FMS へ情報を送信します。
2. 検出したいくつかのパラメータを更新する自動検出スクリプト。このスクリプトは、「拡張」のために必要です。
3. RHEV View および RHEV Manager 拡張。これらは、プラグインに機能追加し、Pandora FMS のコンソールからインフラのモニタリングおよび仮想マシンの管理 (電源ON/OFF) ができるようにした「拡張」です。

The RHEV Monitoring Plugin extracts information through the web API served by the RHEV virtualization environment.

RHEV 監視プラグインは、RHEV 仮想環境の web API を通して情報を展開します。

If only monitoring information is needed, the only thing that needs to be configured is the Agent plugin that will perform this task. The plugin configuration allows choosing which elements will be monitored and the configuration of their Modules. Once the XML files are created, the Agent plugin sends the files, either using Tentacle or by copying them to a local directory, depending on the chosen transfer method.

監視情報のみが必要な場合は、このタスクを実行するエージェントプラグインを設定するだけで済みます。プラグインの設定では、監視する要素とそのモジュールの設定を選択できます。XML ファイルが作成されると、エージェントプラグインは、選択した転送方法に応じて、Tentacle を使用するか、ローカルディレクトリにコピーしてファイルを送信します。

If you are also going to use the RHEV Viewer and RHEV Manager extensions, you will need to use the reconnaissance script. The reconnaissance script is responsible for updating variables for each of the Agents detected in Pandora FMS according to the values configured in RHEV. These variables are necessary to correctly visualize the entities in the RHEV Viewer extension and properly manage virtual machines with the RHEV Manager extension.

RHEV Viewer および RHEV Manager 拡張機能も使用する場合は、検出スクリプトを使用する必要があります。検出スクリプトは、RHEV で設定された値に従って、Pandora FMS で検出された各エージェントの変数を更新する役割を担います。これらの変数は、RHEV Viewer 拡張機能でエンティティを正しく表示し、RHEV Manager 拡張機能で仮想マシンを適切に管理するために必要です。

The Agent plugin requires the following software:

エージェントプラグインは、次のソフトウエアが必要です。

• curl.
• perl-XML-Simple.
• EndPoint PFMS and tentacle_client from Pandora FMS.

• curl
• perl-XML-Simple
• Pandora FMS エンドポイント と Pandora FMS tentacle_client

On Red Hat® based systems, you can install the dependencies with the command:

RedHat システムでは、次のように依存ファイルをインストールします。

dnf install perl-XML-Simple curl

SUSE システムでは、次のように依存ファイルをインストールします。

zypper install perl-XML-Simple curl

Debian/Ubuntu システムでは、次のように依存ファイルをインストールします。

apt-get install libxml-simple-perl curl

Before using the plugin, it will be necessary to download the certificate that allows the HTTPS connection to the RHEV API. To do this, run the following command:

プラグインを実行する前に、RHEV API に HTTPS で接続するための証明書をダウンロードする必要があります。証明書をダウンロードするには、次のコマンドを実行します。

curl -o rhevm.cer http://[RHEVM-HOST]:8080/ca.crt

Where [rhevm-host] is the name of the server serving the RHEV API.

ここで、[rhevm-host] は、RHEV API サーバのサーバ名です。

Once the certificate is downloaded, you can verify that the connection to the API is correctly performed with the following command using line connectors \:

証明書がダウンロードされたら、以下のコマンドを使用して行コネクタ \ で API への接続が正しく行われていることを確認できます。

curl -X GET \
  -H "Accept: application/xml" \ 
  -u [USER:PASS] \ 
  --cacert [CERT] https://[RHEVM-HOST]:8443/api

With the following values:

以下の値を使用します。

• USER: user @domain to connect to the API.
• PASS: Password of the user connecting to the API.
• CERT: Path to the certificate downloaded in the previous step.
• RHEVM-HOST: Address of the host serving the API.

• USER: API へ接続する user@domain
• PASS: API へ接続するためのユーザのパスワード
• CERT: ダウンロードした証明書のパス
• RHEVM-HOST: API ホストのアドレス

If the command execution is successful, it will return output in XML format with general information about the RHEV API.

コマンドの実行が成功した場合、RHEV API に関する一般的な情報を含む出力が XML 形式で返されます。

In the RHEV virtualization environment, it is possible for several entities to have the same name. This poses a problem since, in Pandora FMS, those entities will be transformed into Agents where duplicate names are not allowed. Furthermore, it will also cause problems when parsing the result returned by the API in XML format, showing an error similar to the following:

RHEV 仮想化環境では、複数のエンティティが同じ名前を持つ可能性があります。これは、Pandora FMS ではこれらのエンティティがエージェントに変換され、重複した名前が許可されないため問題となります。さらに、API から返される結果を XML 形式で解析する際にも問題が発生し、以下のようなエラーが表示されます。

Warning: 
<data_center> element has non-unique value in 'name' key attribute
Default at ./plugin-rhev.pl line 199

To solve this problem, it is only necessary to follow a naming convention for the RHEV virtualization environment entities where names are not repeated.

この問題を解決するには、RHEV 仮想化環境エンティティの命名規則に従い、名前が重複しないようにするだけで十分です。

To install the Agent plugin, you only need to copy the rhev-plugin.pl script and the rhev-plugin.conf configuration file into a directory on the machine where the Pandora FMS Agent that will execute the plugin is installed. The plugin can be executed on an Agent installed on the same machine as the Pandora FMS server or on a different machine.

エージェントプラグインをインストールするには、rhev-plugin.pl スクリプトと rhev-plugin.conf 設定ファイルを、プラグインを実行する Pandora FMS エージェントがインストールされているマシンのディレクトリにコピーするだけです。プラグインは、Pandora FMS サーバと同じマシンにインストールされているエージェントでも、別のマシンにインストールされているエージェントでも実行できます。

To execute the plugin, you must add the following line to the Agent configuration file (by default /etc/pandora/pandora_agent.conf):

プラグインを実行するには、エージェント設定ファイル（デフォルトでは /etc/pandora/pandora_agent.conf）に次の行を追加する必要があります。

module_plugin /root/rhev-plugin.pl /root/rhev-plugin.conf

By adding this line, the Agent plugin will perform its functions in each execution.

この行を追加することにより、エージェントの実行間隔でエージェントプラグインが実行されます。

To see the result of running the Agent plugin go to Operation → Monitoring → Views → Agent Detail. By clicking on the name of an Agent you will be able to see the Monitoring Modules created by the plugin, as well as other relative data.

プラグインの実行結果を見るには、操作(Operation) → モニタリング(Monitoring) → 表示(Views) → エージェント詳細(Agent Detail) をクリックします。エージェントの名前をクリックすると、プラグインによって作成された監視モジュールやその他の関連データを確認できます。

The plugin creates an Agent in Pandora FMS for each of the entities detected in the discovery of the RHEV architecture. For each type of entity, a series of specific Modules are automatically created, monitoring the important information of each of them.

このプラグインは、RHEV アーキテクチャの検出で検出されたエンティティごとに Pandora FMS にエージェントを作成します。 エンティティのタイプごとに、一連の特定のモジュールが自動的に作成され、それぞれの重要な情報が監視されます。

If the selected Agent corresponded to a Host instead of a Virtual Machine, the monitoring modules would be different.

選択したエージェントが仮想マシンではなくホストに対応する場合、監視モジュールは異なります。

The RHEV plugin also monitors events that occur within the virtual architecture. The plugin will create a Module for each monitored event within each affected entity. The data for Modules created from events is event data: event time, event description.

RHEV プラグインは、仮想アーキテクチャ内で発生するイベントも監視します。 プラグインは、影響を受ける各エンティティ内の監視対象イベントごとにモジュールを作成します。 イベントから作成されたモジュールのデータは、イベントデータ (イベント時間、イベントの説明) です。

In addition to the Agents and Modules related to the RHEV architecture itself, a Module called, by default RHEV Plugin, is generated in the Agent that executes the plugin.

RHEV アーキテクチャ自体に関連するエージェントとモジュールに加えて、プラグインを実行するエージェント内に、デフォルトで RHEV Plugin と呼ばれるモジュールが生成されます。

以下に、RHEV アーキテクチャのそれぞれの要素のためのモジュールの詳細について示します。

• Status: データセンターの状態

• Available Space: ストレージドメインの空き容量
• Committed Space: ストレージドメインのコミット容量
• Used Space: ストレージドメインの利用容量
• Percent Free Space: ストレージドメインの空き容量率

• Status: 仮想ネットワークの状態
• STP Status: スパニングツリープロトコルの状態

• Overcommit Percent: クラスタのオーバーコミット率
• Transparent HugePages: Transparent HugePage の状態
• High threshold: ポリシープランニングのための上位閾値
• Low threshold: ポリシープランニングのための下位閾値
• Threshold duration: ポリシープランニングのための閾値期間

• Status: ホストの状態
• Buffers size: バッファサイズ
• Cache size: キャッシュサイズ
• Cached swap: キャッシュスワップのためのメモリ量 (バイト単位)
• Free memory: 空きメモリ量 (バイト単位)
• Percent free memory: 空きメモリ率
• Swap cached percent: キャッシュスワップメモリ率
• Swap free: スワップの空き容量 (バイト単位)
• Swap free percent: 空きスワップメモリ率
• Total Memory: このホストのトータルメモリ容量 (バイト単位)
• Total Swap: スワップメモリ容量 (バイト単位)
• Used memory: 利用メモリ量 (バイト単位)
• Used Swap: 利用スワップメモリ量 (バイト単位)
• Nic [x] TX: nic x の送信速度 (バイト/秒) インタフェースごとにモジュールが生成されます。
• Nic [x] RX: nic x の受信速度 (バイト/秒) インタフェースごとにモジュールが生成されます。
• Nic [x] erros TX: nic x の送信エラー数。インタフェースごとにモジュールが生成されます。
• Nic [x] erros RX: nic x の受信エラー数。インタフェースごとにモジュールが生成されます。
• User CPU: user CPU 使用率
• System CPU: system CPU 使用率
• CPU Idle: idle CPU 使用率
• CPU Load: 5分間のロードアベレージ
• KSM CPU: KSM の CPU 使用率
• Active VM: ホスト内の稼働中の仮想マシン数
• Migrating VM: ホスト内でマイグレーション処理中の仮想マシン数
• Total VM: このホストにおける全仮想マシン数
• Fence Status: ホストフェンスの状態

• Status: 仮想マシンの状態
• Disk [x] read: ディスク x の読み込み速度 (バイト/秒)。ディスクごとにモジュールが生成されます。
• Disk [x] write: ディスク x の書き込み速度 (バイト/秒)。ディスクごとにモジュールが生成されます。
• Disk [x] size: disk x のディスクサイズ。ディスクごとにモジュールが生成されます。
• Disk [x] status: disk x の状態。ディスクごとにモジュールが生成されます。
• Nic [x] TX: nic x の送信速度 (バイト/秒)。nic ごとにモジュールが生成されます。
• Nic [x] RX: nic x の受信速度 (バイト/秒)。nic ごとにモジュールが生成されます。
• Nic [x] erros TX: nic x の送信エラー数。nic ごとにモジュールが生成されます。
• Nic [x] erros RX: nic x の受信エラー数。nic ごとにモジュールが生成されます。
• Installed memory: 設定されたメモリ容量 (バイト単位)
• Percent free memory: 空きメモリ率
• Used memory: 利用メモリ量 (バイト単位)
• Stateless: ステートレス機能の状態
• HA Status: HA 機能の状態
• Total CPU: この仮想マシン全体の CPU 使用率
• Hypervisor CPU: 仮想マシンによって使われている、ハイパーバイザーの CPU 使用率
• Guest CPU: 仮想マシンの CPU 使用率

• Event [x]: システム内で発生したイベント x の説明。それぞれのエージェント内に、検出されたイベントごとにモジュールが作成されます。

There is a possibility to create custom reconnaissance tasks thanks to the Discovery server.

自動検出サーバにより、カスタム検出タスクを作成することが可能です。

To install the extensions, simply copy the content of the extensions folder, which will be found when unzipping the plugin, into the corresponding extensions folder of the Pandora FMS Console. The command to execute is the following:

拡張のインストールは、extensions フォルダの中身をコピーするだけです。プラグインを展開したものを Pandora FMS コンソールの extensions フォルダへコピーします。実行コマンドは次の通りです。

cp -R extensions/* <pandora_console_dir>/enterprise/extensions/

From that moment, the RHEV monitoring extensions will be available.

これで、RHEV モニタリング拡張が使えるようになります。

To use the RHEV View extension, simply click on the RHEV View option within the Monitoring submenu.

RHEV View 拡張機能を使用するには、モニタリング サブメニュー内の RHEV View オプションをクリックするだけです。

The extension will show a map with all the RHEV architecture components discovered by the plugin.

この拡張機能は、プラグインによって検出されたすべての RHEV アーキテクチャコンポーネントを示すマップを表示します。

The RHEV Manager extension is available in the operation view of the Pandora FMS agents that correspond to virtual machines within the RHEV virtualization architecture.

RHEV Manager 拡張機能は、RHEV 仮想化アーキテクチャ内の仮想マシンに対応する Pandora FMS エージェントの操作画面で利用できます。

To access the extension, click on the button with the Red Hat logo that you will find along with the other agent tabs.

拡張機能にアクセスするには、他のエージェントタブと一緒に表示される Red Hat のロゴが付いたボタンをクリックしてください。

The extension allows managing virtual machines (start, stop, and suspend) without opening the RHEV management console. The extension shows the current status of the virtual machine with a color code:

この拡張機能を使用すると、RHEV 管理コンソールを開かずに仮想マシンを管理（起動、停止、一時停止）できます。拡張機能は、仮想マシンの現在の状態をカラーコードで表示します。

• Green = Running.
• Orange = Suspended.
• Gray = Stopped.

• 緑 = 実行中
• オレンジ = 一時停止中
• 灰 = 停止中

With a list of available statuses to which the virtual machine can be moved by clicking the Change Status button.

仮想マシンを移動できる利用可能なステータスの一覧が表示され、ステータス変更(Change status) ボタンをクリックして移動できます。

If you choose the Stop status to stop the virtual machine, the extension will connect with the RHEV API and send the command. The result will be the change of status in the virtual machine and the list options.

仮想マシンを停止するために 停止 ステータスを選択すると、拡張機能は RHEV API に接続してコマンドを送信します。その結果、仮想マシンのステータスとリストオプションが変更されます。

The transition between some statuses is not automatic, such as from Stop status to Start. In this case, the extension will show the virtual machine status as it changes in the virtualization architecture.

一部のステータス間の遷移は自動ではありません。たとえば、停止 ステータスから 開始 ステータスへの遷移などです。この場合、拡張機能は仮想化アーキテクチャ内で仮想マシンのステータスが変化する様子を表示します。

The configuration of the Agent plugin is performed through a configuration file whose default name is rhev-plugin.conf.

エージェントプラグイン設定は、デフォルトで rhev-plugin.conf という設定ファイル使って行います。

By default, the Agent plugin selects all entities and creates all corresponding Modules with default values for the name and description. All these aspects, as well as general plugin variables, can be configured through the configuration file.

デフォルトでは、エージェントプラグインは全エンティティを選択し、名前と説明をデフォルトの値で全モジュールを作成します。これらのパラメータはすべて設定ファイルを通してカスタマイズできます。

The configuration file has two clearly differentiated areas: global variables and monitoring configuration.

設定ファイルは、全体の設定と個々の監視の設定の 2つの部分から成ります。

The global variables section begins with the Configuration token and contains the plugin configuration information. The permitted parameters in this section are:

全体の設定の部分では、Configuration という記述から始まり、プラグイン設定に関する情報があります。この部分で設定可能なパラメータは次の通りです。

• module_name: Name of the Agent Module with the plugin execution status.
• server: Name of the host serving the RHEV API.
• user: User in user @domain format to connect to the API.
• pass: Password to connect to the API.
• cert: Certificate path to connect to the API.
• temporal: Temporary directory.
• logfile: Log file.
• transfer_mode: Transfer mode. It can take the values: local or tentacle.
• tentacle_ip: IP address of the Tentacle server to which information will be sent. Typically it will be located on the same machine as the Pandora FMS server. This option is only used if transfer_mode is set to tentacle.
• tentacle_port: Tentacle server port. This option is only used if transfer_mode is set to tentacle.
• tentacle_opts: Data sending options for Tentacle. This option is only used if transfer_mode is set to tentacle.

• module_name: プラグインを実行するエージェントから報告されるモジュール名です。
• server: RHEV API を実行するホスト名です。
• user: API に接続するユーザです。user@domain という書式です。
• pass: API へ接続するパスワードです。
• cert: API 証明書のパスです。
• temporal: テンポラリフォルダです。
• logfile: ログファイル名です。
• transfer_mode: 転送モードです。local または tentacle です。
• tentacle_ip: 情報の送信先の tentacle サーバの IP です。一般的に Pandora サーバと同じマシンです。転送モードに tentacle を利用した場合に利用できます。
• tentacle_port: tentacle サーバのポート番号です。転送モードに tentacle を利用した場合に利用できます。
• tentacle_opts: tentacle サーバの拡張オプションです。転送モードに tentacle を利用した場合に利用できます。

The monitoring configuration section is divided into several subsections. The first subsection has the Reject token and is used to list the virtualization environment entities that will be discarded from monitoring. To discard an entity, it will be necessary to put its name in this list:

監視設定部分には、いくつかのサブセクションがあります。一つ目は、Reject というトークンがあり、除外する仮想環境のエンティティの名前のリストを作成することができます。エンティティを除外するには、次のように名前のリストを記載する必要があります。

#Dismissed entities
Reject
mv1
mv_Windows10
mv_WebServer1
…

It is possible to discard all entities of the same type, for example, all hosts, all virtual machines, etc. The tokens for each entity are: all_dc (Data Center), all_host (Hosts), all_network (Networks), all_storage (Storage Domain), all_cluster (Cluster), all_vm (Virtual Machines). Examples:

全ホスト、全仮想マシンなど、一つの種類のすべてのエンティティを除外することもできます。それぞれのエンティティのトークンは、all_dc (データセンタ)、all_host (ホスト)、all_network (ネットワーク)、all_storage (ストレージドメイン)、all_cluster (クラスタ)、all_vm (仮想マシン)です。これらのトークンの利用例を以下に示します。

#Dismissed entities
Reject
all_dc
all_host
all_network
all_storage
all_cluster
all_vm

The second section has the Rename token and is used to change the names of the entities monitored through the plugin. This functionality is very useful if you want to combine EndPoint monitoring with data extracted from the API in the same Pandora FMS Agent. The configuration of this section is performed by placing the old name first and then the new one separated by a space:

2つ目のセクションは、Rename というトークンで定義され、エンティティの名前を変更できます。この機能は、Pandora FMS の同一エージェント内でエンドポイントと API 情報を結びつけるのにとても便利です。このセクションの設定は、古い名前、新しい名前の順にスペースを入れて次のように記述します。

#Rename entities
Rename
mv_WebServer1 WebServer1
mv_Windows10 Windows10 Test
…

The following subsections correspond to the monitoring configuration for each entity. Each entity has its own token, which are: DataCenter, StorageDomain, Network, Cluster, Host, VM. For each of these entities, it is possible to define the Modules that will be disabled or define custom values for the name, description, and the maximum and minimum ranges for the Warning and Critical statuses:

次のサブセクションは、エンティティのモニタリング設定に関するものです。それぞれのエンティティには、それぞれ DataCenter, StorageDomain, Network, Cluster, Host および VM というトークンがあります。各エンティティで、モジュールの有効・無効、警告や障害状態となる最小値や最大値を定義することができます。例を以下に示します。

#VM Modules
VM
status disabled
errors_total_tx name = Errors TX Net [%s]; desc = Total network TX errors; limits = 60 70 71 100
memory_used name = Memory in use; desc = Memory used by the virtual machine; limits = 256 1024 1025 2048
…

Each configuration line of the monitoring modules corresponds to two available options:

それぞれの行はモニタリングモジュールに関連していて、次の 2つのオプションがあります。

• <module> disabled: The Module will NOT be created.
• <module> name = <name>; desc = <description>; limits = <min_warning> <max_warning> <min_critical> <max_critical>: The Module will be created with the provided name and description, and thresholds for the maximums and minimums of the Warning and Critical values will also be defined.

• <モジュール> disabled: モジュールは、作成されません 。
• <モジュール> name = <名前>; desc = <説明>; limits = <警告の最小値> <警告の最大値> <障害の最小値> <障害の最大値» モジュールは、指定した名前と説明で作成されます。また、警告および障害の最大・最小の閾値を指定します。

It is very important to keep in mind the structure of the configuration file lines and especially to see that the character ; is placed right next to the module name and description. These two lines are NOT equivalent (see the spaces before the ; character):

設定ファイルの行構造 に注意し、特にモジュール名とモジュールの説明の近くの; 文字 に注意することがとても重要 です。これらの行は、同じではありません 。(; 文字の前のスペースを確認してください)

errors_total_tx name = Net TX Errors [%s]; desc = Total Network TX Errors; limits = 60 70 71 100 #Correct
errors_total_tx name = Net TX Errors [%s] ; desc = Total Network TX Errors ; limits = 60 70 71 100 #Incorrect

The Modules are referenced by their short name, an equivalent name that is easier to write in the command line. The mapping table between short and expanded names is in the following section.

モジュールは、コマンドラインで入力しやすい短い名前で参照されます。フルネームと短い名前の関連付けした表を次の章に示します。

Practical configuration case for virtual machines, VM section:

仮想マシンの設定例 (VM セクション) を見てみましょう。

For the monitoring of virtual machines, a series of enabled or disabled Modules have been defined in the VM section of the configuration file. More specifically: the status Module has been disabled and for the errors_total_tx and memory_used Modules, custom values have been defined. The other Modules that do not appear in the list will be created with the default values. With this configuration, the memory_used Module will take the following values:

仮想マシンをモニタするには、設定ファイルの VM セクションで、モジュールを有効化・無効化するかの一覧を定義します。status モジュールは無効化されており、errors_total_tx および memory_used モジュールはカスタム値を持っています。リストに無い残りのモジュールは、デフォルトの値で作成されます。この設定で、memory_used モジュールは次の値になります。

• Name: Memory in use.
• Description: Memory used by the virtual machine.
• Min Warning: 256.
• Max Warning: 1024.
• Min Critical: 1025.
• Max Critical: 2048.

Modules are generated dynamically, for example, two related to disks or interfaces where one is created for each detected element. They have a special syntax for the Module name, which is the following:

ディスクやネットワークインタフェースに関連するモジュールは動的に生成されます。それぞれの要素ごとにモジュールが作成され、次のようにモジュール名は特別な書式になっています。

errors_total_tx name = Net TX Errors [%s]; desc = Total Network TX Errors; limits = 60 70 71 100

In these cases, as the name has a dynamic part, what is allowed is to use the %s macro which will be replaced by the plugin with the variable part of the Module name.

この場合、名前は動的に決まる部分があり、% マクロを利用することができます。これはプラグインによりモジュール名で動的に変わるものに置き換えられます。

For example, the errors_total_tx Module has the default name:

例えば、errors_total_tx モジュールのデフォルトの名前は次の通りです。

Nic [nic1] errors TX

It will be renamed to

次のように名称変更されます。

Errors TX Net [nic1]

Where nic1 is the dynamic part of the module name.

nic1 がモジュール名で動的に決まる部分です。

In addition to the sections specific to each element of the architecture, the configuration file has a common section for Events. This section is defined with the EventCodes token and in it, the codes of the events to be monitored will be listed; for example:

それぞれの要素に関連したセクションに加え、設定ファイルにはイベント設定のための共通セクションがあります。このセクションは、EventCodes というトークンで定義され、モニタするすべてのイベントコード一覧を次のように定義します。

EventCodes
30
920
980
509
956

If you do not define this section, event monitoring will not be performed.

このセクションを定義しないと、イベントモニタリングは動作しません。

設定ファイルを通して、RHEV 仮想環境のモニタリング負荷を分散することができます。

そのためには、モニタするエンティティをエージェント間で分割する必要があります。この例では、次のようなアーキテクチャを想定します。

 DC1
  |
  |- Cluster 1.1
        |- c1.1mv1
        |- c1.1mv2
        |- c1.1mv3

  |- Cluster 1.2
        |- c1.2mv1
        |- c1.2mv2
        |- c1.2mv3

 DC2
  |
  |- Cluster 2.1
        |- c2.1mv1
        |- c2.1mv2
        |- c2.1mv3

  |- Cluster 2.2
        |- c2.2mv1
        |- c2.2mv2
        |- c2.2mv3

One way to divide the load would be to assign a Datacenter to each of the EndPoint; to do this we would use the functionality to discard entities to be monitored (token Reject).

負荷を分散する方法として、一つのデータセンタをそれぞれ違うエンドポイントに割り当てます。そのためには、エンティティを除外する機能 (Reject トークン) を利用します。

The first EndPoint monitors the DC1 Datacenter and discards the DC2 entities.

最初のエンドポイントはデータセンター DC1 のみをモニタし、DC2 のエンティティは除外します。

 Reject
 DC2
 Cluster 2.1
 Cluster 2.2
 c2.1mv1
 c2.1mv2
 c2.1mv3
 c2.2mv1
 c2.2mv2
 c2.2mv3

The second EndPoint monitors the DC2 Datacenter and discards the DC1 entities.

2つ目のエンドポイントは、データセンター DC2 をモニタし、DC1 は除外します。

 Reject
 DC1
 Cluster 1.1
 Cluster 1.2
 c1.1mv1
 c1.1mv2
 c1.1mv3
 c1.2mv1
 c1.2mv2
 c1.2mv3

また、クラスタをベースに負荷を分散することもできます。例えば、4つのソフトウエアエージェントがあり、それぞれ異なるクラスタをモニタします。

EndPoint 1, monitor Cluster 1.1 and discard the other entities.

エンドポイント 1 ではクラスタ 1.1 をモニタし、他のエンティティを除外します。

 Reject
 DC1
 Cluster 1.2
 c1.2mv1
 c1.2mv2
 c1.2mv3
 DC2
 Cluster 2.1
 Cluster 2.2
 c2.1mv1
 c2.1mv2
 c2.1mv3
 c2.2mv1
 c2.2mv2
 c2.2mv3

EndPoint 2, monitor Cluster 1.2 and discard the other entities.

エンドポイント 2 ではクラスタ 1.2 をモニタし、他のエンティティを除外します。

 Reject
 DC1
 Cluster 1.1
 c1.1mv1
 c1.1mv2
 c1.1mv3
 DC2
 Cluster 2.1
 Cluster 2.2
 c2.1mv1
 c2.1mv2
 c2.1mv3
 c2.2mv1
 c2.2mv2
 c2.2mv3

EndPoint 3, monitor Cluster 2.1 and discard the other entities.

エンドポイント 3ではクラスタ 2.1 をモニタし、他のエンティティを除外します。

 Reject
 DC1
 Cluster 1.1
 Cluster 1.2
 c1.1mv1
 c1.1mv2
 c1.1mv3
 c1.2mv1
 c1.2mv2
 c1.2mv3
 DC2
 Cluster 2.2
 c2.2mv1
 c2.2mv2
 c2.2mv3

EndPoint 4, monitoring Cluster 2.2 and discards all other entities.

エンドポイント 4ではクラスタ 2.2 をモニタし、他のエンティティを除外します。

 Reject
 DC1
 Cluster 1.1
 Cluster 1.2
 c1.1mv1
 c1.1mv2
 c1.1mv3
 c1.2mv1
 c1.2mv2
 c1.2mv3
 DC2
 Cluster 2.1
 c2.1mv1
 c2.1mv2
 c2.1mv3

The configuration of discarded entities is totally flexible and the load could be divided by assigning several entities to each EndPoint.

エンティティの除外設定はとても柔軟で、それぞれのエンドポイントで複数のエンティティのモニタリング負荷を分散させることができます。

全モジュール無効化の例

 #These lines are comments

 #Plugin configuration parameters
 Configuration
 server rhevm.server
 user user@testdomain
 pass 12345
 cert /home/user/rhevm.cer
 temporal /tmp
 logfile /tmp/plugin-rhev.log
 transfer_mode local
 tentacle_ip 127.0.0.1
 tentacle_port 41121
 tentacle_opts

 #Dismissed entities
 Reject

 #Data Center modules
 DataCenter
 status disabled

 #StorageDomain modules
 StorageDomain
 available disabled
 used disabled
 committed disabled
 free_percent disabled

 #Networks modules
 Network
 status disabled
 stp disabled

 #Clusters modules
 Cluster
 overcommit disabled
 hugepages disabled
 threshold_low disabled
 threshold_high disabled
 threshold_duration disabled

 #Host Modules
 Host
 status disabled
 vm_active disabled
 vm_migrating disabled
 vm_total disabled
 data_current_rx disabled
 data_current_tx disabled
 errors_total_rx disabled
 errors_total_tx disabled
 memory_cached disabled
 memory_total disabled
 swap_free_percent disabled
 swap_cached_percent disabled
 swap_free disabled
 cpu_current_idle disabled
 cpu_current_user disabled
 memory_used disabled
 ksm_cpu_current disabled
 memory_free_percent disabled
 swap_total disabled
 memory_buffers disabled
 cpu_current_system disabled
 cpu_load_avg_5m disabled
 swap_cached disabled
 swap_used disabled
 memory_free disabled
 fence_status disabled

 #VM Modules
 VM
 status disabled
 stateless disabled
 ha disabled
 cpu_current_guest disabled
 cpu_current_hypervisor disabled
 memory_free_percent disabled
 memory_installed disabled
 memory_used disabled
 cpu_current_total disabled
 data_current_read disabled
 data_current_write disabled
 size disabled
 disk_status disabled
 data_current_rx disabled
 data_current_tx disabled
 errors_total_rx disabled
 errors_total_tx disabled

Nutanix プラグインは、Perl で書かれたプログラムで、Nutanix PRISM の REST API へ接続します。以下の要素を監視するために必要なメトリックスを取得します。

• Nutanix® clusters.
• Storage devices.
• Containers.
• Virtual Machines.
• hosts.
• Status of replication processes.

• Nutanix® クラスタ
• ストレージデバイス
• コンテナ
• 仮想マシン
• ホスト
• レプリケーションプロセスの状態

To retrieve information from the REST API you need:

REST API から情報を取得するためには、以下が必要です。

• The portal IP address / FQDN.
• A user with read permissions on the API.
• The password of said user.

• ポータルの IPアドレス/FQDN
• API の読み出し権限を持った ユーザ
• ユーザの パスワード

Regarding the communication of monitoring results to your Pandora FMS you need:

監視結果を Pandora FMS へ反映させるために、以下が必要です。

• The information transfer mode, either local or via Tentacle.
• In case of being local, the directory address where the XML files with results must be delivered, as well as write permissions in said directory.
• In case of communication via Tentacle, it will be necessary to connect against the Pandora FMS server IP address or FQDN, the port used by your Tentacle installation, the Tentacle client location as well as any extraordinary options you have defined.

• ローカルまたは Tentacle での 情報の転送
• ローカルであれば、結果を含む XML ファイルを置くディレクトリが必要です。またディレクトリには書き込み権限が必要です。
• Tentacle を利用する場合は、Pandora サーバの IPアドレスまたは FQDN に Tentacle のポートで接続できる必要があります。tentacle クライアントの場所やオプションの定義も必要です。

Download the files required by the plugin from the Module library. Transfer the files to the remote computer from where you want to perform the monitoring of your Nutanix® infrastructure and extract the plugin files:

プラグインに必要なファイルをモジュールライブラリからダウンロードします。ダウンロードしたファイルを、Nutanix® インフラストラクチャの監視を実行するリモートコンピュータに転送し、プラグインファイルを解凍します。

tar xvzf pandora_nutanix.tar.gz

The following fields are declared:

次のフィールドがあります。

Nutanix API configuration

Nutanix API 設定

• nx_fqdn: Main Prism server address.
• nx_port: Port where the REST API is published (default 9440).
• nx_user: User with read privileges on the REST API.
• nx_pass: Password of said user.
• use_https: Use https (1) or not (0)
• nx_rest_version: Rest API version (default 'v1').

• nx_fqdn: メインの Prism サーバのアドレス。
• nx_port: REST API が公開されるポート (デフォルトは 9440)。
• nx_user: REST API を介した読み取り権限を持つユーザ。
• nx_pass: 当該ユーザのパスワード。
• use_https: https を使用する (1) かしないか (0)
• nx_rest_version: REST API バージョン (デフォルトは 'v1' )。

Nutanix agent configuration

Nutanix エージェント設定

• agent_interval: Interval of the Agents generated by the plugin (default 300).
• agent_group: Group to which the generated Agents will belong (if 'autocreate_group' is commented in your PandoraServer configuration), default Nutanix.
• module_interval: Interval of the generated agents' Modules (multiplication factor, default 1).
• module_tags: Tags associated with the new modules of the generated agents.
• module_group: Group to which the new Modules will belong.

• agent_interval: プラグインによって生成されるエージェントの間隔 (デフォルトは 300)。
• agent_group: 生成されたエージェントが属するグループ (PandoraServer 設定で「autocreate_group」がコメントアウトされている場合)、デフォルトは Nutanix。
• module_interval: 生成されたエージェントのモジュールの間隔 (倍率、デフォルトは 1)。
• module_tags: 生成されたエージェントの新しいモジュールに関連付けられるタグ。
• module_group: 新しいモジュールが属するグループ。

Configuration of communication to the Pandora FMS server

Pandora FMS サーバとの通信設定

• mode: Data transfer mode, “local” or “tentacle”.
• tentacle_ip: Pandora FMS server IP address, only applies in Tentacle mode.
• tentacle_port: Port where the Tentacle service is listening.
• tentacle_opts: Any extra options configured in your Tentacle service.
• tentacle_client: Full path to your Tentacle client.
• temp: Temporary working directory.
• local_folder: Delivery path for the “local” data transfer mode.

• mode: データ転送モード。“local” または “tentacle”
• tentacle_ip: Pandora FMS サーバの IP アドレス。Tentacle モードでのみ有効。
• tentacle_port: Tentacle サービスが待ち受けているポート。
• tentacle_opts: Tentacle サービスの追加設定オプション。
• tentacle_client: tentacle クライアントのフルパス。
• temp: 一時作業ディレクトリ。
• local_folder: “local” データ転送モードの際のファイル転送パス。

Filters

フィルタ

• cluster_monitoring: Enable (1) or not (0) cluster monitoring.
• storage_monitoring: Enable (1) or not (0) storage device monitoring.
• container_monitoring: Enable (1) or not (0) storage container monitoring.
• vm_monitoring: Enable (1) or not (0) virtual machine monitoring.
• host_monitoring: Enable (1) or not (0) virtual machine server monitoring (Nutanix nodes).
• pd_monitoring: Enable (1) or not (0) protection domain monitoring.

• cluster_monitoring: クラスタ監視の有効化(1)、無効化(0)。
• storage_monitoring: ストレージデバイス監視の有効化(1)、無効化(0)。
• container_monitoring: ストレージコンテナ監視の有効化(1)、無効化(0)。
• vm_monitoring: 仮想マシン監視の有効化(1)、無効化(0)。
• host_monitoring: 仮想サーバ (Nutanix ノード) 監視の有効化(1)、無効化(0)。
• pd_monitoring: 保護ドメイン監視の有効化(1)、無効化(0)。

Customizations

カスタマイズ

• cluster_agent_header: Header for the Agent name of cluster type devices.
• storage_agent_header: Header for the Agent name of storage device type devices.
• host_agent_header: Header for the Agent name of virtual machine server type devices (Nutanix nodes).
• container_agent_header: Header for the Agent name of storage container type devices.
• vm_agent_header: Header for the Agent name of virtual machine type devices.
• pd_agent_header: Header for the Agent name of protection domain type devices

• cluster_agent_header: クラスタデバイスエージェントの名前のヘッダ。
• storage_agent_header: ストレージデバイスタイプのデバイスエージェントの名前のヘッダ。
• host_agent_header: 仮想マシンサーバタイプのデバイスエージェント (Nutanix ノード) の名前のヘッダ。
• container_agent_header: ストレージコンテナタイプのデバイスエージェントの名前のヘッダ。
• vm_agent_header: 仮想マシンタイプデバイスエージェントの名前のヘッダ。
• pd_agent_header: 保護ドメインタイプデバイスエージェントの名前のヘッダ。

Module generation rules

モジュール生成ルール

• vm_stat: Rule for adding Modules for virtual machine monitoring, default hypervisor_cpu_usage_ppm|hypervisor_memory_usage_ppm|.*avg.*, this indicates the extraordinary Modules that will be generated, when the metric name matches the regular expressions indicated in this field. Add the value .* to monitor all available metrics.
• host_stat: Rule for adding Modules for virtual machine server monitoring (Nutanix nodes), default hypervisor_cpu_usage_ppm|hypervisor_memory_usage_ppm|.*avg.*, this indicates the extraordinary Modules that will be generated, when the metric name matches the regular expressions indicated in this field. Add the value .* to monitor all available metrics.
• pd_stat: Rule for adding Modules for protection domain monitoring, default replication_transmitted_bandwidth_kBps|replication_total_transmitted_bytes, this indicates the extraordinary Modules that will be generated, when the metric name matches the regular expressions indicated in this field. Add the value .* to monitor all available metrics.

• vm_stat: 仮想マシンを監視するためのモジュールを追加するためのルール。デフォルトでは hypervisor_cpu_usage_ppm|hypervisor_memory_usage_ppm|.*avg.*。これは、メトリック名がこのフィールドに示された正規表現と一致する場合に生成される特別なモジュールを示します。 値 .* を設定すると、利用可能なすべてのメトリックを監視します。
• host_stat: 仮想マシンサーバ (Nutanix ノード) を監視するためのモジュールを追加するためのルール。デフォルトでは hypervisor_cpu_usage_ppm|hypervisor_memory_usage_ppm|.*avg.*。これは、メトリクス名が次の正規表現に一致する場合に生成される特別なモジュールを示します。 値 .* を設定すると、利用可能なすべてのメトリックを監視します。
• pd_stat: 保護ドメインを監視するためのモジュールを追加するためのルール。デフォルトでは replication_transmitted_bandwidth_kBps|replication_total_transmitted_bytes です。これは、メトリック名がこのフィールドに示されている正規表現と一致する場合に生成される特別なモジュールを示します。 値 .* を設定すると、利用可能なすべてのメトリックを監視します。

エンティティの名前変更

Renaming of entities

エンティティの名前変更

• RENAME aaa TO bbb: Rule for renaming entities, you can define as many directives as elements you need to rename.

• RENAME aaa TO bbb: エンティティの名前変更のルール。名前を変更する必要がある要素と同じ数のディレクティブを定義できます。

Exclusion of entities

エンティティの実行

• REJECT aaa: Rule for excluding entities from monitoring, you can define as many directives as elements you need to exclude.

• REJECT aaa: エンティティ監視を除外するためのルール。除外する必要がある要素と同じ数のポリシーを定義できます。

agent_interval

プラグインで生成されるエージェントの間隔(デフォルトは 300)

agent_group

生成されるエージェントが所属するグループ(Pandora サーバの設定で 'autocreate_group' が無効化されている場合) デフォルトは、Nutanix です。

module_interval

生成されたエージェントのモジュールの間隔(倍率指定で、デフォルトは 1)

module_tags

生成されたエージェントの新規モジュールに関連付けるタグ

module_group

新たなモジュールが所属するグループ

It is recommended to run the plugin remotely from a computer with access to both the Pandora FMS server and your Nutanix® infrastructure to be monitored.

プラグインを実行するサーバは、監視のために Pandora FMS サーバおよび Nutanix® インフラストラクチャの両方にアクセスできる必要があります。

Manual execution:

手動実行:

./pandora_nutanix-linux-x64 pandora_nutanix.conf

You can automate the plugin execution in the system cron by adding the following line to /etc/crontab.

/etc/crontab に以下の設定を追加することにより、cron でプラグインを自動実行できます。

/5 * * * * root /path/to/plugin/pandora_nutanix-linux-x64 /path/to/plugin/pandora_nutanix.conf

See the use of DISCO Package for XenServer in Discovery PFMS.

XenServer 用の DISCO パッケージの使用方法については、PFMS 自動検出 を参照してください。

The Pandora FMS plugin for monitoring OpenNebula environments is written in Perl. It runs locally on the OpenNebula server and will retrieve all necessary information using OpenNebula's own management commands. It allows the monitoring of the following types of elements:

OpenNebula 環境を監視するための Pandora FMS プラグインは Perl で書かれています。OpenNebula サーバのローカルで実行し、OpenNebula 自身の管理コマンドを使って必要な情報を取得します。

• clusters.
• hosts.
• Virtual machines.
• Storage resources.

• クラスタ
• ホスト
• 仮想マシン
• ストレージリソース

It is essential that the system executing the plugin has the following requirements:

プラグインの実行には以下が必要です。

• Perl available on the equipment
• User with privileges to execute the following commands:

• Perl のインストール
• 以下のコマンドの実行権限

1. onehost.
2. onecluster.
3. onedatastore.

Download your copy of the Pandora FMS plugin for OpenNebula from the module library. You must extract the file content into a non-volatile directory from where you can execute it, either using the Pandora FMS agent or the system cron.

OpenNebula 用の Pandora FMS プラグインを モジュールライブラリ からダウンロードしてください。ダウンロードしたファイルの内容を、Pandora FMS エージェントまたはシステムの cron を使用して実行できる、永続的なディレクトリに展開する必要があります。

unzip pandora_OpenNebula.zip

• mode: Data transfer mode, “local” or “tentacle”.
• tentacle_ip: IP address of the Pandora FMS server, only applicable in tentacle mode.
• tentacle_port: Port on which the Tentacle service is listening.
• tentacle_opts: Any extra options you have configured in your Tentacle service.
• tentacle_client: Full path to your Tentacle client.
• temp: Temporary working directory.
• local_folder: Delivery path for “local” data transfer mode.

• mode: データ転送モード。“local” または “tentacle” です。
• tentacle_ip: Pandora サーバの IP アドレス。tentacle モードの場合のみ。
• tentacle_port: Tentacle サーバのポート番号
• tentacle_opts: Tentacle の追加オプション
• tentacle_client: Tentacle クライアントのパス
• temp: テンポラリディレクトリ
• local_folder: データ転送モードが “local” の場合のパス

• agent_interval: Agent interval, default 300.
• agent_group: Agent group, by default OpenNebula.

• agent_interval: エージェント間隔。デフォルトは 300。
• agent_group: エージェントグループ。デフォルトは OpenNebula。

• MODULE_GROUP: Group of modules, by default OpenNebula.
• MODULE_INTERVAL: Module interval (multiplier), default 1.
• MODULE_TAGS: Tags for the Modules.

• module_group: モジュールグループ。デフォルトは、OpenNebula。
• module_interval: モジュール間隔(倍率)。デフォルトは 1
• module_tags: モジュールのタグ

• cluster_agent_header: Header for the name of the cluster device agent.
• host_agent_header: Header for the name of the Virtual Machine Server type Device Agent.
• storage_agent_header: Header for the name of the Storage Device type Device Agent.
• vm_agent_header: Header for the name of the virtual machine type Device Agent.

• cluster_agent_header: クラスタタイプデバイスエージェントのエージェント名ヘッダ
• host_agent_header: 仮想マシンサーバタイプデバイスエージェントのエージェント名ヘッダ
• storage_agent_header: ストレージデバイスタイプエージェントのエージェント名ヘッダ
• vm_agent_header: 仮想マシンタイプデバイスエージェントのエージェント名ヘッダ

• cluster_monitoring: Enable (1) or not (0) cluster monitoring.
• host_monitoring: Enable (1) or not (0) monitoring of virtual machine servers.
• storage_monitoring: Enable (1) or not (0) storage device monitoring.
• vm_monitoring: Enable (1) or not (0) virtual machine monitoring.

• cluster_monitoring: クラスタ監視の有効化(1)または無効化(0)
• host_monitoring: 仮想マシンサーバ監視の有効化(1)または無効化(0)
• storage_monitoring: ストレージデバイス監視の有効化(1)または無効化(0)
• vm_monitoring: 仮想マシン監視の有効化(1)または無効化(0)

RENAME aaa TO bbb: Rule for renaming entities, you can define as many directives as elements you need to rename.

RENAME aaa TO bbb: エンティティのリネームルールで、必要なだけ定義することができます。

REJECT aaa

Rule for excluding entity monitoring, you can define as many policies as elements you need to exclude.

REJECT aaa

監視対象外エンティティのルールで、必要なだけ定義することができます。

To schedule it through the system cron you can add the following line to /etc/crontab:

システム cron で設定するには、次の行を /etc/crontab へ追加します。

/5 * * * * root "<path>/pandora_opennebula" "<path>/pandora_opennebula.conf"> /dev/null 2>&1

プラグインを手動実行すると、出力は次のようになります。

 [root@valhalla ~]# ./pandora_opennebula pandora_opennebula.conf
 [root@valhalla ~]# echo $?
 0

This plugin allows you to monitor IBM AIX virtualization machines through the HMC hardware management console. This plugin will collect information from all logical partitions created in an AIX environment managed by an HMC system, creating an Agent for each managed server, each logical partition and each virtual IO server.

このプラグインは、HMC ハードウエア管理コンソールを通して IBM AIX 仮想環境を監視できます。 このプラグインは、HMC システムによって AIX 環境に作成されたすべての論理パーティションから情報を収集します。各管理サーバ、論理パーティション、仮想 IO サーバごとに一つのエージェントを作成します。

SSH で情報を収集するために、プラグインは以下の 3つのモードを使えます。

1. スクリプト ssh_launcher.sh の利用をもとにしたもの
2. Net::SSH::Perl ライブラリをもとにしたもの
3. Net::SSH::Expect ライブラリをもとにしたもの

To complement the information captured, queries will also be made against the REST API, by default in:

キャプチャされた情報を補完するために、REST API に対してもクエリが実行されます。デフォルトは以下の通りです。

https://fqdn:12443/rest/api/{root_element}

The necessary parameters that the area requiring monitoring services must provide are:

監視に必要なパラメータは次の通りです。

• Username to authenticate on the HMC system (read-only).
• The user must have permission to connect to the REST API and to log into the HMC shell and execute the following commands (at minimum):

• HMC システムの認証に必要なユーザ名(読み出し専用)
• ユーザは REST API への接続権限および、HMC シェルへログインし(少なくとも)次のコマンドを実行する権限が必要です。

1. lssyscfg.
2. lshwres.

• Password of said user.
• Location (FQDN/IP) of the HMC (such as myhmc.mydomain).
• HMC REST API base URL, similar to:

• ユーザのパスワード
• HMC の場所(FQDN/IP) (myhmc.mydomain など)
• HMC REST API のベース URL、例:

https://myhmc.mydomain:12443

The parameters monitored by the plugin are (grouped by element type):

プラグインによって監視されるパラメータは次の通りです。(エレメントタイプでグループ化されます)

• Current logical partitions.
• Max logical partitions.
• Max memory available.
• Max memory installed.
• Proc pool DefaultPool current proc units.
• Proc pool DefaultPool max proc units.
• Proc pool DevelopmentPool current proc units.
• Proc pool DevelopmentPool max proc units.
• Proc pool ProductionPool current proc units.
• Proc pool ProductionPool max proc units.
• Proc pool TestPool current proc units.
• Proc pool TestPool max proc units.
• Proc pool VIOPool current proc units.
• Proc pool VIOPool max proc units.
• Processor pools configured.
• Processor units available.
• Processor units installed.
• State.
• UUID.
• Virtual proc units max.

LPAR:

• Auto start: Auto-start logical partition configuration.
• LPAR type: Logical partition type.
• LPAR UUID: Used to query HMC APIs.
• Max memory: Maximum memory.
• Max memory: Available memory.
• Processor units available: Available processing units.
• Processor units current: Installed processing units.
• RMC IP address: RMC IP address.
• RMC state: RMC status on LPAR.
• State: Logical partition status.
• Virtual proc units: Virtual processing units assigned to this LPAR.

• Auto start: 自動起動設定の論理パーティション
• LPAR type: 論理パーティションタイプ
• LPAR UUID: HMC API を照会するために使用されます
• Max memory: 最大メモリ
• Max memory: 空きメモリ
• Processor units available: 未使用プロセッサユニット
• Processor units current: 搭載プロセッサユニット
• RMC IP address: RMC IP アドレス
• RMC state: LPAR の RMC の状態
• State: 論理パーティションの状態
• Virtual proc units: この LPAR に割り当てられた仮想プロセッサユニット

Virtual IO:

• Auto start: Auto-start logical partition configuration.
• LPAR type: Logical partition type.
• LPAR UUID: Used to query HMC APIs.
• Max memory: Maximum memory.
• Max memory current: Available memory.
• Processor units available.: Available processing units
• Processor units current: Installed processing units.
• RMC IP address: RMC IP address.
• RMC state RMC: RMC status on LPAR.
• State: Logical partition status.
• Virtual proc units: Virtual processing units assigned to this LPAR.

• Auto start: 自動起動設定の論理パーティション
• LPAR type: 論理パーティションタイプ
• LPAR UUID: HMC API を照会するために使用されます
• Max memory: 最大メモリ
• Max memory current: 未使用メモリ
• Processor units available: 未使用プロセッサユニット
• Processor units current: 搭載プロセッサユニット
• RMC IP address: RMC IP アドレス
• RMC state: LPAR の RMC の状態
• State: 論理パーティションの状態
• Virtual proc units: この LPAR へ割り当てられている仮想プロセッサユニット

• mode: Data transfer mode, “local” or “tentacle”.
• tentacle_ip: IP address of the Pandora FMS server, only applicable in tentacle mode.
• tentacle_port: Port on which the tentacle service is listening.
• tentacle_opts: Any extra options you have configured in the tentacle service.
• tentacle_client: Full path to your tentacle client.
• temp: Temporary working directory.
• local_folder: Delivery path for “local” data transfer mode.

• mode: データ転送モード。“local” または “tentacle”
• tentacle_ip: Pandora サーバの IP アドレス。tentacle モードの場合のみ利用。
• tentacle_port: Tentacle サーバのポート
• tentacle_opts: Tentacle の追加パラメータ
• tentacle_client: Tentacle クライアントのパス
• temp: テンポラリディレクトリ
• local_folder: データ転送モードが “local” の場合のパス

• hmc_host: IP or FQDN of the HMC.
• hmc_user: User with read permission.
• hmc_pass: Password.
• as_agent_plugin: The output of the plugin will be returned in XML format for executions scheduled with the Pandora FMS Agent ( as_agent_plugin = 1 ). Or standard output ( as_agent_plugin = 0 ) for executions scheduled with the system cron or performed as a server plugin.

• hmc_host: HMC の IP または FQDN
• hmc_user: 読み出し権限のユーザ
• hmc_pass: パスワード
• as_agent_plugin: Pandora FMS エージェントで実行する場合(as_agent_plugin = 1)、プラグインの出力は XML フォーマットで返されます。システムの cron で実行するかまたは、サーバプラグインとして実行する場合(as_agent_plugin = 0)は、標準出力に状態が返されます。

• agent_name: Optional, indicate a name for the parent Agent, by default `hostname`
• agent_interval: Agent interval, default 300 seconds.
• agent_group: Agent Group, by IBM default.

• agent_name: オプション。親エージェントの名前を設定します。デフォルトは 'hostname' です。
• agent_interval: エージェントの間隔。デフォルトは 300。
• agent_group: エージェントグループ。デフォルトは IBM。

• module_group: Group of Modules, by IBM default.
• module_interval: Module interval (multiplier), default 1.
• module_tags: Tags for the modules.

• module_group: モジュールグループ。デフォルトは IBM。
• module_interval: モジュールの間隔(倍率)。デフォルトは 1。
• module_tags: モジュールのタグ

To rename entities, block renaming is used:

エンティティのリネームには、rename というブロックを使います。

rename
 MyLPAR_NAME TO my new name
 MyLPAR_NAME2 TO my second new name
 rename_end

The Pandora FMS plugin for monitoring IBM AIX systems through HMC is deployed as follows:

IBM AIX システムを HMC を通して監視するための Pandora プラグインは次のように展開しますｊ。

Setting the as_agent_plugin parameter to 1 (running as agent plugin):

as_agent_plugin パラメータを 1 に設定した場合(エージェントプラグインとしての実行):

module_plugin /usr/bin/perl pandora_hmc.pl pandora_hmc.conf

Setting the as_agent_plugin parameter to 0 (running as server plugin):

as_agent_plugin パラメータを 0 に設定した場合(サーバプラグインとしての実行):

# /etc/crontab
*/5 * * * * root /usr/bin/perl /root/hmc/pandora_hmc.pl /root/vmware/pandora_hmc.conf

This plugin allows you to monitor HPVM virtualization equipment. It is launched as an Agent plugin, generating in parallel one more agent for each hosted virtualized computerin the monitored system.

このプラグインは、HPVM 仮想化サーバを監視できます。エージェントプラグインとして起動し、監視対象システム内に起動している各仮想マシンごとに、エージェントを生成します。

Local commands are used to collect information.

情報を収集するためにローカルコマンドを利用します。

1. 監視対象のいコンピュータへの Pandora FMS エージェントのインストール
2. プラグインの実行権限を持ったユーザ
3. ユーザは、以下のように hpvvmstatus コマンドを実行する権限が必要です
   1. hpvmstatus
   2. hpvmstatus -X
   3. hpvmstatus -r -X

Download a copy of the Pandora FMS plugin for HPVM HP Virtualization Manager monitoring from the module library. You can schedule the execution using collections and the deployed Pandora FMS Agent or extract the contents of the file to a non-volatile directory from where you can execute it through your system's cron.

Pandora FMS プラグインは、モジュールライブラリ からダウンロードします。コレクションとデプロイされた Pandora FMS エージェントを使用して実行をスケジュールしたり、ファイルの内容を不揮発性ディレクトリに抽出して、そこからシステムの cron を通じて実行したりできます。

unzip pandora_HPVM.zip

• mode: Data transfer mode, “local” or “tentacle”.
• tentacle_ip: IP address of the Pandora FMS server, only applicable in tentacle mode.
• tentacle_port: Port on which the Tentacle service is listening.
• tentacle_opts: Any extra options you have configured in your Tentacle service.
• tentacle_client: Full path to your Tentacle client.
• temp: Temporary working directory.
• local_folder: Delivery path for “local” data transfer mode.

• mode: データ転送モード。“local” または “tentacle”
• tentacle_ip: Pandora サーバの IP アドレス。データ転送モードが tentacle の場合のみ。
• tentacle_port: Tentacle サーバのポート
• tentacle_opts: Tentacle の拡張オプション
• tentacle_client: Tentacle クライアントのパス
• temp: テンポラリディレクトリ
• local_folder: データ転送モードが “local” の場合のパス

• agent_name: Optional, indicate a name for the parent Agent, by default hostname
• agent_interval: Agent interval, default 300.
• agent_group: Group to which the agents will belong, by default HPVM.

• agent_name: オプション。エージェント名を設定します。デフォルトは 'hostname' です。
• agent_interval: エージェント間隔。デフォルトは 300。
• agent_group: エージェントグループ。デフォルトは HPVM。

• module_group: Module Group.
• module_interval: Module interval (multiplier), default 1.
• module_tags: Tags for the Modules.

• module_group: モジュールグループ。
• module_interval: モジュールの間隔(倍率)。デフォルトは 1。
• module_tags: モジュールのタグ

Pandora FMS エージェントからのプラグイン実行では、エージェント設定ファイルに次の設定をします。

module_plugin /usr/bin/perl pandora_hpvm.pl pandora_hpvm.conf

手動でテストをするには、プラグインを設定し次のように起動します。

perl pandora_hpvm.pl pandora_hpvm.conf

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

EC2 環境を監視するには、こちらを参照してください。

ここでは、Amazon EC2 のインスタンスをモニタリングするために CloudWatch API を利用します。インスタンスにおいて、cloudwatch を有効にする必要があります。pandorafms.com のモジュールライブラリに、フリーのプラグインがあります。(EC2 で検索)

このリモートサーバプラグインの基本的な考え方は、ネットワークプラグインサーバを使ってインスタンスから情報を取得するものです。つまり、サーバにプラグインを登録し、EC2 サーバの情報を異なるモジュールとして取得します。

以下に実行例を示します。\ で改行しています。

 /home/slerena/ec2_plugin.sh \
          -A AKIAILTVCAS26GTKLD4A \
          -S CgmQ6DxUWES05txju+alJLoM57acDudHogkLotWk \
          -i i_9d0b4af1 \
          -n AWS/EC2 \
          -m CPUUtilization

これは、インスタンス i-9d0b4af1 において、“CPUUtilization” の値を返します。

インストールは次のようにします。

1. JAVA が動作するようにし、JAVA のホームディレクトリを設定します。Pandora FMS アプライアンス(Vmwareイメージ)では、/usr/ です。
2. プラグインを上記ディレクトリにコピーし、パーミッションを 755 にします。また、プラグインの最初の行に定義されている AWS_CLOUDWATCH_HOME 変数を設定します。プラグインの最初の行を編集する必要があります。

プラグインには、いくつかのファイルがあります。

/ec2_plugin.sh - プラグイン本体です。 /bin/* - Amazon CloudWatch (モニタリング) コマンドラインツールのコンポーネントで、プラグインの配布ファイルに含まれています。このスクリプトは、Apache ライセンスに基づいて配布されています。

全てのファイルをサーバに展開します。例えば以下の場所です。

/usr/share/pandora_server/plugin/ec2

そして、AWS_CLOUDWATCH_HOME を /usr/share/pandora_server/plugin/ec2 に設定します。

正しくインストールできたか確認するには、以下のコマンドを実行します。

/usr/share/pandora_server/plugin/ec2/mon-cmd --version

以下のように表示されます。

Amazon CloudWatch CLI version 1.0.9.5 (API 2010-08-01)

同様に表示されれば、プラグインは利用可能です。

そうでなければ、おそらく、Amazon CloudWatch (モニタリング) コマンドラインツールのインストールと設定が必要です。以下のステップを実行してください。

手順:

1. システムに、JAVA のバージョン 1.5 もしくはそれ以上がインストールされている必要があります。(java -version)
2. zip ファイルを展開します。
3. 以下の環境変数を設定します。
   1. 'AWS_CLOUDWATCH_HOME': ファイルを展開したディレクトリです。確認は以下のようにします。

Unix: ls ${AWS_CLOUDWATCH_HOME}/bin で、mon-list-metrics ... が表示されます。)
  Windows: dir %AWS_CLOUDWATCH_HOME%\bin で、mon-list-metrics ... が表示されます。)

1. JAVA_HOME - Java をインストールしたホームディレクトリです。
2. パスを追加します。

'${AWS_CLOUDWATCH_HOME}/bin' (Windows の場合は '%AWS_CLOUDWATCH_HOME%\bin')

AWS ユーザ権限でコマンドラインツールを利用できるようにします。権限を与えるには 2つの方法があります。

1. AWS パスワードの利用
2. X.509 証明書の利用

Specify credentials in the command line:

コマンドラインで認証情報を指定します。

-I ACCESS_KEY --S SECRET_KEY

You may also reate a credentials file. The deployment includes a template file:

認証ファイルを作成することもできます。デプロイした環境にはテンプレートファイルが含まれています。

${AWS_CLOUDWATCH_HOME}/credential-file-path.template.

Edit a copy of this file to add the appropriate information. In UNIX, limit permissions for the owner of the credentials file(credential-file):

このファイルのコピーを編集し、適切な情報を追加します。UNIX では、認証ファイル(作成した認証ファイル) の所有者の権限を制限します。

$ chmod 600 <作成した認証ファイル>

Once the file is created, there are several ways to reference it:

ファイルを作成したら、それを参照するいくつかの方法があります。

• 次の環境変数を設定します。

export AWS_CREDENTIAL_FILE =<作成した認証ファイル>

• それぞれのコマンド実行に次のようなオプションを設定します。

1. -aws-credential-file <作成した認証ファイル>

公開鍵と秘密鍵をファイルに保存します。例えば、my-cert.pem および my-pk.pem

コマンドラインツールに認証情報を提供するには 2種類の方法があります。

• 次の環境変数を設定します。

 EC2_CERT =/path/to/cert/file
 EC2_PRIVATE_KEY =/path/to/key/file

• 各コマンドのコマンドラインでファイルを指定します。

 <command> \
      --ec2-cert-file-path=/path/to/cert/file \
      --ec2-private-key-file-path=/path/to/key/file

環境変数 SERVICE_JVM_ARGS を設定することにより、コマンドラインに任意の JVM プロパティを渡すことができます。

例えば、以下では Linux/UNIX においてプロキシサーバのプロパティを設定します。

export SERVICE_JVM_ARGS="-D http.proxyHost=http://my.proxy.com -Dhttp.proxyPort=8080"

設定が正しくできたか確認するために、次のコマンドを実行します。

 $ mon-cmd --help

全てのモニタリングコマンドで利用方法を表示します。

 $ mon-list-metrics --headers

ヘッダーが表示されます。何らかの特別な定義をしていたなら、それも確認してください。

IT アーキテクチャにとって仮想環境はとても重要です。そのため、これらの環境を監視することは、あなたの会社のシステムの適切なパフォーマンスを確認するために必要です。Pandora FMS Enterprise では VMware Monitoring Plugin を利用でき、VMware アーキテクチャを簡単に操作することができます。

このシステムでは、以下のようなアーキテクチャを監視することができます。

Pandora FMS は、VCenter、ESXi サーバ、データストアおよび、データストアや仮想マシンといった仮想化コンポーネントを監視できます。Pandora FMS は、データ収集のために VMware Perl SDK が提供する API を利用します。

自動検出を通して VMware インフラストラクチャの監視については、こちら を参照してください。

VMware プラグインが適切に機能するための要件は次の通りです。

• Pandora FMS v7.0NG.732 またはそれ以上
• Perl 用の VMware vSphere SDK

VMware の自動検出アプリケーションは、VMware vCenter および ESXi API が提供する機能を用います。これらが使用可能かどうかは、情報収集用に設定されているレベルによって異なります。

これらのレベルは、Statistics オプションの vCenter Server Settings メニューにて変更できます。vCenter で、それぞれの時間オプションとレベルで、どのカウンタを収集するかを参照することができます。Pandora FMS モニタリングプラグインが利用する最低レベルは Level 2 です。

vCenter の設定によっては、いくつかのモジュールは、Pandora FMS へデータを送信しません。 これは、vCenter でいくつかのプラグインが不足している場合です。これは、エンティティに VMware エージェントをインストールする必要があるか、単にエンティティがオフになっているためです(仮想マシンまたは ESXi)。これらの問題を解決するには、VMware のドキュメントを確認してください。

ハードウエアの状態監視などでは、vCenter および ESX をサポートするホストの高度な設定が必要になる場合があります。

From Pandora FMS version 732 onwards, VMware® monitoring is done using the Discovery Applications system (more information in Discovery.)

Pandora FMS バージョン 732 以降では、VMware の監視は、自動検出アプリケーション システムを用いて行われます。(より詳細は、こちら を参照してください。)

いくつかの理由によりこの機能の外で手動でプラグインを設定したい場合は、以下に説明する旧手法を使うことができます。

If you need to deploy or update your version of the VMware® plugin to a more recent one, follow the steps described in the following points:

VMware プラグインをインストールしたり最新のバージョンにアップデートする場合は、以下に示す手順に従ってください。

1. VMware プラグインを展開したファイルがあるディレクトリへ行きます。

2. vmware-plugin.{pl,conf} を対応するディレクトリににコピーします。

 sudo cp vmware-plugin.pl vmware-plugin.conf /usr/share/pandora_server/util/plugin/
 sudo chown pandora:apache /usr/share/pandora_server/util/plugin/vmware-plugin.{pl,conf}
 sudo chmod g w /usr/share/pandora_server/util/plugin/vmware-plugin.conf

3. プラグインを設定するために必要なデータを確認します。

Pandora FMS コンソールの “設定(Configuration)” メニューで、API パスワードを設定します。

4. 設定ファイル vmware-plugin.conf を編集します。

5. VMware SDK for Perl が使えるかどうかを確認します。

VMware SDK Perl のインストールを確認するには、以下のスクリプトを実行します。

#!/usr/bin/perl

use strict;
use warnings;

use VMware::VIRuntime;

print "VMware SDK Version: " . $VMware::VIRuntime::VERSION . "\n";

スクリプトの実行:

perl check_vmware.pl

出力結果は次のようになります。

VMware SDK Version: 6.5.0

The link for the download center of the required VMware softare is:

必要な VMware ソフトウェアのダウンロードセンターへのリンクは次の通りです。

https://my.vmware.com/web/vmware/details?downloadGroup=VS-PERL-SDK65&productId=614

最初に、次のコマンドで SDK パッケージを展開します。

# tar -xzvf VMware-vSphere-Perl-SDK-x.x.x-xxxxxx.i386.tar.gz

次に、次のコマンドで SDK をコンパイルおよびインストールします。

 # perl Makefile.PL
 # make
 # make install

SDK のインストールが成功しエラーが表示されなければ、次のコマンドで vCenter に接続することができます。

# /usr/lib/vmware-viperl/apps/general/connect.pl --server <vcenter_ip> --username <vcenter_user> --password <vcenter_pass>

コマンドの実行結果は次のようになります。

 Connection Successful
 Server Time : 2013-02-21T16:24:05.213672Z

SDK の旧バージョンから 6.5 へのアップグレード

If you are upgrading the VMware SDK, follow these steps:

VMware SDK をアップグレードするには、次のステップを行います。

• Install the tools for developers:

• 開発者ツールのインストール

yum groupinstall "Developer Tools"

• Install CPAN:

• CPAN のインストール

yum install perl-CPAN

• Install some dependencies:

• 依存ファイルのインストール

 yum install openssl-devel perl-Class-MethodMaker
 yum install epel-release

• Unzip the installation files of VMware® SDK Perl:

• VMware® SDK Perl のインストールファイルを展開

tar xvzf VMware-vSphere-Perl-SDK-6.5.0-4566394.x86_64.tar.gz

• Access the directory:

• ディレクトリへアクセス

cd vmware-vsphere-cli-distrib

• Launch the installer:

• インストーラを起動

./vmware-install.pl

インストール中:

• Accept the licence.
• Indicate not to use the prebuilt modules for VMware® SDK.
• Accept module automatic installation through the CPAN automated system.
• Verify that all the requirements have been installed correctly.
• Indicate the directory where the VMware® SDK Perl modules should be installed.

• ライセンスを承諾
• not to use the prebuilt modules for VMware SDK が表示される
• CPAN 経由でのモジュールの自動インストールを承諾
• すべての必要ファイルが正しくインストールされたか確認
• VMware SDK Perl モジュールがインストールされるディレクトリを表示

• Install the necessary dependencies for UUID-0.03:

• UUID-0.03 に必要な依存ファイルをインストール

yum install libuuid-devel perl-JSON-PP

• Download the code package:

• コードパッケージをダウンロード

wget https://cpan.metacpan.org/authors/id/C/CF/CFABER/UUID-0.03.tar.gz

• Unzip the file and access the directory:

• ファイルを展開してディレクトリへ移動

 tar xvzf UUID-0.03.tar.gz
 cd UUID-0.03

• Generate the necessary files for compiling with the Perl module:

• Perl モジュールのコンパイルに必要なファイルの生成

perl Makefile.PL

• Compile the Perl module:

• Perl モジュールをコンパイル

make

• You should receive a response similar to:

• 次のような応答を確認

Manifying blib/man3/UUID.3pm

• Install the new compiled module:

• コンパイルしたモジュールのインストール

make install

Once the pending modules are installed, run the VMware® SDK Perl installation process again.

モジュールをインストールしたら、VMware® SDK Perl のインストール処理を実行します。

./vmware-install.pl

Carry out these steps manually:

以下を手動で実施します。

• Clean old libraries.

• 古いライブラリを削除

 rm -rf /usr/share/perl5/vendor_perl/VMware
 rm -rf /usr/share/perl5/VMware

• Add new VMware® libraries.

• 新しい VMware® ライブラリを追加

cp -R /usr/lib/vmware-vcli/VMware/share/VMware /usr/share/perl5/vendor_perl/

Once done, launch a script with the following content to validate your VMware® SDK Perl installation

完了したら、VMware® SDK Perl のインストールを確認するために、次の内容のスクリプトを実行します。

 #!/usr/bin/perl

 use strict;
 use warnings;

 use VMware::VIRuntime;

 print "VMware SDK Version: " . $VMware::VIRuntime::VERSION . "\n";

Execute the script:

スクリプトの実行:

perl check_vmware.pl

The output must be as follows:

出力は次のようになります。

VMware SDK Version: 6.5.0

If the output is different, verify that you followed all steps correctly or contact support at https://support.pandorafms.com/integria/ :

出力結果が異なる場合は、すべてのステップを正しく実行したか確認してください。

The SDK dependencies for CentOS 7 are:

CentOS 7 の SDK の依存ファイルは次の通りです。

 gdbm-devel
 glibc-devel
 glibc-headers
 kernel-headers
 libdb-devel
 libuuid-devel
 make
 openssl
 perl-Business-ISBN
 perl-Business-ISBN-Data
 perl-Class-Inspector
 perl-Class-MethodMaker
 perl-Convert-BinHex
 perl-Crypt-SSLeay
 perl-Digest
 perl-Digest-MD5
 perl-Email-Date-Format
 perl-Encode-Locale
 perl-ExtUtils-Install
 perl-ExtUtils-MakeMaker
 perl-ExtUtils-Manifest
 perl-ExtUtils-ParseXS
 perl-File-Listing
 perl-HTML-Parser
 perl-HTML-Tagset
 perl-HTTP-Cookies
 perl-HTTP-Daemon
 perl-HTTP-Date
 perl-HTTP-Message
 perl-HTTP-Negotiate
 perl-IO-HTML
 perl-IO-SessionData
 perl-IO-Socket-IP
 perl-IO-Socket-SSL
 perl-JSON-PP
 perl-LWP-MediaTypes
 perl-LWP-Protocol-https
 perl-MIME-Lite
 perl-MIME-Types
 perl-MIME-tools
 perl-MailTools
 perl-Mozilla-CA
 perl-Net-HTTP
 perl-Net-LibIDN
 perl-Net-SMTP-SSL
 perl-Net-SSLeay
 perl-SOAP-Lite
 perl-Test-Harness
 perl-TimeDate
 perl-URI
 perl-WWW-RobotRules
 perl-XML-LibXML
 perl-XML-NamespaceSupport
 perl-XML-Parser
 perl-XML-SAX
 perl-XML-SAX-Base
 perl-devel
 perl-libwww-perl
 pyparsing
 systemtap-sdt-devel
 glibc
 glibc-common
 libblkid
 libmount
 libsmartcols
 libuuid
 util-linux

You can install the extra dependencies for plugin with the following command:

以下のコマンドで、プラグイン用の追加の依存ファイル をインストールできます。

yum install perl-Archive-Zip perl-JSON

You can install the password encryption dependencies with the following command:

以下のコマンドで、パスワード暗号化の依存ファイル をインストールできます。

yum install openssl-devel perl-Crypt-CBC perl-Digest-SHA

You can download the custom RMPs of perl-Crypt-OpenSSL-AES from the Artica repository:

Artica のリポジトリから、perl-Crypt-OpenSSL-AES のカスタム RPM をダウンロードできます。

• CentOS 7:

yum install https://sourceforge.net/projects/pandora/files/Tools%20and%20dependencies%20%28All%20versions%29/RPM%20CentOS%2C%20RHEL/perl-Crypt-OpenSSL-AES-0.02-1.el7.x86_64.rpm

Install the dependencies:

依存ファイルのインストール:

apt update
apt-get install -y lib32z1 build-essential uuid \
  uuid-dev libssl-dev perl-doc libxml-libxml-perl \
  libcrypt-ssleay-perl libsoap-lite-perl libmodule-build-perl

Download from our repository:

我々のリポジトリからのダウンロード:

wget https://firefly.artica.es/pandorafms/utils/VMware-vSphere-Perl-SDK-7.0.0-16453907.x86_64.tar.gz

Unzip and install:

展開とインストール:

tar xvzf VMware-vSphere-Perl-SDK-7.0.0-16453907.x86_64.tar.gz
cd vmware-vsphere-cli-distrib/
sed --follow-symlinks -i -e "s/[^#].*show_EULA().*/  #show_EULA();/g" vmware-install.pl
./vmware-install.pl --default
cpan Crypt::OpenSSL::AES

vSphare SDK と共に提供される Perl のバージョンでは、VMware の perl ライブラリが動作しません。問題に対処するためには次の手順を実施します。

• VMware vSphere SDK をインストール
• Strawberry PERL version 5.12. をインストール
• 'C:\Program Files\VMware\VMware vSphere CLI\Perl\lib\VMware' を 'C:\strawberry\perl\lib' へコピー
• VMware vSphere SDK をアンインストール

VMware プラグインは手動で設定することも、ダウンロード可能な VMware プラグインファイルと共に利用可能なコンソール拡張機能を使用して設定することもできます。

VMware プラグインの複数の設定を管理するには、Pandora FMS コンソールの拡張を使用することをお勧めします。

手動で設定ファイルを編集することができます。'#' で始まる行はコメントです。

The VMware® plugin detects all entities and adds the checks by default. You may configure monitoring and choose the variables you need to monitor from the configuration file.

VMware® プラグインは、デフォルトですべてのエンティティを検出し監視を追加します。 設定ファイルから監視する必要がある変数を選択できます。

The configuration file contains all the information needed for monitoring, grouped in the following sections: Configuration, Rename, Reject, Datacenter, Datastore, ESX and VM .

設定ファイルには、監視に必要なすべての情報が含まれており、次のセクションにグループ化されています: Configuration, Rename, Reject, Datacenter, Datastore, ESX および VM

The monitoring plugin configuration file in VMware® environments contains the following general elements:

VMware® 環境の監視プラグイン設定ファイルには、次の一般的な要素が含まれています。

server

監視した VMware サーバの FQDN または IP。

user

User with read permissions in vCenter®.

vCenter® で読み出し権限のあるユーザ。

pass

ユーザのパスワード。

datacenter

Datacenter 名。 (デフォルト: ha-datacenter)

temporal

テンポラリディレクトリ。デフォルト: /tmp

logfile

ログファイル。デフォルト: /tmp/vmware_plugin.log

entities_list

監視するエンティティファイル。デフォルト: /tmp/vmware_entitites_list.txt

transfer_mode

XML を Pandora へ転送するモード。デフォルト: local

tentacle_ip

Pandora FMS サーバアドレス。デフォルト: 127.0.0.1

tentacle_port

tentacle ポート。デフォルト: 41121

tentacle_opts

tentacle の追加オプション。

local_folder

XML をローカル転送する場合の保存先フォルダ: /var/spool/pandora/data_in

pandora_url

Web address of the Pandora FMS console, by default:

Pandora FMS コンソールの Web アドレス。デフォルト:

http://127.0.0.1/pandora_console

api_pass

Pandora FMS コンソールの API パスワード。

api_user

Pandora FMS API へアクセスするユーザ。

api_user_pass

API アクセスするユーザのパスワード

retry_send

XML 送信エラー時にリトライする(1) しない(0) の設定。(buffer_xml に似ています)

event_mode

VMware イベント情報をリカバーする(1) しない(0) の設定。

event_pointer_file

VMware イベントの補助インデックスファイル。デフォルト: /tmp/vmware_events_pointer.txt

Virtual network monitoring

仮想スイッチの監視を含める。

Encrypt passwords

Use encrypted passwords with this command:

以下のコマンドで暗号化パスワードを生成します:

perl vmware-plugin.pl --generate_password

Add to the pass token the password generated in the configuration file:

生成されたパスワードを設定ファイル内のパストークンに追加します:

use_encrypted_password 1

verbosity

デバッグレベル。(1 をお勧めします)

threads

利用する最大スレッド数。(4 をお勧めします)

interval

エージェントおよびモジュールを生成する秒間隔。(プラグインの実行頻度に応じて調整します)

Recon Interval

一時エンティティキャッシュファイルが自動削除されたのち、VMware インフラストラクチャが再スキャンされるまでの秒間隔。

group

プラグインにより生成されたエージェントのサーバグループ。

virtual_network_monitoring

仮想スイッチ監視を有効化(1) または、無効化(0) する設定。

use_ds_alias_as_name

データストアエージェントで、別名をエージェント名として利用する(1) または、しない(0) 設定。

サーバ、データセンター、ユーザ、パス、間隔は、Pandora コンソールから調整できます。

The “Reject” section of the VMware® environment monitoring plugin contains the following option:

VMware® 環境監視プラグインの “Reject” セクションには次のオプションを含んでいます。

• all_ipaddresses

If this instruction is present, the IP address in the XML will not be updated. This instruction is also valid for tasks.

この設定が存在する場合、XML の IPアドレスは更新されません。この設定はタスクにも有効です。

An example of this section in the configuration file could be the following:

設定ファイルのこのセクションの例を以下に示します。

 Configuration
 server 192.168.70.249
 user Administrator
 pass S1stemas
 datacenter artica
 temporal /tmp
 logfile /tmp/vmware_plugin.log
 entities_list /tmp/vmware_entities_list.txt
 transfer_mode tentacle
 tentacle_ip 192.168.70.81
 tentacle_port 41121
 tentacle_opts
 local_folder /var/spool/pandora/data_in
 pandora_url http://192.168.70.81/pandora_console
 api_pass 1234
 api_user admin
 api_user_pass pandora
 event_mode 0
 event_pointer_file /tmp/vmware_events_pointer.txt

Due to the size of the Enterprise client VMware® infrastructures, a general scan of all available entities in each run could trigger performance issues.

VMware® インフラストラクチャのエンタープライズクライアントのサイズの問題で、各実行で利用可能なすべてのエンティティの一般的なスキャンがパフォーマンスの問題を引き起こす可能性があります。

To avoid this situation, the VMware monitoring plugin has the entity file (entities_list) where it stores the list of entities scanned in the first execution.

この状況を回避するために、VMware 監視プラグインには、最初の実行でスキャンされたエンティティのリストを格納するエンティティファイル (entities_list) があります。

As long as this file exists, the monitoring will be limited to the entities indicated in it.

このファイルが存在する限り、監視はファイルに示されているエンティティに限定されます。

If you need a periodic scan of your VMware infrastructure, you can delete this file from time to time (e.g. every hour) using the system's cron.

VMware インフラストラクチャの定期的なスキャンが必要な場合は、システムの cron を使用して、このファイルを時々(たとえば 1 時間ごとに)削除します。

Entity renaming is done using the RENAME token and allows entities discovered by the plugin to be renamed. By using this feature, the agents created in Pandora FMS will appear with the new name assigned. The structure of this section is the following:

エンティティの名前変更は、RENAME トークンを使用して行われ、プラグインによって検出されたエンティティの名前を変更できます。 この機能を使用すると、Pandora FMS で作成されたエージェントが新しい名前で表示されます。 このセクションの構造は次のとおりです。

<current name> TO <new name>

A configuration example in this section could be the following:

このセクションの設定例を以下に示します。

 #Rename entities
 Rename
 Debian 11 TO Virtual Machine 1
 RedHat 12 TO Web server
 ESX Workstation TO Host Work Sales

The plugin allows you to rule out entities by type or individually. Both options are explained below.

プラグインを使用すると、種類ごとまたは個別にエンティティを除外できます。 両方のオプションについて以下で説明します。

The discarding feature uses the REJECT token to rule out entities. In this section, you can discard entities according to their type, e.g. all virtual machines or all ESX hosts. The accepted values for this section are the following: all_datastore, all_datacenter, all_esx and all_vm.

エンティティを除外するには REJECT トークンを使用します。 このセクションでは、全ての仮想マシンやすべての ESX ホストなどのタイプに応じてエンティティを除外できます。このセクションで使用できる値は、all_datastore、all_datacenter、all_esx、および all_vm です。

A configuration for this section (which would discard all entities) would be like the one shown below:

このセクションの設定(すべてのエンティティを除外) は、次のようになります。

 #Dismissed entities
 Reject
 all_datastore
 all_datacenter
 all_esx
 all_vm

To dismiss entities individually, delete the entity's file which was created by the plugin. The plugin creates a file on the location which is indicated by the entities_list parameter (it is /tmp/vmware_entities_list.txt by default). This plugin provides the content of this file at the moment of the first execution or creates a list with all the discovered entities (if it does not already exist). A good example of this file could be the one below:

エンティティを個別に除外するには、プラグインによって作成されたエンティティのファイルを削除します。 プラグインは、entities_list パラメータで指定された場所にファイルを作成します (デフォルトでは /tmp/vmware_entities_list.txt です)。 この プラグイン は、最初の実行時にこのファイルを作成し、(まだ存在しない場合は)検出されたすべてのエンティティのリストを書き込みます。 このファイル例を以下に示します。

 Datacenter
 artica
 Datastore
 datastore_1
 datastore2
 ESX
 192.168.70.252
 VM
 Pandora FMS 4.0.3
 Debian2
 Debian3
 Debian4
 Redhat
 debian5
 Debian6
 Debian8
 Debian7
 Debian11
 Debian10
 Debian9
 NSM
 Pandora
 vcenter
 suse11.2

The configuration file is divided into several tokens: Datacenter, Datastore, ESX and VM , where the different entities are listed. Once the configuration file is created, the plugin will read the entities to monitor. If you intend to discard a certain entity, delete it from the folder. For example, if you do not want to monitor the following entities: Debian2, datastore2, NSM, suse11.2 and 192.168.70.252 , the configuration file must be like the one below:

設定ファイルは、Datacenter、Datastore、ESX、および VM の複数のトークンに分割され、さまざまなエンティティがリストされています。設定ファイルが作成されると、プラグインは監視対象のエンティティを読み取ります。 特定のエンティティを除外する場合は、フォルダから削除します。 たとえば、次のエンティティを監視したくない場合: Debian2、datastore2、NSM、suse11.2、および 192.168。 70.252 、設定ファイルは次のようにする必要があります。

 Datacenter
 artica
 Datastore
 datastore_1
 ESX
 VM
 Pandora FMS 4.0.3
 Debian3
 Debian4
 Redhat
 debian5
 Debian6
 Debian8
 Debian7
 Debian11
 Debian10
 Debian9
 Pandora
 vcenter

This feature allows you to distribute the monitoring load by limiting the number of monitored entities in every plugin execution. More load distribution methods are explained below:

この機能により、プラグインの実行ごとに監視対象エンティティの数を制限することで、監視負荷を分散できます。 その他の負荷分散方法については、以下で説明します。

The next file sections configure the created modules for every type of entity. These sections use the Data Center, Data Store, ESX and VM sections. In these sections, you can enable and disable modules to be monitored. The following example contains a configuration according to the modules that would be created for ESX and virtual machines.

次のファイル セクションでは、すべての種類のエンティティに対して作成されたモジュールを設定します。 これらのセクションでは、Data Center、Data Store、ESX、および VM セクションを使用します。 これらのセクションでは、モジュールの監視を有効または無効にできます。 次の例では、ESX および仮想マシン用に作成されるモジュールに基づく設定が含まれています。

 ...
 #ESX Modules
 ESX
 cpuUsagePercent disabled
 diskRead enabled
 diskWrite enabled

 #VM Modules
 VM
 diskReadLatency disabled
 diskWriteLatency disabled
 diskRate enabled
 ...

Every configuration line is a module. Although in the previous example, all the modules are created with default values. You are able to configure the following values: 'Name', 'description' and 'limits' for 'warning' and 'critical' states. An example of this configuration type would be like the one below:

すべての設定行はモジュールです。 ただし、前の例では、すべてのモジュールがデフォルト値で作成されています。 '名前'、'説明'、'警告' および '障害' 状態の 'しきい値' を設定できます。このタイプの設定例は、次のようになります。

 ...
 #VM Modules
 ESX
 diskReadLatency disabled
 diskWriteLatency disabled
 diskRate name = Disk Rate; desc = Lec Rate/Esc disk; limits_warn = 5 10; limits_crit = 0 4
 ...

The available options for module configuration are these:

モジュール設定に使用できるオプションは次のとおりです。

• <module> disabled: The module will NOT be created
• <module> enabled: The module WILL be created (with values by default)
• <module> name = <name>; desc = <description>; limits_warn <lim_warn>; limits_crit <lim_crit» The module will be created along with the given name and description. The module will define thresholds for 'maximum' and 'minimum' as well as for Critical and Warning states.

• <module> disabled: モジュールは作成されません。
• <module> enabled: モジュールは(デフォルト値で)作成されます。
• <module> name = <name>; desc = <description>; limits_warn <lim_warn>; limits_crit <lim_crit» : モジュールは、指定された名前と説明とともに作成されます。 このモジュールは、'最大' と '最小' および障害と警告状態のしきい値を定義します。

Keep in mind that it is very important to respect the structure of the configuration file lines, and above all, making sure that the character; is attached to the name and description of the module.These two lines areNOT EQUIVALENT (see spaces before character;):

設定ファイルの行の書式に従うことが非常に重要であり、何よりも、モジュールの名前と説明に文字 ; が付けられていることを確認することが非常に重要であることに注意してください。以下の 2 行は 同等ではありません (文字 ; の前のスペースを参照):

 diskRate name = Disk Rate; desc = Lec Rate/Esc Disk; limits_warn = 5 10; limits_crit = 0 4
 diskRate name = Disk Rate    ; desc = Lec Rate/Esc disk    ; limits_warn = 5 10; limits_crit    = 0    4

The modules are referenced by their short names or a simpler equivalent name to write it in the command line. The short and full name mapping tables are explained in the next section.

モジュールは、短い名前またはより単純な同等の名前で参照され、コマンド ラインに記述されます。 短い名前と完全な名前のマッピングテーブルについては、次のセクションで説明します。

Let us analyze the configuration of the example above. The Disk Rate module which will be created along with the following values has been configured:

上記の例の設定を分析してみましょう。 次の設定で、Disk Rate モジュールが作成されます。

 * Name: Disk Rate
 * Description: Lec Rate/Esc disk
 * Min Warning: 5
 * Max Warning: 10
 * Min Critical: 0
 * Max Critical: 4

There are some modules which are dynamically generated, e.g. the modules on disks or network interfaces. For these metrics, the plugin creates a module for each discovered element. These modules bear special names in Pandora FMS, e.g.:

動的に生成されるモジュールがいくつかあります。 例えば、ディスクまたはネットワークインターフェイス上のモジュールです。これらのメトリクスについて、プラグインは検出された要素ごとにモジュールを作成します。 これらのモジュールは、Pandora FMS では特別な名前が付けられています。例:

 Disk Free [0]
 Disk Free [1]
 Disk Free [2]
 ...

Since the name has a dynamic part in these cases, you can use the %s macro which will be replaced by the variable part of the module name. An example of dynamic module configuration would be the following:

このような場合、名前には動的な部分があるため、%s マクロを使用して、モジュール名の変数部分に置き換えることができます。 動的モジュール設定の例は次のとおりです。

diskfree name = Disk (% s) free space; desc = Free space for disk; limits_warn = 0 0; limits_crit = 0 0

In this case, the default module name is:

この場合、デフォルトのモジュール名は次の通りです。

Free Disk [0]

And will be renamed as:

そして、次のように名前を変更します。

Disk (0) free space

It is also possible to configure text strings for the limits of Warning and Critical states of the modules can be set. In such cases, the configuration would look like this:

モジュールの警告状態と障害状態を設定できるように、テキスト文字列を設定することもできます。 このような場合、設定は次のようになります。

powerState operation name = State; desc = VM operating state; limits_warn =. * suspended. *; limits_crit =. * poweredOff. *

Regular expressions can also be set to provide higher flexibility within setting limits.

正規表現を利用して、設定内でより高い柔軟性を得ることもできます。

Follow the steps described in Discovery to configure the monitoring of your VMware infrastructure through Discovery.

自動検出を通して VMware インフラストラクチャの監視を設定するには、自動検出 で説明している手順に従います。

設定した機能を確認するには、次のコマンドを実行します。

perl /usr/share/pandora_server/util/plugin/vmware-plugin.pl /usr/share/pandora_server/util/plugin/vmware-plugin.conf

注意:

• VMware SDK 6.5.0 で、プラグインの実行中に次のような出力が表示された場合:

Server version unavailable at 'https://your_vmwre_fqdn:443/sdk/vimService.wsdl' at /usr/local/lib64/perl5/VMware/VICommon.pm line 734.

perl LWP ライブラリのバージョンを調整することで解決します：

cpan install GAAS/libwww-perl-5.837.tar.gz

インフラを監視するには、VMware 検出アプリケーションの利用をおすすめします。ただし、VMware 監視プラグインの実行を自動化する方法はいろいろあります。

Pandora FMS エージェントを利用します:

Pandora FMS エージェントがアクセス可能な場所へ vmware-plugin.{pl,conf} をコピーします。

sudo cp /usr/share/pandora_server/util/plugin/vmware-plugin.{pl,conf} /etc/pandora/plugins/

.tar には設定ファイル vmware-plugin-events.confは ありませんが、vmware-plugin.confをコピーして 'event_mode' を手動で 1に変更することで作成できます。

次のように、新しいプラグインモジュールをエージェント設定ファイルに追加します。

module_plugin perl /etc/pandora/plugins/vmware-plugin.pl /etc/pandora/plugins/vmware-plugin.conf

イベントのコピーも実行したい場合は、イベントのコピーを行う別の設定ファイルを使用して別のプラグインモジュールを作成する必要があります。 構文は次の通りです。

module_plugin perl /etc/pandora/plugins/vmware-plugin.pl /etc/pandora/plugins/vmware-plugin-events.conf

Windows システムでは、使用するインタプリタを指定する必要があります。 コマンドは次のようになります。

module_plugin perl "C:\Program Files\pandora_agent\util\vmware-plugin.pl" "C:\Program Files\pandora_agent\util\vmware-plugin.conf"

プラグイン設定ファイルのパラメータについては、以降のセクションで詳しく説明します。

You can schedule the execution of the plugin from the cron system itself. Remember that the interval value of the generated elements ( interval in the configuration) and the execution periodicity must be consistent:

システム cron からプラグインの実行を行うことができます。 生成された要素の実行間隔(設定した間隔)と実際の実行間隔は一致している必要があります。

 # crontab に追加するエントリー。この設定では 600秒間隔にしています。
 */10 * * * * root perl /usr/share/pandora_server/util/plugin/vmware-plugin.pl /usr/share/pandora_server/util/plugin/vmware-plugin.conf

The previous example shows the line to be added to crontab. Configure an inteval of 600 to use this configuration.

上記の例は、crontab に追加される行を示しています。 これを使用するには、間隔を 600 に設定します。

プラグインの実行結果を見るには、'モニタリング(Monitoring)' → 'エージェント詳細(Agent Detail)' へ行きます。

以下では、他の Pandora FMS エージェントと一緒にプラグインにより作成されたエージェントが表示されます。

エージェント名をクリックすると、Pandroa FMS エージェント表示で VMware プラグインで監視されているモジュールを見ることができます。

デフォルトでは、プラグインは各 VMware の要素ごとに基本的な監視項目を表示します。これらのデフォルトのエンティティ設定を以降に示します。

• Ping
• Check 443 port

• Capacity
• Free Space
• Disk Overallocation
• Free Space Bytes

• CPU Usage
• Memory Usage
• Data received
• Data transmitted
• Disk Read Latency
• Disk Write Latency
• Host Alive

• CPU Usage
• Memory Usage
• Tools Running Status
• Host Alive
• Disk Free
• Disk Read Latency
• Disk Write Latency
• Data received
• Data transmitted
• Net Usage

以降の章では、それぞれのモジュールの情報の詳細について説明します。

VMware のバージョンおよび環境設定により、いくつかのモジュールが存在しない場合もあります。以下に示す表では、存在するモージュールとその機能を説明します。

これらのモジュールは、VMware アーキテクチャ視点からの情報を提供します。仮想マシンに関する他のパラメータをモニタしたい場合は、ソフトウエアエージェントを使った監視やリモート監視に示した手法を考慮する必要があります。

この機能は、VMWare vCenter から Pandora FMS へイベント情報をコピーするために作成されました。

これらのイベントは、Pandora FMS イベント管理フローにのっとり、自動的に vCenter エージェントに割り当てられます。次の画面は、自動検出タスクで生成されたイベントの例です。

コピー処理は、VMware が生成したイベントの情報や重要度を引き継ぎます。イベントにおける、障害、警告、情報といった重要度のレベルを Pandora に渡します。次の画面は Pandora FMS での詳細情報の例です。

Pandora FMS でのすべてのイベントは、イベント管理のアクションを実行できます。たとえば、アラーと生成、フィルタ設定、インシデント作成などです。

VMWare プラグインと一緒に、VMware Manager および VMware View という 2つの拡張を配布しています。VMware View は、VMware アーキテクチャのコンポーネントを簡単に表示することができます。また、VMware Manager は、Pandora FMS コンソールから仮想マシンの停止、起動、再起動、稼働の中止など、仮想マシンを管理することができます。これらの拡張は、Pandora FMS 4.0 以降でのみ動作するオプションです。

バージョン 4.1 以降のプラグインから、これらの拡張は一つにまとめられました。拡張は VMware Settings と呼びます。この新しい拡張は、Pandora FMS 5.1 以降でサポートされています。

VMware アーキテクチャ表示を使うには、エージェント参照の VMware View をクリックします。

VMware View 拡張は、自動検出タスクで見つけた全 VMware アーキテクチャを含んだ以下のようなマップを表示します。

マップには、VMware アーキテクチャの要素(仮想マシン、ESX、データストアおよび、データセンター)が、それぞれを区別できる異なるアイコンで表示されています。また、Pandora FMS エージェントの状態がそれぞれの要素の状態を表します。さらに、仮想マシン、ESX および データセンター間の関係を表示しています。これにより、簡単にすばやく VMware アーキテクチャの状態を見ることができます。

この拡張には、要素を隠したり、文字を大きくしたり、要素を拡大したりといった、アーキテクチャの表示の改善を手助けしてくれるいくつかのオプションがあります。

上記のオプションを使うと、データセンターと ESX だけを見ることができます。

Pandora FMS バージョン 5.0 以上では、VMware ビュー拡張により、仮想アーキテクチャトポロジを表示する 2つの追加マップビューがあります。新たなタブでは、VMware ビュー拡張の異なる表示を切り替えることができます。

最初のビューは、一目で、仮想マシン、データストアや、ESXi ホスト問題が発生しているかをわかるようにした、一般的な仮想アーキテクチャを表示するダッシュボードです。さらに、グラフにより仮想アーキテクチャ全体の中で、5つの仮想マシンが使っている、メモリ、CPU、ディスク、ネットワークがわかります。一般的なパフォーマンスパラメータも簡単に確認することができます。

2つ目のビューでは、ESX ホストのパフォーマンスパラメータを確認することができます。このビューでは、ホストおよび仮想マシンの状態を確認したい ESX ホストを選択することができます。ESXi ホストにおける CPU、メモリ、ディスク、ネットワーク利用状況が表示されます。さらに、仮想マシンのほとんどのリソース情報 (CPU、メモリ、ディスク、ネットワーク) もグラフィカルに参照することができます。

Pandora FMS 7.0NG 716 では、VMware 拡張は、Enterprise 版 Pandora FMS コンソールに含まれています。

ダッシュボードおよびマップオプションを設定するための、設定パネルがあります。

• ダッシュボードグラフでの表示閾値(最小 - 最大)を調整することができます。
• デフォルトマップビューを調整することができます。
• 設定管理システムへのリンクを含めることができます。

VMware View のオプションタブ:

VMware Manager 拡張を利用するには、VMware アーキテクチャ内の仮想マシンエージェントの操作画面へ行きます。そこに、拡張にリンクした VMware のアイコンがあります。

VMware Manager 拡張では、仮想マシンを Pandora FMS コンソールから管理できます。拡張は仮想マシンの現在の状態を色で表示(緑 = on、オレンジ = off、グレー = 停止中)します。さらにコンボボックスにとりうる状態が表示され、選択して Change Status ボタンをクリックすることにより仮想マシンの状態を変更することができます。

この拡張で、次のように Stop を選択することにより仮想マシンを停止することができます。

これによりマシンが停止し、VMware Manage 拡張での表示が変ります。次のようにマシンが停止状態であると表示されます。

この節では、仮想マシンと ESX のパフォーマンスカウンタのための新たなモジュールを設定します。新たなパフォーマンスモジュールを設定するには、次の構造を利用します。

custom_performance type = mem; metric = swapinRate; module_type = generic_data; name = Swap In Rate; desc = Swap In Rate for host; limits_warn = 0 0; limits_crit = 0 0

設定パラメータは次の通りです。

• Type: 監視するメトリックのタイプ。指定可能なタイプは次の通りです。
  • 'Cpu' CPU
  • 'Mem': メモリ
  • 'Disk': ディスク
  • 'Net' ネットワーク
  • 'Sys': システム
• Metric: 監視するメトリック。(メトリックの表示にて後述します)
• Module_type: Pandora のモジュールタイプ。(例 generic_data).
• Name: モジュール名。
• Desc: モジュールの説明。
• Limits_warn: 警告閾値
• Limits_crit: 障害閾値

それぞれのエンティティの Performance セクションのそれぞれのタイプに存在するメトリックを確認できます。以下では、VMware プラグインで vCenter 内より監視できるパフォーマンスメトリックを表示しています。例えば、以下の例では、ESX ホストの Performance view を表示しています。

タイプごとのすべてのメトリックの一覧を参照するには、Advanced ボタンをクリックし、Char オプションボタンをクリックします。以下のように、メトリックの全タイプの一覧と、それぞれのタイプのメトリックのウインドウが表示されます。

メトリックの各タイプには、カウンタ番号(Pandoraで監視できる値)があります。値を監視するには、内部の Name を利用する必要があります。さらに、(vCenterで設定されている)状態レベルをメトリックの Collection Level と比較検索して確認する必要があります。

例えば、ESX ホストの CPU 使用率を見たい場合は、ESX の CPU タイプの値を探し、utilization を選択します。この場合、設定ファイルに追加する必要がある設定は、次のようになります。

custom_performance type = cpu; metric = utilization; module_type = generic_data, name = CPU Utilization, desc = CPU Utilization for ESX; limits_warn = 0 0; limits_crit = 0 0

エージェントに設定したそれぞれのプラグインモジュールが、データセンターを監視します。複数のデータセンターを一つの Pandora FMS ソフトウエアエージェントで監視したい場合は、次の事に注意してください。

• 監視するそれぞれのデータセンター用に module_plugin を追加する必要があります。例えば、次の通りです。

 module_plugin /etc/pandora/plugins/vmware-plugin.pl /etc/pandora/plugins/vmware-plugin-datacenter1.conf
 module_plugin /etc/pandora/plugins/vmware-plugin.pl /etc/pandora/plugins/vmware-plugin-datacenter2.conf

• それぞれの設定ファイルで、logfile 、entities_list 、event_pointer_file パラメータを変更する必要があります。設定ファイルは次のようになります。

vmware-plugin-datacenter1.conf

  ...
  logfile / tmp/vmware_plugin_datacenter1.log
  entities_list / tmp/vmware_entities_list_datacenter1.txt
  event_pointer_file / tmp/vmware_events_pointer_datacenter1.txt
  ...

vmware-plugin-datacenter2.conf

  ...
  logfile / tmp/vmware_plugin_datacenter2.log
  entities_list / tmp/vmware_entities_list_datacenter2.txt
  event_pointer_file / tmp/vmware_events_pointer_datacenter2.txt
  ...

• また、イベントをコピーしたい場合は、2つ以上のプラグインモジュールを設定ファイルに追加し、event_mode フラグを有効にします。module_plugin の設定は次のようになります。

 module_plugin /etc/pandora/plugins/vmware-plugin.pl /etc/pandora/plugins/vmware-plugin-datacenter1.conf
 module_plugin /etc/pandora/plugins/vmware-plugin.pl /etc/pandora/plugins/vmware-plugin-datacenter1-events.conf
 module_plugin /etc/pandora/plugins/vmware-plugin.pl /etc/pandora/plugins/vmware-plugin-datacenter2.conf
 module_plugin /etc/pandora/plugins/vmware-plugin.pl /etc/pandora/plugins/vmware-plugin-datacenter2-events.conf

プラグイン設定ファイルのオプションで、Pandora FMS サーバ間で監視の負荷分散ができます。

たとえば、仮想環境が次のような構成だとします。

 DC
 |
 |- Datastore_1
 |- DataStore_2
 |
 |- ESX_1
       |- mv1.1
       |- mv1.2
       |- mv1.3

 |- ESX_2
       |- mv2.1
       |- mv2.2
       |- mv2.3

この環境において、監視のための 2つの Pandora FMS サーバがあります。負荷を分散する簡単な方法としては、データセンター、データストア、ESX を 1台目のサーバで監視し、仮想サーバを 2台目のサーバで監視します。自動検出スクリプトの設定ファイルは、次のようになります。

サーバ 1:

 Reject
 all_vm

サーバ 2:

 Reject
 all_datacenter
 all_datastore
 all_esx

サーバ 1 は、仮想マシン以外のすべてを監視し、サーバ 2 は、仮想マシンのみを監視します。

他の分散方法としては、ESX サーバごとに監視を分ける方法です。1台目の Pandora サーバが、1台目の ESX サーバに関するすべてを監視し、2台目が 2台目の ESX を監視します。entties_list.txt を 2つのファイルに分割し、異なるエージェントで 2つのプラグインの実行を構成します。 設定ファイルは次のようになります。

サーバ 1:

 Datacenter
 DC
 Datastore
 Datastore_1
 ESX
 ESX_1
 VM
 mv1.1
 mv1.2
 mv1.3

サーバ 1 は、2つ目の VMware グループに関連するすべてを無視します。それにより、1つ目の環境のみ監視します。

サーバ 2:

 Datastore
 DataStore_2
 ESX
 ESX_2
 VM
 mv2.1
 mv2.2
 mv2.3

サーバ 2 は、1つ目の VMware グループに関連するすべてとデータセンターを無視します。データセンターは、サーバ 1 で監視されるエンティティのためです。

エンティティを対象外にする機能はとても柔軟で、それぞれの Pandora FMS エージェントに少ないエンティティを割り当てることにより、負荷を分散することができます。

すべてのモジュールを無効にするファイル

 #These lines are comments
 #Datacenter Modules
 Datacenter
 ping disabled
 check443 disabled

 #Datastore Modules
 Datastore
 capacity disabled
 freeSpace disabled
 overallocation disabled
 freeSpaceBytes disabled

 #ESX Modules
 ESX
 bootTime disabled
 cpuInfo disabled
 memorySize disabled
 overallCpuUsage disabled
 overallMemoryUsage disabled
 powerState disabled
 sslThumbprint disabled
 uptime disabled
 vnicInfo disabled
 hostAlive disabled
 connectionState disabled
 diskRead disabled
 diskWrite disabled
 diskReadLatency disabled
 diskWriteLatency disabled
 netReceived disabled
 netTransmitted disabled
 netPkgRx disabled
 netPkgTx disabled
 cpuUsagePercent disabled
 memoryUsagePercent disabled
 netUsage disabled
 diskRate disabled
 maxDiskLatency disabled
 systemHealthInfo disabled

 #VM Modules
 VM
 bootTime disabled
 connectionState disabled
 consumedOverheadMemory disabled
 cpuAllocation disabled
 diskFree disabled
 guestState disabled
 host disabled
 hostAlive disabled
 diskUsed disable
 provisioningUsed disable
 totalReadLatency disable
 totalWriteLatency disable
 hostMemoryUsage disabled
 hostName disabled
 ipAddress disabled
 macAddress disabled
 maxCpuUsage disabled
 maxMemoryUsage disabled
 memoryAllocation disabled
 memoryOverhead disabled
 overallCpuDemand disabled
 overallCpuUsage disabled
 powerState disabled
 privateMemory disabled
 sharedMemory disabled
 toolsRunningStatus disabled
 triggeredAlarmState disabled
 virtualImagePath disabled
 uptimeSeconds disabled
 diskRead disabled
 diskWrite disabled
 diskReadLatency disabled
 diskWriteLatency disabled
 netReceived disabled
 netTransmitted disabled
 netPkgRx disabled
 netPkgTx  disabled
 cpuUsagePercent disabled
 memoryUsagePercent disabled
 netUsage disabled
 diskRate disabled
 maxDiskLatency disabled
 heartbeat disabled
 cpuReady disabled