java.lang.management
인터페이스 ThreadMXBean

public interface ThreadMXBean

Java 가상 머신의 thread 시스템의 관리 인터페이스입니다.

Java 가상 머신은 이 인터페이스의 구현 클래스의 단일 인스턴스를 가집니다. 이 인터페이스를 구현하고 있는 인스턴스는 ManagementFactory.getThreadMXBean() 메서드를 호출해 취득할 수 있다, 혹은 platform MBeanServer 메서드로부터 취득할 수 있는 MXBean 입니다.

MBeanServer 내에서 thread 시스템의 MXBean를 일의에 식별하기 위한 ObjectName는 이하대로입니다.

java.lang:type=Threading

thread ID

thread ID는 thread의 Thread.getId() 메서드의 호출에 의해 리턴된 정의 long 형의 값입니다. thread ID는 일의이며, 그 수명을 통해서 변경될 것은 없습니다. thread가 종료하면, thread ID는 재이용 가능합니다.

이 인터페이스의 일부의 메서드는 입력 파라미터로서 thread ID 또는 thread ID 배열을 취득해 thread마다의 정보를 리턴합니다.

thread CPU 시간

Java 가상 머신의 구현에서는 임의의 thread나 thread 이외에 붙어, 현재의 thread의 CPU 시간의 측정을 지원 할 수 있습니다.

isThreadCpuTimeSupported() 메서드를 사용해, Java 가상 머신이 임의의 thread에 대해 CPU 시간의 측정을 지원 할지 어떨지를 판정할 수 있습니다. 또한, isCurrentThreadCpuTimeSupported() 메서드를 사용해, Java 가상 머신이 현재의 thread의 CPU 시간의 측정을 지원 하고 있을지 어떨지를 판정할 수 있습니다. 임의의 thread의 CPU 시간의 측정을 지원 하고 있는 Java 가상 머신의 구현은 현재의 thread의 CPU 시간의 측정도 지원 하고 있습니다.

이 인터페이스로 제공된 CPU 시간은 나노초단위의 정밀도를 제공합니다만, 반드시 나노초의 정확도가 아닙니다.

Java 가상 머신에서는 디폴트로 CPU 시간의 측정을 무효로 할 수 있습니다. isThreadCpuTimeEnabled() 메서드와 setThreadCpuTimeEnabled(boolean) 메서드를 사용해, CPU 시간 측정이 유효하게 되어 있는 것을 테스트하거나 측정의 지원를 유효 또는 무효로 하거나 할 수 있습니다 . thread CPU 측정을 유효하게 하면, 일부의 Java 가상 머신의 구현에서는 부하가 커질 가능성이 있습니다.

thread 컨텐션 감시

일부의 Java 가상 머신은 thread 컨텐션 감시를 지원 합니다. isThreadContentionMonitoringSupported() 메서드를 사용해, Java 가상 머신이 thread 컨텐션 감시를 지원 하고 있을지 어떨지를 판정할 수 있습니다. thread 컨텐션 감시는 디폴트로 무효입니다. setThreadContentionMonitoringEnabled(boolean) 메서드를 사용해, thread 컨텐션 감시를 유효하게 할 수 있습니다 .

도입된 버전 :

1.5

관련 항목:

JMX Specification, Ways to Access MXBeans

메서드 개요

