IBM Support

ガーベッジ・コレクションの詳細ログ
(verbosegcログ)を設定する手順

Question & Answer


Question

ガーベッジ・コレクション

Answer

この文書は、WebSphere Application Server環境で、 Java ガーベッジ・コレクション詳細ログ(verbosegcログ)の設定方法を説明しています。

問題調査に必要な資料と取得方法 WebSphere Application Server(以下、WAS) において、パフォーマンスチューニングやトラブルシューティングでJava ガーベッジ・コレクションの詳細ログが必要になります。 このガイドはさまざまなバージョンのアプリケーション・サーバーで異なる、verbosegcログの採取設定方法を解説します。verbosegcのログを有効にすることで、ガーベッジ・コレクション発生時に数行の統計情報が出力されます。この統計情報の計算はログの設定にかかわらず内部で行われているため、verbosegcログの設定によるパフォーマンスインパクトはごくわずかです。 採取されたログの解析によりパフォーマンスの改善も期待できます。

verbosegcの詳細ログは以下の情報を提供します。
- 実行時に発生した Allocation Failure(Java Heapが不足してObjectの生成ができない)事象のシーケンス番号
- 前回のAllocation Failureからの経過時間
- 足りない状態でのフリーエリアのバイト数とその時のJava Heap全体のバイト数
- ガーベッジ・コレクション事象シーケンス番号と開始時間
- ガーベッジ・コレクションでフリーできたバイト数とそれに要した時間
- ガーベッジ・コレクションに要した時間の各コレクションフェーズ毎(Mark, Sweep, Compaction)の経過時間
- Compaction (圧縮)で移動したオブジェクトの数とバイト数
- Java Heapの拡張 (-Xmxに達していない場合)
- ガーベッジ・コレクションに先立ち全てのThreadの 一時停止に要した時間 (200ミリ秒以上の時に記録されます




目次
■ WAS V8.5/V8.0/V7.0 アプリケーション・サーバー
■ WAS V6.1アプリケーション・サーバー
■ WAS V8.5/V8.0/V7.0/V6.1デプロイメント・マネージャー
■ WAS V8.5/V8.0/V7.0/V6.1ノード・エージェント 
■ ランタイム環境への変更 
当文書は、下記technoteを参考に作成しています。

Enabling verbose garbage collection (verbosegc) in WebSphere Application Server
http://www-01.ibm.com/support/docview.wss?uid=swg21114927




■ WAS V8.5/V8.0/V7.0 アプリケーション・サーバー

■ WAS V8.5/V8.0/V7.0 アプリケーション・サーバー

  1. 管理コンソールで 「サーバー」 > 「サーバー・タイプ」 > 「WebSphere Application Server」 をクリックします。
  2. サーバー名一覧から該当のアプリケーションサーバー名をクリックします。
  3. 構成タブで、サーバー・インフラストラクチャーの下に表示されている「Javaおよびプロセス管理」 > 「プロセス定義」の順にクリックします。
  4. 追加プロパティーの下の「Java仮想マシン」をクリックします。
  5. 『冗長ガーベッジ・コレクション』 チェック・ボックスに選択します。
  6. 適用ボタンをクリックします。
  7. ページの上部に表示された、"ローカル構成が変更されました。『保存』をクリックして、変更をマスター構成に適用します。" の保管をクリックし構成を保管します。
    ※Solarisシステム or HPシステムでは、下記JVM引数(注釈*1)の設定が必要になります。
  8. アプリケーション・サーバーを停止し、再起動します。
  9. ご使用のOS環境でガーベッジ・コレクション詳細ログの出力先が変わります。
    AIX, Microsoft Windows, or Linux:
      native_stderr.log
    Solaris or HP-UX:
      native_stdout.log

    注釈*1
    • Solarisシステム or HPシステムでは、以下のパラメータを Java仮想マシンページの"汎用JVM引数"に追加します。

    • (必ず1行で入力します。)
      -XX:+PrintGCDetails -XX:+PrintGCDateStamps -XX:+PrintHeapAtGC
      ※-XX:+PrintHeapAtGC オプションは出力データが多いため、必ずディスクスペースをご確認ください。

      汎用JVM引数の設定は、InfoCenterJava 仮想マシン設定をご確認ください。
      ※InfoCenterリンクは、V8.5となっていますが、V8.0/V7.0も同様の設定手順になります。


■ WAS V6.1アプリケーション・サーバー.

■ WAS V6.1アプリケーション・サーバー

  1. 管理コンソールで 「サーバー」 > 「アプリケーション・サーバー」をクリックします。
  2. サーバー名一覧から該当のアプリケーションサーバー名をクリックします。
  3. 構成タブで、サーバー・インフラストラクチャーの下に表示されている「Javaおよびプロセス管理」 > 「プロセス定義」「の順にクリックします。
  4. 追加プロパティーの下のJava仮想マシンをクリックします。
  5. 『冗長ガーベッジ・コレクション』 チェック・ボックスに選択します。
  6. 適用ボタンをクリックします。
  7. ページの上部に表示された、"ローカル構成が変更されました。『保管』をクリックして、変更をマスター構成に適用します。" の保管をクリックし構成を保管します。
    ※Solarisシステム or HPシステムでは、下記JVM引数(注釈*1)の設定が必要になります。
  8. アプリケーション・サーバーを停止し、再起動します。
  9. ご使用のOS環境でガーベッジ・コレクション詳細ログの出力先が変わります。
    AIX, Microsoft Windows, or Linux:
      native_stderr.log
    Solaris or HP-UX:
      native_stdout.log

    注釈*1
    • Solarisシステム or HPシステムでは、以下のパラメータを Java仮想マシンページの"汎用JVM引数"に追加します。

    • (必ず1行で入力します。)
      -XX:+PrintGCDetails -XX:+PrintGCTimeStamps -XX:+PrintHeapAtGC
      ※-XX:+PrintHeapAtGC オプションは出力データが多いため、必ずディスクスペースをご確認ください。

      汎用JVM引数の設定は、InfoCenterJava 仮想マシン設定をご確認ください。


■ WAS V8.5/V8.0/V7.0/V6.1デプロイメント・マネージャー

■ WAS V8.5/V8.0/V7.0/V6.1デプロイメント・マネージャー

  1. 管理コンソールで 「システム管理」 > 「デプロイメント・マネージャー」 をクリックします。
  2. 構成タブで、サーバー・インフラストラクチャーの下に表示されている「Javaおよびプロセス管理」 > 「プロセス定義」の順にクリックします。
  3. 追加プロパティーの下の「Java仮想マシン」をクリックします。
  4. 『冗長ガーベッジ・コレクション』 チェック・ボックスに選択します。
  5. 適用ボタンをクリックします。
  6. ページの上部に表示された、"ローカル構成が変更されました。『保存』をクリックして、変更をマスター構成に適用します。" の保管をクリックし構成を保管します。
    ※Solarisシステム or HPシステムでは、下記JVM引数(注釈*1)の設定が必要になります。
  7. デプロイメント・マネージャーを停止し、再起動します。
  8. ご使用のOS環境でガーベッジ・コレクション詳細ログの出力先が変わります。
    AIX, Microsoft Windows, or Linux:
      native_stderr.log
    Solaris or HP-UX:
      native_stdout.log

    注釈*1
    • Solarisシステム or HPシステムでは、以下のパラメータを Java仮想マシンページの"汎用JVM引数"に追加します。

    • (必ず1行で入力します。お使いのバージョンをご確認ください。)
      WAS V8.5/V8.0/V7.0:
      -XX:+PrintGCDetails -XX:+PrintGCDateStamps -XX:+PrintHeapAtGC

      WAS V6.1:
      -XX:+PrintGCDetails -XX:+PrintGCTimeStamps -XX:+PrintHeapAtGC

      ※-XX:+PrintHeapAtGC オプションは出力データが多いため、必ずディスクスペースをご確認ください。

      汎用JVM引数の設定は、InfoCenterJava 仮想マシン設定をご確認ください。
      ※InfoCenterリンクは、V8.5となっていますが、V8.0/V7.0/V6.1も同様の設定手順になります。
      ※デプロイメント・マネージャーの設定は、「システム管理」>「デプロイメント・マネージャー」から行います。



WAS V8.5/V8.0/V7.0/V6.1ノード・エージェント

■ WAS V8.5/V8.0/V7.0/V6.1ノード・エージェント

  1. 管理コンソールで 「システム管理」 > 「ノード・エージェント」 をクリックします。
  2. ノード・エージェント一覧から該当ノードのノード・エージェントをクリックします。
  3. 構成タブで、サーバー・インフラストラクチャーの下に表示されている「Javaおよびプロセス管理」 > 「プロセス定義」の順にクリックします。
  4. 追加プロパティーの下の「Java仮想マシン」をクリックします。
  5. 『冗長ガーベッジ・コレクション』 チェック・ボックスに選択します。
  6. 適用ボタンをクリックします。
  7. ページの上部に表示された、"ローカル構成が変更されました。『保存』をクリックして、変更をマスター構成に適用します。" の保管をクリックし構成を保管します。
    ※Solarisシステム or HPシステムでは、下記JVM引数(注釈*1)の設定が必要になります。
  8. ノード・エージェントを停止し、再起動します。
  9. ご使用のOS環境でガーベッジ・コレクション詳細ログの出力先が変わります。
    AIX, Microsoft Windows, or Linux:
      native_stderr.log
    Solaris or HP-UX:
      native_stdout.log

    注釈*1
    • Solarisシステム or HPシステムでは、以下のパラメータを Java仮想マシンページの"汎用JVM引数"に追加します。

    • (必ず1行で入力します。)
      -XX:+PrintGCDetails -XX:+PrintGCDateStamps -XX:+PrintHeapAtGC

      汎用JVM引数の設定は、InfoCenterJava 仮想マシン設定をご確認ください。
      ※InfoCenterリンクは、V8.5となっていますが、V8.0/V7.0/V6.1も同様の設定手順になります。
      ※ノード・エージェントの設定は、「システム管理」>「ノード・エージェント」>「node_agent_name」から行います。



■ ランタイム環境への変更

※Java仮想マシンまでのステップについては、上記該当項目をご参照ください。
  1. 追加プロパティーの下の「Java仮想マシン」をクリックします。
  2. ランタイムタブで、『冗長ガーベッジ・コレクション』 チェック・ボックスに選択します。
  3. OKボタン(もしくは、適用ボタン)をクリックします。
    ※OKボタン(もしくは、適用ボタン)をクリックした時点でログが出力されます。
    AIX, Microsoft Windows, or Linux:
    native_stderr.log

[{"Product":{"code":"SSEQTP","label":"WebSphere Application Server"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Not Applicable","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF012","label":"IBM i"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"8.5;8.0;7.0;6.1","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
15 June 2018

UID

swg21621175