system-gc-logs

JVMのGCログエントリを照会します。クラスター管理者権限が必要です。

コマンドプロパティ

構文

オプション

fastcheck=BOOL

GC問題が疑われる行のみを素早く検査して出力します。tを指定すると、Allocation Stall、To-space Exhausted、Pause Fullタイプの行のみを出力します。（デフォルト：f）

duration=INT{mon|w|d|h|m|s}

現在時刻から指定した時間範囲内のGCログのみを照会します。mon（月）、w（週）、d（日）、h（時）、m（分）、s（秒）の単位を使用します。例：10sはクエリ実行時刻を基準に直近10秒を意味します。fromとtoを両方指定した場合は使用できません。

from=DATE

照会範囲の開始時刻。yyyy[MM[dd[HH[mm[ss]]]]]形式で入力します。月・日などを省略した場合は可能な最初の時刻が設定されます。開始時刻は照会結果に含まれます。

to=DATE

照会範囲の終了時刻。yyyy[MM[dd[HH[mm[ss]]]]]形式で入力します。月・日などを省略した場合は可能な最初の時刻が設定されます。終了時刻は照会結果に含まれません。

出力フィールド

エラーコード

パースエラー

ランタイムエラー

該当なし

説明

system-gc-logsコマンドは、JVMのGCログファイル（gc.log）を読み取り、GCログエントリを照会します。

fastcheck=tオプションを使用すると、GC問題が疑われるエントリ（Allocation Stall、To-space Exhausted、Pause Full）のみを選別して素早く照会できます。fastcheck=tの場合、typeフィールドに該当タイプが返され、GC実行時間がある場合はdurationフィールドにミリ秒単位で返されます。

fromとtoオプションで時間範囲を指定すると、その範囲に含まれるGCログファイルのみを選択的に読み取ります。

このコマンドを実行するにはクラスター管理者権限が必要です。

使用例

1. すべてのGCログを照会する

   system-gc-logs
   

   JVMのすべてのGCログを照会します。

2. GC問題エントリのみを素早く照会する

   system-gc-logs fastcheck=t
   

   Allocation Stall、To-space Exhausted、Pause FullタイプのGCログのみを照会します。

3. 直近1時間のGCログを照会する

   system-gc-logs duration=1h
   

   直近1時間以内のGCログを照会します。

4. Full GC発生頻度を分析する

   system-gc-logs fastcheck=t duration=1d
   | search type == "FULL_GC"
   | stats count() as cnt, avg(duration) as avg_ms
   

   直近1日間のFull GC発生回数と平均実行時間を照会します。