long[]	findMonitorDeadlockedThreads () 객체 모니터의 취득을 대기하고 있어 데드 록 상태에 있는 thread의 사이클을 검색합니다.
long[]	getAllThreadIds () 모든 라이브 thread의 ID를 리턴합니다.
long	getCurrentThreadCpuTime () 현재의 thread의 합계 CPU 시간을 나노초단위로 리턴합니다.
long	getCurrentThreadUserTime () 현재의 thread가 사용자 모드로 실행한 CPU 시간 (나노초단위)을 리턴합니다.
int	getDaemonThreadCount () 라이브 demon thread의 현재의 수를 리턴합니다.
int	getPeakThreadCount () Java 가상 머신이 시작된 이후의, 또는 피크가 리셋 된 이후의, 피크 라이브 thread 카운트를 리턴합니다.
int	getThreadCount () demon thread와 demon 이외의 thread를 포함한 라이브 thread의 현재의 수를 리턴합니다.
long	getThreadCpuTime (long id) 지정된 ID thread의 합계 CPU 시간 (나노초단위)을 리턴합니다.
ThreadInfo	getThreadInfo (long id) 스택 트레이스를 가지지 않는 지정된 id thread의 thread 정보를 리턴합니다.
ThreadInfo []	getThreadInfo (long[] ids) 스택 트레이스를 가지지 않는 입력 배열 ids에 있는 ID를 가지는 thread마다의 thread 정보를 리턴합니다.
ThreadInfo []	getThreadInfo (long[] ids, int maxDepth) 입력 배열 ids에 ID를 가지는 각 thread의 thread 정보를 리턴합니다.
ThreadInfo	getThreadInfo (long id, int maxDepth) 지정된 id thread의 thread 정보를 리턴합니다.
long	getThreadUserTime (long id) 지정된 ID thread가 사용자 모드로 실행한 CPU 시간 (나노초단위)을 리턴합니다.
long	getTotalStartedThreadCount () Java 가상 머신이 시작하고 나서 작성 및 시작된 thread의 합계수를 리턴합니다.
boolean	isCurrentThreadCpuTimeSupported () Java 가상 머신이 현재의 thread의 CPU 시간 측정을 지원 할지 어떨지를 테스트합니다.
boolean	isThreadContentionMonitoringEnabled () thread 컨텐션 감시가 유효한가 어떤가를 테스트합니다.
boolean	isThreadContentionMonitoringSupported () Java 가상 머신이 thread 컨텐션 감시를 지원 할지 어떨지를 테스트합니다.
boolean	isThreadCpuTimeEnabled () thread의 CPU 시간 측정이 유효한가 어떤가를 테스트합니다.
boolean	isThreadCpuTimeSupported () Java 가상 머신의 구현이 임의의 thread의 CPU 시간 측정을 지원 할지 어떨지를 테스트합니다.
void	resetPeakThreadCount () 피크 thread 카운트를 라이브 thread의 현재의 수에 리셋 합니다.
void	setThreadContentionMonitoringEnabled (boolean enable) thread 컨텐션 감시를 유효 또는 무효로 합니다.
void	setThreadCpuTimeEnabled (boolean enable) thread의 CPU 시간 측정을 유효 또는 무효로 합니다.

메서드의 상세

getThreadCount

int getThreadCount()

demon thread와 demon 이외의 thread를 포함한 라이브 thread의 현재의 수를 리턴합니다.

반환값:

라이브 thread의 현재의 수

getPeakThreadCount

int getPeakThreadCount()

Java 가상 머신이 시작된 이후의, 또는 피크가 리셋 된 이후의, 피크 라이브 thread 카운트를 리턴합니다.

반환값:

피크 라이브 thread 카운트

getTotalStartedThreadCount

long getTotalStartedThreadCount()

Java 가상 머신이 시작하고 나서 작성 및 시작된 thread의 합계수를 리턴합니다.

반환값:

시작된 thread의 합계수

getDaemonThreadCount

int getDaemonThreadCount()

라이브 demon thread의 현재의 수를 리턴합니다.

반환값:

라이브 demon thread의 현재의 수

getAllThreadIds

long[] getAllThreadIds()

모든 라이브 thread의 ID를 리턴합니다. 리턴된 배열에 포함되는 일부의 thread는 이 메서드가 값을 돌려주었을 때에 종료하고 있던 가능성이 있습니다.

반환값:

thread ID를 포함한 long 형의 배열

예외:

SecurityException - 시큐러티 매니저가 존재하는 경우로 호출원이 ManagementPermission("monitor")를 가지지 않는 경우

getThreadInfo

ThreadInfo  getThreadInfo(long id)

스택 트레이스를 가지지 않는 지정된 id thread의 thread 정보를 리턴합니다. 이 메서드는 이하를 호출하는 것과 동등합니다.

getThreadInfo(id, 0);

이 메서드는 지정된 ID thread에 관한 thread 정보를 나타내는 ThreadInfo 객체를 리턴합니다. 리턴된 ThreadInfo 객체의 스택 트레이스는 StackTraceElement 비어있는 배열이 됩니다. 지정된 ID thread가 생존하고 있지 않는지, 존재하고 있지 않는 경우, 이 메서드는 null을 리턴합니다. 지정된 ID가 시작되어 생존하고 있는 경우, thread는 생존하고 있습니다.

