VMware ULM アプリケーションのログとメトリクスの収集

データを収集するための Sumo Logic VM のセットアップ

このセクションでは、VMware のデータを収集するために必要なスクリプトが事前にインストールおよび設定されている Sumo Logic VM をセットアップするプロセスを順を追って説明します。

vCenter Server、別のホスト、または VM への Sumo Logic スクリプトのインストール

このセクションでは、イベントおよびメトリクスを収集するための Sumo Logic スクリプトを vCenter Server または vCenter API にアクセスできる他のホストにインストールするプロセスを順を追って説明します。最後に、vCenter Server、ホスト、VM 上のいずれであれ、スクリプトを実行するようにパスを設定する手順を説明します。

Sumo Logic スクリプトをインストールして設定するには、次の手順を実行します。

1. サーバ、ホスト、または VM 上で、VMware 用 Sumo Logic スクリプトの Sumo Logic スクリプトを格納するディレクトリを作成します。ディレクトリには /var/log/vmware といった名前を付けることをお勧めします。

2. sumo-vsphere-ulm.zip から Sumo Logic VMware スクリプトをダウンロードし、先ほど作成したディレクトリに格納します。

3. Python バージョン 3.6 以降をインストールします。

4. pyvmomi 6.7.3 をインストールします。pip install pyvmomi==6.7.3 と入力します。

5. Sumo Logic VMware スクリプトを実行するユーザ アカウントに、sumo-vsphere-ulm.zip ファイルが展開されるディレクトリに対する完全な読み取り/書き込み/実行権限があることを確認します。

6. cron_vcenter_events.sh スクリプトを編集して、スクリプトが存在する絶対パスを反映するように SCRIPT_PATH 変数を変更します。
    

A. イベント メッセージの収集

イベントは vCenter Server でイベント メッセージをトリガするアクションです。イベント メッセージはログ記録されませんが、代わりに vCenter Server データベースに格納されます。VMware 用 Sumo Logic Collector は、vSphere python SDK を使用してこれらのメッセージを取得します。

この手順には、次の作業があります。

• ログの収集の設定 - Sumo Logic スクリプトを格納するディレクトリから python スクリプトを実行してテストします。

• syslog またはファイル Source の設定 - Sumo Logic Syslog Source は、syslog サーバのように動作し、syslog メッセージを受信する指定ポートをリッスンします。このスクリプトは、syslog サーバをサポートし、ローカルまたはリモートのファイル Source で取り込めるテキスト ファイルを生成できます。ローカル ファイル Source は、接続の再試行が不要で、ファイルの最後のポインタから読み込む必要もなく、Collector エラー時でもデータが失われないという点で syslog より優れているため、お勧めします。必要に応じて、syslog Source か、ローカルまたはリモート ファイル Source を設定できます。

ログの収集を設定するには、次の手順を実行します。

1. イベントについてのクエリを vCenter Server に対して実行してイベントを Sumo Logic に送信する events.py スクリプトをテストするには、Sumo Logic スクリプトのディレクトリに移動して、次のコマンドで events.py スクリプトを実行します。異なる Source タイプの例を示します。

python3 events.py -s [vcenterserver] -u [username] -p [password] -f output.txt

例 1: ファイル出力を使用。この例ではローカルまたはリモート ファイル Source を使用します。

# python3 $SCRIPT_PATH/events.py -s 192.168.124.29 -t sumologic_host -to sumologic_host_port -u sumoadmin -p sumoadmin -f /var/log/vmware/output/vsphere_events

例 2: syslog と、特定のログ ファイル接頭辞の付いた特定のログ ディレクトリを使用。syslog Source を使用してログを取り込みます。

# python3 $SCRIPT_PATH/events.py -s 192.168.124.29 -t sumologic_host -to sumologic_host_port -u sumoadmin -p sumoadmin -l /var/log/vmware/log/vsphere_events

例 3: syslog と、特定のログ ファイル接頭辞の付いた特定のログ ディレクトリ、そして暗号化されたパスワードを使用。syslog Source を使用してログを取り込みます。

# python3 $SCRIPT_PATH/events.py -s 192.168.124.29 -t sumologic_host -to sumologic_host_port -u sumoadmin -pK 'xgb8NJ3ZYPJbzX6vWHySZbLd73bKWPsGMKoSnry7hL4=' -p 'gAAAAABb6asvlRfxEj_ZQTKOyrqnGNMbfo_kpxrqv4DCO6TorS4FmKFzrepe0_xtiMT67ZT6OOf5bfrVZXNnUDFNlwPWrpFSfg==' -pE True -l /var/log/vmware/log/vsphere_events

デフォルトでは、スクリプトはまず過去 24 時間のデータを収集して、テストの目的で狭い時間範囲のデータを取得します。-bT パラメータは、データ収集を開始する時間 (例: 1 時間前) に設定します。

