概要

このセクションでは、システムや Wrapper プロセスや JVM のパフォーマンス統計の表を 出力するために使用できるプロパティについて説明します。 この統計は、バージョン 3.5.52 で追加され、JVM のハングが検出された場合などの問題を理解するのに役立ちます。

統計情報は、Wrapper の将来のバージョンで変更される可能性がありますが、現在はメモリと CPU の使用量が含まれています。 その情報は、Wrapper によって定期的に収集され、特定のイベントが発生したときにさかのぼって出力されます。 これにより、問題が発生する前の特定の期間に何が起こったかを分析できます。ログに含まれていると、 テクニカルサポートに役立つ情報になります。


統計の生成のトリガー：

「STATS」キーワードは、任意のアクションプロパティの値で使用することができ、 統計をいつ出力するかを設定できます。

設定例：毎日午前 1:00 に統計を出力します。 
wrapper.timer.1.action=STATS
wrapper.timer.1.interval=hour=1

コマンドファイルで「STATS」キーワードを使用して、いつでも統計の出力をトリガーすることもできます。


次のプロパティを使用して、統計の出力方法を設定できます。

注意

この機能は現在 Windows でのみ利用可能ですが、リクエストに応じて他のプラットフォームに追加できます。

wrapper.stats.enable プロパティ
対応バージョン :3.5.52
対応エディション :プロフェッショナル版スタンダード版コミュニティー版 (未対応)
対応プラットフォーム :WindowsMac OSX (未対応)Linux (未対応)IBM AIX (未対応)FreeBSD (未対応)HP-UX (未対応)Solaris (未対応)IBM z/OS (未対応)IBM z/Linux (未対応)

このプロパティを使用して、パフォーマンス統計を出力する機能を有効または無効にすることができます。 「FALSE」に設定すると、統計は収集されません。

統計収集は、Wrapper 実行中のパフォーマンスへ無視できるわずかな影響を与えるように最適化されています。 ほとんどの場合、このプロパティの「TRUE」のままにしておくことをお勧めします。 そうしないと、問題が発生したときに情報を解析することができません。 パフォーマンス関連の問題はまれですが、再現が難しいことが多いため、後で何が起こったかを調べることができることは重要です。

デフォルト値は、「TRUE」です。

例： 統計を無効にする。 
wrapper.stats.enable=FALSE

wrapper.stats.system.enable プロパティ
対応バージョン :3.5.52
対応エディション :プロフェッショナル版スタンダード版コミュニティー版 (未対応)
対応プラットフォーム :WindowsMac OSX (未対応)Linux (未対応)IBM AIX (未対応)FreeBSD (未対応)HP-UX (未対応)Solaris (未対応)IBM z/OS (未対応)IBM z/Linux (未対応)

このプロパティを使用して、システムのパフォーマンス統計を出力する機能を有効または無効にすることができます。 現在、「物理メモリ」、「コミット済み」、及び「キャッシュ済み」 情報がシステム統計に含まれています。

［wrapper.stats.enable］を「FALSE」に設定すると、このプロパティは無視されます。

デフォルト値は、「TRUE」です。

出力例： 
wrapper  | System:
wrapper  |                          Physical         Committed          Cache
wrapper  | -------------------------------------------------------------------
wrapper  | 12:00:44 - 12:00:54 |  13.0 GB (41%)  |  14.4 GB (39%)   |   3.5 GB
wrapper  | 12:00:54 - 12:01:04 |  13.0 GB (41%)  |  14.5 GB (39%)   |   3.5 GB
wrapper  | 12:01:04 - 12:01:14 |  12.9 GB (40%)  |  14.4 GB (39%)   |   3.5 GB
wrapper  | 12:01:14 - 12:01:24 |  12.8 GB (40%)  |  14.2 GB (38%)   |   3.5 GB
wrapper  | 12:01:24 - 12:01:34 |  12.8 GB (40%)  |  14.2 GB (39%)   |   3.5 GB
wrapper  | 12:01:34 - 12:01:44 |  12.8 GB (40%)  |  14.2 GB (38%)   |   3.5 GB
wrapper  | 12:01:44 - 12:01:54 |  12.8 GB (40%)  |  14.2 GB (38%)   |   3.5 GB
wrapper  | 12:01:54 - 12:02:04 |  12.8 GB (40%)  |  14.2 GB (38%)   |   3.5 GB
wrapper  | 12:02:04 - 12:02:14 |  12.7 GB (40%)  |  14.1 GB (38%)   |   3.5 GB
wrapper  | 12:02:14 - 12:02:20 |  12.7 GB (40%)  |  14.1 GB (38%)   |   3.5 GB