MBeanServer 액세스:
ThreadInfo 맵형은, ThreadInfo 로 지정된 속성을 가지는 CompositeData 입니다.

파라미터:

id - thread의 thread ID. 정의 값이 아니면 안된다

반환값:

스택 트레이스를 가지지 않는 지정된 ID thread에 관한 ThreadInfo 객체. 지정된 ID thread가 생존 또는 존재하고 있지 않는 경우는 null

예외:

IllegalArgumentException - id <= 0인 경우

SecurityException - 시큐러티 매니저가 존재하는 경우로 호출원이 ManagementPermission("monitor")를 가지지 않는 경우

getThreadInfo

ThreadInfo [] getThreadInfo(long[] ids)

스택 트레이스를 가지지 않는 입력 배열 ids에 있는 ID를 가지는 thread마다의 thread 정보를 리턴합니다. 이 메서드는 이하를 호출하는 것과 동등합니다.

 getThreadInfo (ids, 0);
 

이 메서드는 ThreadInfo 객체의 배열을 리턴합니다. 각 ThreadInfo 객체의 스택 트레이스는 StackTraceElement 비어있는 배열이 됩니다. 지정된 ID thread가 생존하고 있지 않는지, 존재하고 있지 않는 경우, 리턴된 배열의 대응하는 요소는 null을 포함합니다. 지정된 ID thread가 시작되어 생존하고 있는 경우, thread는 생존하고 있습니다.

MBeanServer 액세스:
ThreadInfo 맵형은, ThreadInfo 로 지정된 속성을 가지는 CompositeData 입니다.

파라미터:

ids - thread ID 배열

반환값:

ID 입력 배열의 대응하는 요소에 ID가 있는 thread의 정보를 포함한 ThreadInfo 객체의 배열

예외:

IllegalArgumentException - 입력 배열 ids 요소가 <= 0 인 경우

SecurityException - 시큐러티 매니저가 존재하는 경우로 호출원이 ManagementPermission("monitor")를 가지지 않는 경우

getThreadInfo

ThreadInfo  getThreadInfo(long id,
                         int maxDepth)

지정된 id thread의 thread 정보를 리턴합니다. maxDepth 파라미터는 스택 트레이스로부터 취득되는 StackTraceElement 최대수를 나타냅니다. maxDepth == Integer.MAX_VALUE인 경우, thread의 스택 트레이스 전체가 덤프 됩니다. maxDepth == 0인 경우, thread의 스택 트레이스는 덤프 되지 않습니다.

Java 가상 머신이 thread의 스택 트레이스 정보를 가지지 않는 경우, 또는 maxDepth == 0인 경우, ThreadInfo 객체의 스택 트레이스는 StackTraceElement 비어있는 배열이 됩니다.

지정된 ID thread가 생존하고 있지 않는지, 존재하고 있지 않는 경우, 이 메서드는 null을 리턴합니다. 지정된 ID가 시작되어 생존하고 있는 경우, thread는 생존하고 있습니다.

MBeanServer 액세스:
ThreadInfo 맵형은, ThreadInfo 로 지정된 속성을 가지는 CompositeData 입니다.

파라미터:

id - thread의 thread ID. 정의 값이 아니면 안되는

maxDepth - 덤프 되는 스택 트레이스의 엔트리의 최대수. Integer.MAX_VALUE를 사용해, 스택 전체를 덤프 하도록 요구할 수 있다

반환값:

지정된 ID thread ThreadInfo . 지정된 ID thread가 생존 또는 존재하고 있지 않는 경우는 null

예외:

IllegalArgumentException - id <= 0인 경우

IllegalArgumentException - maxDepth is negative인 경우

SecurityException - 시큐러티 매니저가 존재하는 경우로 호출원이 ManagementPermission("monitor")를 가지지 않는 경우

getThreadInfo

ThreadInfo [] getThreadInfo(long[] ids,
                           int maxDepth)

입력 배열 ids에 ID를 가지는 각 thread의 thread 정보를 리턴합니다. maxDepth 파라미터는 스택 트레이스로부터 취득되는 StackTraceElement 최대수를 나타냅니다. maxDepth == Integer.MAX_VALUE인 경우, thread의 스택 트레이스 전체가 덤프 됩니다. maxDepth == 0인 경우, thread의 스택 트레이스는 덤프 되지 않습니다.

