system-memory-pools

힙과 오프힙 메모리의 현황을 조회합니다. 조회 범위를 지정하면 오프힙 내 메모리 풀 또는 오브젝트 정보를 조회할 수 있습니다.

명령어 속성

문법

옵션

scope={pools|objects}

오프힙 내 세부 조회 범위를 지정합니다. 지정하지 않으면 힙과 오프힙의 요약 정보를 각각 한 건씩 반환합니다.

• pools: 오프힙 메모리 풀별 사용량 및 가용 용량을 조회합니다. system-offheap-pools 명령어와 동일한 결과를 반환합니다.
• objects: 오프힙 메모리에 할당된 오브젝트 정보를 조회합니다. system-memory-objects 명령어와 동일한 결과를 반환합니다.

출력 필드

scope를 지정하지 않은 경우:

scope=pools인 경우:

scope=objects인 경우:

오류 코드

파싱 오류

런타임 오류

설명

system-memory-pools 명령어는 시스템 메모리 정보를 조회합니다. scope 옵션을 지정하지 않으면 JVM 힙과 오프힙 영역의 요약 정보를 각각 한 건씩 반환합니다. 힙 레코드(type=heap)는 JVM Runtime에서 보고하는 여유 메모리(free)와 전체 메모리(total) 근사치를 포함합니다. 오프힙 레코드(type=offheap)는 다이렉트 버퍼 영역의 오브젝트 수와 총 수용 가능 오브젝트 수를 포함합니다.

scope=pools를 지정하면 오프힙 메모리 풀별 사용량과 가용 용량을 조회합니다. scope=objects를 지정하면 오프힙에 할당된 오브젝트 이름과 사용 중인 메모리 용량을 조회합니다. 각 모드는 system-offheap-pools 및 system-memory-objects 명령어와 동일한 결과를 반환합니다.

사용 예

1. 힙과 오프힙 메모리 요약 조회

   system-memory-pools
   

2. 오프힙 메모리 풀 사용 현황 조회

   system-memory-pools scope=pools
   

3. 오프힙 오브젝트 정보 조회

   system-memory-pools scope=objects
   

4. 힙 메모리 사용률 계산

   system-memory-pools
   | search type = "heap"
   | eval used = total - free
   | eval used_pct = round(used * 100 / total, 1)
   | fields type, used, total, used_pct
   

호환성

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