wrapper.stats.wrapper.enable プロパティ
対応バージョン :3.5.52
対応エディション :プロフェッショナル版スタンダード版コミュニティー版 (未対応)
対応プラットフォーム :WindowsMac OSX (未対応)Linux (未対応)IBM AIX (未対応)FreeBSD (未対応)HP-UX (未対応)Solaris (未対応)IBM z/OS (未対応)IBM z/Linux (未対応)

このプロパティを使用して、Wrapper プロセスのパフォーマンス統計を出力する機能を有効または無効にすることができます。

［wrapper.stats.enable］を「FALSE」に設定すると、このプロパティは無視されます。

次の情報が出力されます。

  • 「CPU 使用率」（CPU）をパーセンテージ形式で表示

  • 「ワーキングセット」（Work. set）物理メモリー領域の中で Wrapper プロセスが現在使用している状態の領域

  • 「ページプール」（Paged）物理メモリからページングファイル (ディスク）にページアウトできるカーネル領域およびデバイス ドライバーメモリ領域

  • 「非ページプール」（Non-paged）物理メモリからページングファイル (ディスク) にページアウトできないカーネル領域およびデバイスドライバーメモリ領域

  • 「コミット済み」 （Committed）Wrapper プロセスが使用を要求したメモリ領域

デフォルト値は、「TRUE」です。

出力例： 
wrapper  | Wrapper process:
wrapper  |                        CPU   Work. set    Paged    Non-paged  Committed
wrapper  | -----------------------------------------------------------------------
wrapper  | 12:00:14 - 12:00:24 |  0.0% |  11.7 MB | 160.6 KB |  16.0 KB |   3.0 MB
wrapper  | 12:00:24 - 12:00:34 |  0.0% |  11.7 MB | 160.6 KB |  16.0 KB |   3.0 MB
wrapper  | 12:00:34 - 12:00:44 |  0.0% |  11.7 MB | 160.6 KB |  16.0 KB |   3.0 MB
wrapper  | 12:00:44 - 12:00:54 |  0.0% |  11.7 MB | 160.6 KB |  16.0 KB |   3.0 MB
wrapper  | 12:00:54 - 12:01:04 |  0.0% |  11.7 MB | 160.6 KB |  16.0 KB |   3.0 MB
wrapper  | 12:01:04 - 12:01:14 |  0.0% |  11.7 MB | 160.6 KB |  16.0 KB |   3.0 MB
wrapper  | 12:01:14 - 12:01:24 |  0.0% |  11.7 MB | 160.6 KB |  16.0 KB |   3.0 MB
wrapper  | 12:01:24 - 12:01:34 |  0.0% |  11.7 MB | 160.6 KB |  16.0 KB |   3.0 MB
wrapper  | 12:01:34 - 12:01:44 |  0.0% |  11.7 MB | 160.6 KB |  16.0 KB |   3.0 MB
wrapper  | 12:01:44 - 12:01:45 |  0.0% |  11.7 MB | 160.6 KB |  16.0 KB |   3.0 MB

wrapper.stats.java.enable プロパティ
対応バージョン :3.5.52
対応エディション :プロフェッショナル版スタンダード版コミュニティー版 (未対応)
対応プラットフォーム :WindowsMac OSX (未対応)Linux (未対応)IBM AIX (未対応)FreeBSD (未対応)HP-UX (未対応)Solaris (未対応)IBM z/OS (未対応)IBM z/Linux (未対応)

このプロパティを使用して、JVM（Java プロセス）のパフォーマンス統計を出力する機能を有効または無効にすることができます。

wrapper.stats.enable］を「FALSE」に設定すると、このプロパティは無視されます。

次の情報が出力されます。

  • 「CPU 使用率」（パーセンテージ表示）。

  • 「ワーキングセット」（物理メモリー領域の中で Wrapper プロセスが現在使用している状態の領域）。

  • 「ページプール」（物理メモリからページングファイル (ディスク）にページアウトできるカーネル領域およびデバイス ドライバーメモリ領域）。

  • 「非ページプール」（物理メモリからページングファイル (ディスク) にページアウトできないカーネル領域およびデバイスドライバーメモリ領域）。

  • 「コミット済み」 Wrapper プロセスが使用を要求したメモリ領域。

デフォルト値は、「TRUE」です。

出力例： 
wrapper  | Java process:
wrapper  |                        CPU   Work. set    Paged    Non-paged  Committed     Page Faults
wrapper  | -------------------------------------------------------------------------------------------
wrapper  | 12:00:14 - 12:00:24 |  0.0% |  68.4 MB | 527.5 KB |  29.2 KB | 631.5 MB | ########        38
wrapper  | 12:00:24 - 12:00:34 |  0.0% |  68.4 MB | 527.5 KB |  29.2 KB | 631.5 MB |                  0
wrapper  | 12:00:34 - 12:00:44 |  0.0% |  68.4 MB | 527.5 KB |  29.2 KB | 631.5 MB | #                1
wrapper  | 12:00:44 - 12:00:54 |  0.0% |  68.4 MB | 527.5 KB |  29.2 KB | 631.5 MB | #                1
wrapper  | 12:00:54 - 12:01:04 |  0.0% |  68.4 MB | 527.5 KB |  29.2 KB | 631.5 MB |                  0
wrapper  | 12:01:04 - 12:01:14 |  0.0% |  68.5 MB | 527.5 KB |  29.2 KB | 631.5 MB | #                3
wrapper  | 12:01:14 - 12:01:24 |  0.0% |  68.6 MB | 529.0 KB |  29.2 KB | 631.5 MB | ######          24
wrapper  | 12:01:24 - 12:01:34 |  0.0% |  68.6 MB | 529.0 KB |  29.2 KB | 631.5 MB |                  0
wrapper  | 12:01:34 - 12:01:44 |  0.0% |  68.6 MB | 529.0 KB |  29.2 KB | 631.5 MB | #                1
wrapper  | 12:01:44 - 12:01:45 |  0.0% |  68.6 MB | 529.0 KB |  29.2 KB | 631.5 MB |                  0

wrapper.stats.lines プロパティ
対応バージョン :3.5.52
対応エディション :プロフェッショナル版スタンダード版コミュニティー版 (未対応)
対応プラットフォーム :WindowsMac OSX (未対応)Linux (未対応)IBM AIX (未対応)FreeBSD (未対応)HP-UX (未対応)Solaris (未対応)IBM z/OS (未対応)IBM z/Linux (未対応)

このプロパティを使用して、統計表ごとに出力される最大行数を指定します。

このプロパティの値を大きくすると、ログ出力が増えることに注意してください。 この値は、［wrapper.stats.interval］とバランスをとって、テーブルごとに適切な行数を維持しながら、適切な期間のパフォーマンスを観察できます。

有効な値は、「1」〜「60」の範囲です。

デフォルト値は、「10」です。

設定例：5行に制限する。 
wrapper.stats.lines=5

wrapper.stats.interval プロパティ
対応バージョン :3.5.52
対応エディション :プロフェッショナル版スタンダード版コミュニティー版 (未対応)
対応プラットフォーム :WindowsMac OSX (未対応)Linux (未対応)IBM AIX (未対応)FreeBSD (未対応)HP-UX (未対応)Solaris (未対応)IBM z/OS (未対応)IBM z/Linux (未対応)

このプロパティは、統計が収集される間隔を秒単位で指定します。 各間隔の開始時間と終了時間は、テーブルの最初の列で確認できます。

有効な値は、「1〜86400」の範囲です（１秒〜１日）です。

デフォルト値は、 [wrapper.shutdown.timeout] の3分の1（デフォルトで10秒）です。

注意

CPU 使用率は、間隔全体の平均に基づいて計算されます。

ページフォールトカウント（Java プロセスの場合）は、1つの間隔中のページフォールトの合計数です。

設定例：

例１：1 分の間隔で、合計 1 時間。 
wrapper.stats.interval=60
wrapper.stats.lines=60

例２：1 時間間隔で合計 1 日、毎日午前 0 時に出力。 
wrapper.stats.interval=3600
wrapper.stats.lines=24
wrapper.timer.1.action=STATS
wrapper.timer.1.interval=hour=0

wrapper.stats_on_failed_jvm_exit プロパティ
対応バージョン :3.5.52
対応エディション :プロフェッショナル版スタンダード版コミュニティー版 (未対応)
対応プラットフォーム :WindowsMac OSX (未対応)Linux (未対応)IBM AIX (未対応)FreeBSD (未対応)HP-UX (未対応)Solaris (未対応)IBM z/OS (未対応)IBM z/Linux (未対応)

このプロパティは、Wrapper が JVM のハングを検出したときに統計を出力するかどうかを設定します。 ［wrapper.request_thread_dump_on_failed_jvm_exit］と同様で、 ハングした JVM と同じ状況でスレッドダンプを起こします。

このプロパティを「TRUE」に設定すると、統計情報はスレッドダンプ（要求された場合）の前に出力され、それ自体は JVM プロセスが 終了される前に発生します。

デフォルト値は「TRUE」です。