python3 events.py -s <vcenter server> -t <syslog host> -to <syslog host port> -bT <time>

For Example:

python3 events.py  -s 192.168.23.242 -t vcenterhost -to 1514 -bT '2012-10-08 00:17:00.000+0000'

スクリプトは、以下のパラメータをサポートします。

-s: 接続先のリモート vCenter Server。必須パラメータです。

-o: 使用するリモート vCenter Server ポート (デフォルトは 443)。省略可能。

-u: vCenter Server に接続するために使用するユーザ名。必須。

-p: vCenter Server に接続するために使用するパスワード。必須。

-f: 出力ファイルの接頭辞。ターゲット syslog サーバまたはファイルが必要です。

-ts: タイムスタンプ ファイル。デフォルトは ‘.timelog_events’ です。省略可能。

-t: ターゲット Sumo Logic syslog サーバ。ターゲット syslog サーバまたはファイルが必要です。

-to: 使用するターゲット Sumo Logic ポート (デフォルトは 514)。省略可能。

-bT: イベントのクエリを開始する時間。デフォルトは現在時刻です。

-eT: イベントのクエリを終了する時間。デフォルトは現在時刻の 24 時間前です。

-sC: 接続用の SSL 証明書。省略可能。

-l: ログ ファイル接頭辞。デフォルト: ‘vsphere_events_’。デフォルトでは、実行ディレクトリにログ ファイルが作成されます。フル ログ パスおよび接頭辞も指定できます。例: -l C:\Users\user6\vsphere_events (vsphere_events はログ接頭辞)。ログ ファイルは、接頭辞と現在のタイムスタンプで作成されます。

-pE: パスワードを暗号化するかどうか。デフォルトは false です。省略可能。

-pK: パスワードの暗号化鍵。-pE が true の場合は必須です。

2. 出力に問題がなければ、必須パラメータを使用して cron_vcenter_events.sh を修正し、cron_vcenter_events.sh スクリプトを希望する感覚で定期的に実行する cron ジョブを作成します。

• syslog Source を使用する場合は、Sumo Collector がインストールされているターゲットとターゲット ポートのパラメータを指定してください。ローカルまたはリモート Source を使用する場合は、ファイル パラメータでファイルを生成して、ローカル ファイル Source の場合はファイル パス、リモート ファイル Source の場合はパス式を設定してください。
• cron ジョブは root として実行するか、またはスクリプト ディレクトリへの読み書きアクセス権を持つユーザとして実行する必要があります。
• 詳細については、シェル スクリプトの設定オプションを参照してください。

B. パフォーマンス メトリクスの収集

パフォーマンス メトリクスの収集では、スクリプトを使用して vCenter パフォーマンス API を呼び出し、パフォーマンス統計情報を抽出します。 

vCenter Server に関連付けられた ESXi サーバのパフォーマンス データの収集は、複数のスレッドを使用して、各 ESXi サーバから並行してデータを取得することで可能になります。スレッド数は、収集するデータの量と収集頻度に応じて変わります。

スレッド数は、sumo.json config ファイル内の THREADSIZE_POOL プロパティを使用して制御できます。また 1 つのスレッドによって処理されるオブジェクトの数は、BATCH_MORLIST_SIZE プロパティを使用して制御できます。次はすべての設定プロパティについての説明です。

BATCH_MORLIST_SIZE: Default 50, Simultaneous objects processed by a single thread for retrieving the performance data.
THREADSIZE_POOL: Default 5, Number of threads
SSL_VERIFY: Default False, if using SSL, set as True
SSL_CAPATH: Certificate absolute path if SSL_VERIFY is True

パフォーマンス メトリクスを収集するには、次の手順を実行します。

1. 手順に従って、ストリーミング メトリクス Source を設定します。
   
   
2. 必要に応じて、バンドルされている sumo.json プロパティ ファイル内のプロパティを編集します。
3. Sumo Logic スクリプトのディレクトリに移動し、その場所から次のコマンドを使用して esx_perf_metrics_6_5.py スクリプト (イベントについてのクエリを vCenter Server に対して実行する) を実行します。

python3 esx_perf_metrics_6_5.py -u [username] -p [password] -s [vcenter server] -t [target server] -to [target port] -cf [config filename]

例 1: メトリクス ストリーミング Source と、特定のログ ファイル接頭辞の付いた特定のログ ディレクトリを使用。

# python3 $SCRIPT_PATH/esx_perf_metrics_6_5.py -s 192.168.124.29 -t sumologic_host -to sumologic_host_port -u sumoadmin -p sumoadmin -cf $SCRIPT_PATH/sumo.json -l /var/log/vmware/log/metrics

例 2: 特定のログ ファイル接頭辞の付いた特定のログ ディレクトリと、暗号化されたパスワードを使用。

