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 옵션을 모두 지정한 경우에는 duration 옵션을 사용할 수 없습니다.

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
   

2. GC 문제 항목만 빠르게 조회

   system-gc-logs fastcheck=t
   

3. 최근 1시간의 GC 로그 조회

   system-gc-logs duration=1h
   

4. Full GC 발생 빈도 분석

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

호환성

system-gc-logs 명령어는 소나 4.0.2511.0 버전부터 제공되었습니다.