Java 가상 머신이 thread의 스택 트레이스 정보를 가지지 않는 경우, 또는 maxDepth == 0인 경우, ThreadInfo 객체의 스택 트레이스는 StackTraceElement 비어있는 배열이 됩니다.

이 메서드는 ThreadInfo 객체의 배열을 리턴합니다. 배열의 각 요소는 ids 배열과 같은 인덱스를 가지는 thread에 관한 thread 정보입니다. 지정된 ID thread가 생존하고 있지 않는지, 존재하지 않는 경우, 리턴된 배열의 대응하는 요소에 null가 설정됩니다. 지정된 thread ID가 시작되었는지 생존하고 있는 경우, thread는 생존하고 있습니다.

MBeanServer 액세스:
ThreadInfo 맵형은, ThreadInfo 로 지정된 속성을 가지는 CompositeData 입니다.

파라미터:

ids - thread ID 배열

maxDepth - 덤프 되는 스택 트레이스의 엔트리의 최대수. Integer.MAX_VALUE를 사용해, 스택 전체를 덤프 하도록 요구할 수 있다

반환값:

ID 입력 배열의 대응하는 요소에 ID가 있는 thread의 정보를 포함한 ThreadInfo 객체의 배열

예외:

IllegalArgumentException - maxDepth is negative인 경우

IllegalArgumentException - 입력 배열 ids 요소가 <= 0 인 경우

SecurityException - 시큐러티 매니저가 존재하는 경우로 호출원이 ManagementPermission("monitor")를 가지지 않는 경우

isThreadContentionMonitoringSupported

boolean isThreadContentionMonitoringSupported()

Java 가상 머신이 thread 컨텐션 감시를 지원 할지 어떨지를 테스트합니다.

반환값:

Java 가상 머신이 thread 컨텐션 감시를 지원하는인 경우는 true. 그렇지 않은 경우는 false

isThreadContentionMonitoringEnabled

boolean isThreadContentionMonitoringEnabled()

thread 컨텐션 감시가 유효한가 어떤가를 테스트합니다.

반환값:

thread 컨텐션 감시가 유효한 경우는 true, 그렇지 않은 경우는 false

예외:

UnsupportedOperationException - Java 가상 머신이 thread 컨텐션 감시를 지원 하지 않는 경우

관련 항목:

isThreadContentionMonitoringSupported()

setThreadContentionMonitoringEnabled

void setThreadContentionMonitoringEnabled(boolean enable)

thread 컨텐션 감시를 유효 또는 무효로 합니다. thread 컨텐션 감시는 디폴트로 무효로 설정되어 있습니다.

파라미터:

enable - 유효하게 하는 경우는 true, 무효로 하는 경우는 false

예외:

UnsupportedOperationException - Java 가상 머신이 thread 컨텐션 감시를 지원 하지 않는 경우

SecurityException - 시큐러티 매니저가 존재하는 경우로 호출원이 ManagementPermission("control")를 가지지 않는 경우

관련 항목:

isThreadContentionMonitoringSupported()

getCurrentThreadCpuTime

long getCurrentThreadCpuTime()

현재의 thread의 합계 CPU 시간을 나노초단위로 리턴합니다. 리턴된 값은 나노초단위의 정밀도입니다만, 반드시 나노초의 정확도가 아닙니다. 구현이 사용자 모드시와 시스템 모드시를 구별하는 경우, 리턴된 CPU 시간은 사용자 모드 또는 시스템 모드로 현재의 thread가 실행한 시간의 합계입니다.

이 메서드는 로컬 관리로 사용하는 간이 메서드이며, 이하를 호출하는 것과 동등합니다.

 getThreadCpuTime (Thread.currentThread(). getId());
 

반환값:

CPU 시간 측정이 유효한 경우, 현재의 thread의 합계 CPU 시간. 그렇지 않은 경우는 -1

예외:

UnsupportedOperationException - Java 가상 머신이 현재의 thread의 CPU 시간 측정을 지원 하지 않는 경우

관련 항목:

getCurrentThreadUserTime(), isCurrentThreadCpuTimeSupported(), isThreadCpuTimeEnabled(), setThreadCpuTimeEnabled(boolean)