# python3 $SCRIPT_PATH/esx_perf_metrics_6_5.py -s 192.168.124.29 -t sumologic_host -to sumologic_host_port -u sumoadmin -cf $SCRIPT_PATH/sumo.json -l /var/log/vmware/log/vsphere_metrics -pK 'xgb8NJ3ZYPJbzX6vWHySZbLd73bKWPsGMKoSnry7hL4=' -p 'gAAAAABb6asvlRfxEj_ZQTKOyrqnGNMbfo_kpxrqv4DCO6TorS4FmKFzrepe0_xtiMT67ZT6OOf5bfrVZXNnUDFNlwPWrpFSfg==' -pE True

スクリプトは、以下のパラメータをサポートします。

-s: 接続先のリモート vCenter Server。必須パラメータです。

-o: 使用するリモート vCenter Server ポート (デフォルトは 443)。省略可能。

-u: vCenter Server に接続するために使用するユーザ名。必須。

-p: vCenter Server に接続するために使用するパスワード。必須。

-ts: タイムスタンプ ファイル。デフォルトは ‘.timelog_metrics’ です。

-t: ターゲット Sumo Logic syslog サーバ。必須。

-to: 使用するターゲット Sumo Logic ポート (デフォルトは 514)。省略可能。

-cf: 設定ファイル。必須。

-l: ログ ファイル接頭辞。デフォルト: ‘vsphere_metrics_’。デフォルトでは、実行ディレクトリにログ ファイルが作成されます。フル ログ パスおよびログ接頭辞も指定できます。例: -l C:\Users\user6\vsphere_metrics (vsphere_metrics は必須のログ接頭辞)。ログ ファイルは、接頭辞と現在のタイムスタンプで作成されます。

-pE: パスワードを暗号化するかどうか。デフォルトは false です。省略可能。

-pK: パスワードの暗号化鍵。-pE が true の場合は必須です。

4. Sumo Logic でメトリクスがキャプチャされていることを確認します。
5. バッチとスレッドの設定に問題がなければ、必須パラメータを使用して cron_vcenter_metrics.sh を修正し、cron_vcenter_metrics.sh スクリプトを希望する間隔で定期的に実行する cron ジョブを作成します。

• cron ジョブは root として実行するか、またはスクリプト ディレクトリへの読み書きアクセス権を持つユーザとして実行する必要があります。
• 詳細については、シェル スクリプトの設定オプションを参照してください。

cron_vcenter_metrics.sh スクリプトを (sudo crontab -e オプションを使用して) 15 分おきに実行するサンプル cron ジョブを使用するには、次の行を追加します。

*/15 * * * * /var/log/vmware/cron_vcenter_metrics.sh

C. 履歴イベントの収集

デフォルトでは、events.py が初めて呼び出されるとき、過去 24 時間のイベントが収集されます。スクリプトが呼び出されるたびに、最後に読み込まれたイベントのタイムスタンプを .timelog_events ファイルに書き出し、次の呼び出しに備えます。

過去 24 時間より前のイベントを収集するには、cron_vcenter_events.sh の CRON ジョブをセットアップする前に、次のようにスクリプトを実行します。

python3 events.py -s <vcenter server> -t <syslog host> -to <syslog host port> -bT <time>

syslog サーバには、Sumo Logic Collector がインストールされているマシンの IP アドレスまたはホスト名が反映されている必要があります。syslog_port には、vCenter Server イベントを収集する Source にセットアップしたポート番号が反映されている必要があります。たとえば、2012 年 10 月 8 日 5:00 pm からすべてのイベントを収集する場合は、次のコマンドを実行します。

python3 events.py  -s 192.168.23.242 -t vcenterhost -to 1514 -bT '2012-10-08 00:17:00.000+0000'

このコマンドが正常に完了したら、cron ジョブをセットアップして進行中のイベントを取得できます。

暗号化されたパスワードと鍵を含めるようにスクリプトを変更します。 

メトリクスの例:

python3 esx_perf_metrics_6_5.py -u [username] -pK 'xgb8NJ3ZYPJbzX6vWHySZbLd73bKWPsGMKoSnry7hL4=' -p 'gAAAAABb6asvlRfxEj_ZQTKOyrqnGNMbfo_kpxrqv4DCO6TorS4FmKFzrepe0_xtiMT67ZT6OOf5bfrVZXNnUDFNlwPWrpFSfg==' -s 192.168.20.121 -t 127.0.0.1 -to 2003 -cf sumo.json -pE True

イベントの例:

python3 events.py -s 192.168.20.121 -u [username] -f outfile -pK 'xgb8NJ3ZYPJbzX6vWHySZbLd73bKWPsGMKoSnry7hL4=' -p 'gAAAAABb6asvlRfxEj_ZQTKOyrqnGNMbfo_kpxrqv4DCO6TorS4FmKFzrepe0_xtiMT67ZT6OOf5bfrVZXNnUDFNlwPWrpFSfg==' -pE True