差分

このページの2つのバージョン間の差分を表示します。

--- ja:documentation:03_monitoring:05_virtual_environment_monitoring [2022/09/09 23:14] – [設定ファイル] junichi
+++ ja:documentation:03_monitoring:05_virtual_environment_monitoring [2023/10/03 08:15] – junichi
@@ 行 1: / 行 1: @@
-====== 仮想環境モニタリング ======
+====== 仮想環境監視 ======
 {{indexmenu_n>5}}
@@ 行 5: / 行 5: @@
 [[:ja:documentation:start|Pandora FMS ドキュメント一覧に戻る]]
-===== 仮想環境モニタリング =====
+===== 仮想環境監視 =====
 仮想環境は、すべての企業の IT アーキテクチャで非常に重要であり、そのため、仮想環境の監視が不可欠です。 Pandora FMS Enterprise を使用すると、次の環境の監視ができます。
@@ 行 220: / 行 220: @@
   * Perl 用の VMware vSphere SDK
-<WRAP center round tip 60%> Pandora FMS ISO には、VMware を監視するために必要な全コンポーネントが含まれています。 </WRAP>
 === 監視のための vCenter 設定 ===
@@ 行 236: / 行 236: @@
 === VMware プラグインのデプロイ ===
-Pandora FMS バージョン 732 以降では、VMware の監視は、//自動検出アプリケーション//  システムを用いて行われます。(より詳細は、[[:ja:documentation:03_monitoring:04_discovery#e382a2e38397e383aae382b1e383bce382b7e383a7e383b3e6a49ce587bavmware|こちら]] を参照してください。)
+From Pandora FMS version 732 onwards, VMware® monitoring is done using the //Discovery Applications// system (more information in [[:en:documentation:03_monitoring:04_discovery#discovery_applicationsvmware|Discovery.]])
+Pandora FMS バージョン 732 以降では、VMware の監視は、//自動検出アプリケーション//  システムを用いて行われます。(より詳細は、[[:ja:documentation:03_monitoring:04_discovery#アプリケーション検出vmware|こちら]] を参照してください。)
 いくつかの理由によりこの機能の外で手動でプラグインを設定したい場合は、以下に説明する旧手法を使うことができます。
-Pandora FMS ISO イメージには、拡張と合わせて VMware プラグインがあらかじめインストールされています。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 プラグインをインストールしたり最新のバージョンにアップデートする場合は、以下に示す手順に従ってください。
 == 手動でのプラグインデプロイ ==
@@ 行 299: / 行 303: @@
 === VMware vSphere SDK for Perl のインストール ===