getCurrentThreadUserTime

long getCurrentThreadUserTime()

현재의 thread가 사용자 모드로 실행한 CPU 시간 (나노초단위)을 리턴합니다. 리턴된 값은 나노초단위의 정밀도입니다만, 반드시 나노초의 정확도가 아닙니다.

이 메서드는 로컬 관리로 사용하는 간이 메서드이며, 이하를 호출하는 것과 동등합니다.

 getThreadUserTime (Thread.currentThread(). getId());
 

반환값:

CPU 시간 측정이 유효한 경우, 현재의 thread의 사용자 레벨의 CPU 시간. 그렇지 않은 경우는 -1

예외:

UnsupportedOperationException - Java 가상 머신이 현재의 thread의 CPU 시간 측정을 지원 하지 않는 경우

관련 항목:

getCurrentThreadCpuTime(), isCurrentThreadCpuTimeSupported(), isThreadCpuTimeEnabled(), setThreadCpuTimeEnabled(boolean)

getThreadCpuTime

long getThreadCpuTime(long id)

지정된 ID thread의 합계 CPU 시간 (나노초단위)을 리턴합니다. 리턴된 값은 나노초단위의 정밀도입니다만, 반드시 나노초의 정확도가 아닙니다. 구현이 사용자 모드시와 시스템 모드시를 구별하는 경우, 리턴된 CPU 시간은 사용자 모드 또는 시스템 모드로 그 thread가 실행한 시간의 합계입니다.

지정된 ID thread가 생존하고 있지 않는지, 존재하고 있지 않는 경우, 이 메서드는 -1을 리턴합니다. CPU 시간 측정이 무효의 경우, 이 메서드는 -1을 리턴합니다. 지정된 ID thread가 시작되어 생존하고 있는 경우, thread는 생존하고 있습니다.

thread가 시작된 뒤에 CPU 시간 측정이 유효하게 되었을 경우, Java 가상 머신의 구현에서는 CPU 시간 측정이 시작된 포인트로서 CPU 시간 측정 기능이 유효하게 된 시간 이전의 임의의 시간을 선택할 수 있습니다.

파라미터:

id - thread의 thread ID

반환값:

지정된 ID thread가 존재해, 생존하고 있어, CPU 시간 측정이 유효한 경우는 지정된 ID thread의 합계 CPU 시간. 그렇지 않은 경우는 -1

예외:

IllegalArgumentException - id <= 0인 경우

UnsupportedOperationException - Java 가상 머신이 다른 thread의 CPU 시간 측정을 지원 하지 않는 경우

관련 항목:

getThreadUserTime(long), isThreadCpuTimeSupported(), isThreadCpuTimeEnabled(), setThreadCpuTimeEnabled(boolean)

getThreadUserTime

long getThreadUserTime(long id)

지정된 ID thread가 사용자 모드로 실행한 CPU 시간 (나노초단위)을 리턴합니다. 리턴된 값은 나노초단위의 정밀도입니다만, 반드시 나노초의 정확도가 아닙니다.

지정된 ID thread가 생존하고 있지 않는지, 존재하고 있지 않는 경우, 이 메서드는 -1을 리턴합니다. CPU 시간 측정이 무효의 경우, 이 메서드는 -1을 리턴합니다. 지정된 ID thread가 시작되어 생존하고 있는 경우, thread는 생존하고 있습니다.

thread가 시작된 뒤에 CPU 시간 측정이 유효하게 되었을 경우, Java 가상 머신의 구현에서는 CPU 시간 측정이 시작된 포인트로서 CPU 시간 측정 기능이 유효하게 된 시간 이전의 임의의 시간을 선택할 수 있습니다.

파라미터:

id - thread의 thread ID

반환값:

지정된 ID thread가 존재해, 생존하고 있어, CPU 시간 측정이 유효한 경우는 지정된 ID thread의 사용자 레벨의 CPU 시간. 그렇지 않은 경우는 -1

예외:

IllegalArgumentException - id <= 0인 경우

UnsupportedOperationException - Java 가상 머신이 다른 thread의 CPU 시간 측정을 지원 하지 않는 경우

관련 항목:

getThreadCpuTime(long), isThreadCpuTimeSupported(), isThreadCpuTimeEnabled(), setThreadCpuTimeEnabled(boolean)

