com.ibm.java.diagnostics.healthcenter.api.locking

Interface MonitorData

All Superinterfaces:

TimeData

public interface MonitorData
extends TimeData

This class contains information about a specific thread lock, or monitor.

Method Summary

Methods

Modifier and Type	Method and Description
long	getAcquireCount() Gets the total number of times the lock was acquired while it was inflated.
long	getAverageHoldTime() Gets the average amount of time the lock was held for.
double	getContention() Gets the percentage of total acquires for which the thread had to block before it could take the lock.
java.lang.String	getName() Gets the name of this monitor.
long	getRecursiveCount() Gets the total number of times the thread requested the lock when it already owned it.
long	getSlowCount() Gets the total number of times the thread had to wait to acquire the lock.
double	getUtilisation() Gets the percentage of monitoring time that the lock was held for.

Methods inherited from interface com.ibm.java.diagnostics.healthcenter.api.TimeData

getTime

Method Detail

getContention

double getContention()

Gets the percentage of total acquires for which the thread had to block before it could take the lock.

Returns:

the percentage of acquires that were contended.

getAcquireCount

long getAcquireCount()

Gets the total number of times the lock was acquired while it was inflated.

Returns:

the total number of acquires.

getSlowCount

long getSlowCount()

Gets the total number of times the thread had to wait to acquire the lock.

Returns:

the total number of slow acquires.

getRecursiveCount

long getRecursiveCount()

Gets the total number of times the thread requested the lock when it already owned it.

Returns:

the total number of recursive acquires.

getUtilisation

double getUtilisation()

Gets the percentage of monitoring time that the lock was held for.

Returns:

the utilisation, as a percentage.

getAverageHoldTime

long getAverageHoldTime()

Gets the average amount of time the lock was held for. This value is given in processor clock ticks.

Returns:

the average hold time, in clock ticks.

getName

java.lang.String getName()

Gets the name of this monitor.

Returns:

a String representation of the monitor name.