-[[http://communities.vmware.com/community/developer/downloads|ダウンロードセンター]] から、VMware ソフトウエアを入手します。
+The link for the download center of the required VMware softare is:
+必要な VMware ソフトウェアのダウンロードセンターへのリンクは次の通りです。
-<WRAP center round important 60%> アプライアンス(CentOS ベースの ISO)を用いて Pandora FMS をインストールしている場合は、監視する VMware バージョンが 6.5 以下の場合、追加のソフトウエアのインストールは不要です。 </WRAP>
+[[https://my.vmware.com/web/vmware/details?downloadGroup=VS-PERL-SDK65&productId=614|https://my.vmware.com/web/vmware/details?downloadGroup=VS-PERL-SDK65&productId=614]]
 == CentOS 7 への Linux SDK のインストール ==
@@ 行 789: / 行 795: @@
 **user**
- vCenter で必要な権限のあるユーザ。
+User with read permissions in vCenter®.
+vCenter® で読み出し権限のあるユーザ。
 **pass**
@@ 行 1323: / 行 1331: @@
 上記の例は、**crontab** に追加される行を示しています。 これを使用するには、間隔を 600 に設定します。
 === VMware 仮想アーキテクチャのモニタリング ===
@@ 行 1565: / 行 1574: @@
 <WRAP center round important 60%> RENAME を使用して監視が設定されている場合、名前が変更されたターゲットでは機能しません。 </WRAP>
-=== プラグインの設定 ===
+== カスタムパフォーマンス測定 ==
-この章は、手動でプラグインを設定する場合の説明をしています。 デフォルトでは、VMware 自動検出スクリプトは前述の通り見つけたもの全てを追加します。追加したいものとしたくないものを選択するには、自動検出スクリプトが設定ファイルを読み込むようにします。自動検出スクリプトに設定ファイルを与えるには、Pandora FMS で作成された設定に -reconconf <ファイル> というパラメータを追加します。
+<WRAP center round tip 60%> 自動検出でこの機能を利用するには、//Extra settings//  に設定を追加します。 </WRAP>
-<WRAP center round tip 60%> 設定ファイルに関する全エラーは、Pandora サーバのエラーログに出力され、かつ、Pandora のイベントビューワに表示されます。これらから設定ファイルに何らかの問題があるかどうかを確認できます。 </WRAP>
+この節では、仮想マシンと ESX のパフォーマンスカウンタのための新たなモジュールを設定します。新たなパフォーマンスモジュールを設定するには、次の構造を利用します。
-== 設定ファイル ==
-**全体設定**
-全般的な設定は、**Configuration**  トークンで定義します。次のようなパラメータがあります。
-  * **server**: vCenter の IP アドレス。
-  * **user**: vCenter ユーザ。
-  * **pass**: vCenter パスワード。
-  * **datacenter**: 監視するデータセンター。
-  * **temporal**: テンポラリディレクトリ。
-  * **logfile**: ログファイルの場所。
-  * **entities_list**: 監視対象エンティティ一覧のファイルの場所。
-  * **transfer_mode**: XML の転送モード。**tentacle**  または **local**  が指定できます。
-      * **tentacle**: Pandora FMS サーバへ Tentacle プロトコルを用いて XML を送信します。
-      * **local**: ファイルをローカルのホルダにコピーします。指定したローカルホルダがあるのと同じマシンでエージェントを動かす必要があります。
-  * **tentacle_ip**: 情報を送信する Pandora サーバの IP アドレス。
-  * **tentacle_port**: 情報を送信する先のポート番号。デフォルトは 41121。
-  * **tentacle_opts**: Tentacle で送信する場合の追加オプション。(デフォルトはなし)
-  * **local_folder**: local モードの場合の XML のコピー先ディレクトリ。
-  * **pandora_url**: Pandora FMS コンソール URL。(例: [[http://192.168.70.81/pandora_console|http://192.168.70.81/pandora_console]]).
-  * **api_pass**: Pandora FMS API パスワード。
-  * **api_user**: Pandora FMS コンソールユーザ。
-  * **api_user_pass**: Pandora FMS コンソールユーザのパスワード。
-  * **retry_send:**  .data ファイルの再送の有効化(1)/無効化(0)。
-  * **event_mode**: イベント収集モードを有効にするためのフラグ。1 の場合はイベント収集モードが有効となり、0 の場合は無効となります。
-  * **event_pointer_file**: イベントを収集するためのポインタを保存するためのテンポラリファイルの場所。
-  * **verbosity**: ログレベル。(0 ではプラグインの実行エラー出力を抑制し、1 ではすべてのエラーを出力します。)
-  * **threads**: プラグインスレッドの数。(デフォルトは 1)
-  * **interval**: VMware エンティティを表すエージェントインターバル。
-このセクションの設定例を以下に示します。
 <code>
+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
- 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
 </code>
-<WRAP center round tip 60%> Windows のプラグインを利用している場合は、パスの表記を Windows に合わせてください。 </WRAP>
+設定パラメータは次の通りです。
-**エンティティのスキャン**<WRAP center round tip 60%> 自動検出でこの機能を利用するには、//Extra settings//  に設定を追加します。 </WRAP>
+  * //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//  を表示しています。
-クライアントの VMware インフラストラクチャのサイズが大きいため、各実行で利用可能なすべてのエンティティの一般的なスキャンはパフォーマンスの問題を引き起こす可能性があります。
+{{  :wiki:vmware_perf_view.png?800  }}
-この状況を避けるために、VMware 監視プラグインには、最初の実行でスキャンされたエンティティの一覧を格納するエンティティファイル（//entities_list//  ）があります。
+タイプごとのすべてのメトリックの一覧を参照するには、//Advanced//  ボタンをクリックし、//Char//  オプションボタンをクリックします。以下のように、メトリックの全タイプの一覧と、それぞれのタイプのメトリックのウインドウが表示されます。
-このファイルが存在する限り、監視はその中に示されているエンティティに制限されます。
+{{  :wiki:vmware_perf_metrics_list.png?600  }}
-VMware インフラストラクチャを定期的にスキャンする必要がある場合は、cron システムを使用してこのファイルを時々(たとえば 1時間ごとに)削除できます。
+メトリックの各タイプには、カウンタ番号(Pandoraで監視できる値)があります。値を監視するには、内部の //Name//  を利用する必要があります。さらに、(vCenterで設定されている)状態レベルをメトリックの //Collection Level//  と比較検索して確認する必要があります。
-**エンティティの名前変更**<WRAP center round tip 60%> 自動検出でこの機能を利用するには、//Extra settings//  に設定を追加します。 </WRAP>
+{{  :wiki:vmware_perf_metrics_counter.png?600  }}
-エンティティの名前変更は //Rename//  トークンを使用して行います。プラグインによって検出されたエンティティの名前の変更ができます。 この機能を使用すると、Pandora で作成されたエージェントは新しい名前が割り当てられて表示されます。このセクションの書式は次の通りです。
+例えば、ESX ホストの CPU 使用率を見たい場合は、ESX の CPU タイプの値を探し、//utilization//  を選択します。この場合、設定ファイルに追加する必要がある設定は、次のようになります。
 <code>
-<現在の名前> TO <新しい名前>
-</code>
+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
-設定例を以下に示します。
-<code>
- #Rename entities
- Rename
- Debian 11 TO Virtual Machine 1
- RedHat 12 TO Web server
- ESX Workstation TO Host Work Sales
 </code>
-**エンティティの除外**<WRAP center round tip 60%> 自動検出でこの機能を利用するには、//Extra settings//  に設定を追加します。 </WRAP>
-プラグインは、タイプまたは個別にエンティティを除外できます。両方のオプションを以下に説明します。
-エンティティの除外には、**Reject**  トークンを利用します。このセクションでは、タイプによってエンティティを除外します。例えば、全仮想マシンや全 ESX ホストです。ここで設定可能な値は、all_datastore, all_datacenter, all_esx, all_vm のいずれかです。
-このセクションで、すべてのエンティティを除外する設定は次の通りです。
-<code>
- #Dismissed entities
- Reject
- all_datastore
- all_datacenter
- all_esx
- all_vm
-</code>
-個別のエンティティを除外するには、プラグインにより作成されたエンティティファイルを削除する必要があります。プラグインは、このファイルを //entities_list//  パラメータに示された場所 (デフォルトは /tmp/vmware_entities_list.txt) に作成します。プラグインは、検出した全エンティティのリストを書いたファイルを最初の実行時(ファイルが存在しない場合)に生成します。このファイルの例を以下に示します。
-<code>
- Datacenter
- artica
- Datastore
- datastore_1
- datastore2
- ESX
-.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
-</code>
-設定ファイルは、異なるエンティティがリストアップされた //Datacenter//, //Datastore//, //ESX//, //VM//  といったいくつかのトークンで分かれています。設定ファイルが作成されると、プラグインは監視するエンティティを読み込みます。特定のエンティティを除外したい場合は、フォルダーからそのファイルを削除します。例えば、//Debian2//, //datastore2//, //NSM//, //suse11.2//  および //192.168.70.252//  のエンティティを監視したくない場合は、設定ファイルは次のようになります。
-<code>
- Datacenter
- artica
- Datastore
- datastore_1
- ESX
- VM
- Pandora FMS 4.0.3
- Debian3
- Debian4
- Redhat
- debian5
- Debian6
- Debian8
- Debian7
- Debian11
- Debian10
- Debian9
- Pandora
- vcenter
-</code>
-この機能により、各プラグインの実行における監視対象のエンティティを制限し監視の負荷を分散させることができます。以下に、より詳しい負荷分散のテクニックを説明します。
-**監視設定**<WRAP center round tip 60%> 自動検出でこの機能を利用するには、//Extra settings//  に設定を追加します。 </WRAP>
-次のセクションは、すべてのタイプのエンティティにおいて作成されたモジュールの設定です。これらのセクションでは、**Datacenter**, **Datastore**, **ESX**  および **VM**  を使います。監視するモジュールの有効・無効を設定できます。以下の例は、ESX および仮想マシンのモジュールに関する設定です。
-<code>
- ...
- #ESX Modules
- ESX
- cpuUsagePercent disabled
- diskRead enabled
- diskWrite enabled
- #VM Modules
- VM
- diskReadLatency disabled
- diskWriteLatency disabled
- diskRate enabled
- ...
-</code>
-各設定行がモジュールです。上記の例ではすべてのモジュールがデフォルトの値で作成されていますが、名前、説明、警告および障害状態の閾値は、設定変更することができます。この設定例を以下に示します。
-<code>
- ...
- #VM Modules
- ESX
- diskReadLatency disabled
- diskWriteLatency disabled
- diskRate name = Disk Rate; desc = Lec Rate/Esc disk; limits_warn = 5 10; limits_crit = 0 4
- ...
-</code>
-モジュール設定のオプションは、次の通りです。
-  * <モジュール名> disabled: モジュールは作成**されません**  。
-  * <モジュール名> enabled: (デフォルト値で)モジュールが作成されます。
-  * <モジュール名> name = <名前>; desc = <説明>; limits_warn <警告閾値>; limits_crit <障害閾値>> 指定した名前および説明でモジュールが作成されます。障害と警告の最大・最小閾値を定義します。
-設定ファイルの行の構造を尊重することが非常に重要であり、とりわけ、 ";" 文字がモジュールの名前と説明に付加されていることが重要です。これらの 2行は **等しくない**  です(";" 文字の前の空白を確認してください)。
-<code>
- 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
-</code>
-モジュールは、コマンドラインで記述する場合は、その短い名前または簡単な名前で参照されます。短い名前と長い名前のマッピングは、次の節で説明します。
-上記設定例を確認してみましょう。次に示す値で作成される //Disk Rate//  モジュールを設定しています。
-<code>
- * 名前: Disk Rate
- * 説明: Lec Rate/Esc disk
- * 警告の最小値: 5
- * 警告の最大値: 10
- * 障害の最小値: 0
- * 障害の最大値: 4
-</code>
-動的に生成されるモジュールがあります。例えば、ディスクやネットワークインタフェースのモジュールです。これらのメトリックでは、プラグインは検出したそれぞれのエレメントごとにモジュールを作成します。これらのモジュールは、Pandora FMS 内で特別な名前を持ちます。例えば次の通りです。
-<code>
- Disk Free [0]
- Disk Free [1]
- Disk Free [2]
- ...
-</code>
-これらの場合、名前に動的な部分があり、%s マクロを使ってモジュール名の数値部分を置き換えることができます。動的モジュールの設定例を以下に示します。
-<code>
-diskfree name = Disk (% s) free space; desc = Free space for disk; limits_warn = 0 0; limits_crit = 0 0
-</code>
-この場合、デフォルトのモジュール名は次の通りですが、
-<code>
- Free Disk [[0|]]
-</code>
-次のように変更されます。
-<code>
- Disk (0) free space
-</code>
-バージョン 5.0 からは、モジュールの警告および障害状態判断に文字列を利用することができます。次のような設定になります。
-<code>
- PowerState operation name = State; desc = VM operating state; limits_warn =. * suspended. *; limits_crit =. * poweredOff. *
-</code>
-判定基準を定義するのに自由度の高い正規表現を利用することができます。
@@ 行 1972: / 行 1755: @@
 <code>
  #These lines are comments
+ #Datacenter Modules
+ Datacenter
+ ping disabled
+ check443 disabled
  #Datastore Modules
@@ 行 1978: / 行 1765: @@
  freeSpace disabled
  overallocation disabled
+ freeSpaceBytes disabled
  #ESX Modules
@@ 行 2000: / 行 1788: @@
  netPkgRx disabled
  netPkgTx disabled
- cpuStatus disabled
+ cpuUsagePercent disabled
- storageStatus disabled
+ memoryUsagePercent disabled
- memStatus disabled
+ netUsage disabled
- memoryAllocation disabled
+ diskRate disabled
+ maxDiskLatency disabled
+ systemHealthInfo disabled
  #VM Modules
@@ 行 2015: / 行 1805: @@
  host disabled
  hostAlive disabled
+ diskUsed disable
+ provisioningUsed disable
+ totalReadLatency disable
+ totalWriteLatency disable
  hostMemoryUsage disabled
  hostName disabled
@@ 行 2020: / 行 1814: @@
  macAddress disabled
  maxCpuUsage disabled
+ maxMemoryUsage disabled
  memoryAllocation disabled
  memoryOverhead disabled
@@ 行 2029: / 行 1824: @@
  toolsRunningStatus disabled
  triggeredAlarmState disabled
- uptimeSeconds disabled
  virtualImagePath disabled
  uptimeSeconds disabled
@@ 行 2040: / 行 1834: @@
  netPkgRx disabled
  netPkgTx  disabled
+ cpuUsagePercent disabled
+ memoryUsagePercent disabled
+ netUsage disabled
+ diskRate disabled
+ maxDiskLatency disabled
+ heartbeat disabled
+ cpuReady disabled
 </code>
-== 短い名前の関係表 ==
+=== 短い名前の関係表 ===
-**データセンター**
+==データセンター==
 ^長い名前  ^短い名前  |
@@ 行 2051: / 行 1852: @@
 |Check 443 port  |check443  |
-**データストア**
+==データストア==
 ^長い名前  ^短い名前  |
@@ 行 2059: / 行 1860: @@
 |Free Space Bytes  |freeSpaceBytes  |
-**ESX**
+==ESX==
 ^長い名前  ^短い名前  |
@@ 行 2089: / 行 1890: @@
 |Sensor*  |haStatus  |
-**仮想マシン**
+==仮想マシン==
+^ 長い名前                  ^ 短い名前                 ^
+| Boot Time                 | bootTime                |
+| Connection State          | connectionState         |
+| Consumed Overhead Memory  | consumedOverheadMemory  |
+| CPU Allocation            | cpuAllocation           |
+| Disk Free                 | diskFree                |
+| Guest State               | guestState              |
+| Host Info                 | host                    |
+| Host Alive                | hostAlive               |
+| Disk Used                 | diskUsed                |
+| Provisioning Used         | provisioningUsed        |
+| Total Read Latency        | totalReadLatency        |
+| Total Write Latency       | totalWriteLatency       |
+| Host Memory Usage         | hostMemoryUsage         |
+| Host Name                 | hostName                |
+| IP Address                | ipAddress               |
+| MAC Address               | macAddress              |
+| Max. CPU Usage            | maxCpuUsage             |
+| Max. Memory Usage         | maxMemoryUsage          |
+| Memory Allocation         | memoryAllocation        |
+| Memory Overhead           | memoryOverhead          |
+| Overall CPU Demand        | overallCpuDemand        |
+| Overall CPU Usage         | overallCpuUsage         |
+| Power State               | powerState              |
+| Private Memory            | privateMemory           |
+| Shared Memory             | sharedMemory            |
+| Tools Running Status      | toolsRunningStatus      |
+| Trigger Alarm State       | triggeredAlarmState     |
+| Uptime Seconds            | uptimeSeconds           |
+| Virtual Image Path        | virtualImagePath        |
+| Disk Read                 | diskRead                |
+| Disk Write                | diskWrite               |
+| Disk Read Latency         | diskReadLatency         |
+| Disk Write Latency        | diskWriteLatency        |
+| Data Received             | netReceived             |
+| Data Transmitted          | netTransmitted          |
+| Packages Received         | netPkgRx                |
+| Packages Transmitted      | netPkgTx                |
+| CPU Usage                 | cpuUsagePercent         |
+| Memory Usage              | memoryUsagePercent      |
+| Net Usage                 | netUsage                |
+| Disk Rate                 | diskRate                |
+| Max. Disk Latency         | maxDiskLatency          |
+| HeartBeat                 | heartbeat               |
+| CPU Ready                 | cpuReady                |
+| Number of Snapshots       | snapshotCounter         |
+| HA Status                 | haStatus                |
-^長い名前  ^短い名前  |
-|Boot Time  |bootTime  |
-|Connection State  |connectionState  |
-|Consumed Overhead Memory  |consumedOverheadMemory  |
-|CPU Allocation  |cpuAllocation  |
-|Disk Free  |diskFree  |
-|Guest State  |guestState  |
-|Host Info  |host  |
-|Host Alive  |hostAlive  |
-|Host Memory Usage  |hostMemoryUsage  |
-|Host Name  |hostName  |
-|IP Address  |ipAddress  |
-|MAC Address  |macAddress  |
-|Max CPU Usage  |maxCpuUsage  |
-|Max Memory Usage  |maxMemoryUsage  |
-|Memory Allocation  |memoryAllocation  |
-|Memory Overhead  |memoryOverhead  |
-|Overall CPU Demand  |overallCpuDemand  |
-|Overall CPU Usage  |overallCpuUsage  |
-|Power State  |powerState  |
-|Private Memory  |privateMemory  |
-|Shared Memory  |sharedMemory  |
-|Tools Running Status  |toolsRunningStatus  |
-|Trigger Alarm State  |triggeredAlarmState  |
-|Uptime Seconds  |uptimeSeconds  |
-|Virtual Image Path  |virtualImagePath  |
-|Disk Read  |diskRead  |
-|Disk Write  |diskWrite  |
-|Disk Read Latency  |diskReadLatency  |
-|Disk Write Latency  |diskWriteLatency  |
-|Data received  |netReceived  |
-|Data transmitted  |netTransmitted  |
-|Packages Received  |netPkgRx  |
-|Packages Transmitted  |netPkgTx  |
-|CPU Usage  |cpuUsagePercent  |
-|Memory Usage  |memoryUsagePercent  |
-|Net Usage  |netUsage  |
-|Disk Rate  |diskRate  |
-|Max Disk Latency  |maxDiskLatency  |
-|HeartBeat  |heartbeat  |
-|CPU Ready  |cpuReady  |
-|Number Snapshots  |snapshotCounter  |
-|HA Status  |haStatus  |
 == イベントテーブル ==