isThreadCpuTimeSupported

boolean isThreadCpuTimeSupported()

Java 가상 머신의 구현이 임의의 thread의 CPU 시간 측정을 지원 할지 어떨지를 테스트합니다. 임의의 thread의 CPU 시간 측정을 지원하는 Java 가상 머신의 구현은 현재의 thread의 CPU 시간 측정도 지원 합니다.

반환값:

Java 가상 머신이 임의의 thread의 CPU 시간 측정을 지원하는인 경우는 true. 그렇지 않은 경우는 false

isCurrentThreadCpuTimeSupported

boolean isCurrentThreadCpuTimeSupported()

Java 가상 머신이 현재의 thread의 CPU 시간 측정을 지원 할지 어떨지를 테스트합니다. isThreadCpuTimeSupported() 가 true를 돌려주는 경우, 이 메서드는 true를 리턴합니다.

반환값:

Java 가상 머신이 현재의 thread의 CPU 시간 측정을 지원하는인 경우는 true. 그렇지 않은 경우는 false

isThreadCpuTimeEnabled

boolean isThreadCpuTimeEnabled()

thread의 CPU 시간 측정이 유효한가 어떤가를 테스트합니다.

반환값:

thread의 CPU 시간 측정이 유효한 경우는 true, 그렇지 않은 경우는 false

예외:

UnsupportedOperationException - Java 가상 머신이 다른 thread 뿐만이 아니라 현재의 thread의 CPU 시간 측정도 지원 하지 않는 경우

관련 항목:

isThreadCpuTimeSupported(), isCurrentThreadCpuTimeSupported()

setThreadCpuTimeEnabled

void setThreadCpuTimeEnabled(boolean enable)

thread의 CPU 시간 측정을 유효 또는 무효로 합니다. 디폴트의 설정은 플랫폼에 응해 다릅니다.

파라미터:

enable - 유효하게 하는 경우는 true, 무효로 하는 경우는 false

예외:

UnsupportedOperationException - Java 가상 머신이 임의의 thread 뿐만이 아니라 현재의 thread의 CPU 시간 측정도 지원 하지 않는 경우

SecurityException - 시큐러티 매니저가 존재하는 경우로 호출원이 ManagementPermission("control")를 가지지 않는 경우

관련 항목:

isThreadCpuTimeSupported(), isCurrentThreadCpuTimeSupported()

findMonitorDeadlockedThreads

long[] findMonitorDeadlockedThreads()

객체 모니터의 취득을 대기하고 있어 데드 록 상태에 있는 thread의 사이클을 검색합니다. 즉, thread는 블록 되어 동기 블록에 들어가는 것을 대기하고 있는지, Object.wait 호출뒤, 동기 블록에 재입 하는 것을 대기하고 있습니다. 여기에서는 사이클중의 다른 thread에 의해 보관 유지되고 있는 다른 모니터의 취득을 시행하고 있는 동안, 각 thread는 1개의 모니터를 보유하고 있습니다.

공식으로는 thread가 「다른 thread에 의해 보유되는 객체 모니터를 대기하고 있다」관계에 있는 사이클의 일부인 경우, thread는 「모니터 데드 록」됩니다. 무엇보다 간단한 케이스에 대해 설명하면, thread A는 thread B가 소유하는 모니터를 대기하는 것을 블록 되어 thread B는 thread A가 소유하는 모니터를 대기하는 것을 블록 됩니다.

이 메서드는 트러블 슈팅을 위해서 설계되고 있습니다만, 동기 제어를 위한 것이 아닙니다. 이 메서드의 조작은 부하가 커질 가능성이 있습니다.

반환값:

모니터 데드 록 되고 있는 thread의 ID 배열. 그렇지 않은 경우는 null

예외:

SecurityException - 시큐러티 매니저가 존재하는 경우로 호출원이 ManagementPermission("monitor")를 가지지 않는 경우

resetPeakThreadCount

void resetPeakThreadCount()

피크 thread 카운트를 라이브 thread의 현재의 수에 리셋 합니다.

예외:

SecurityException - 시큐러티 매니저가 존재하는 경우로 호출원이 ManagementPermission("control")를 가지지 않는 경우

관련 항목:

getPeakThreadCount(), getThreadCount()