Module org.eclipse.persistence.core

Package org.eclipse.persistence.tools.profiler

Class PerformanceMonitor

java.lang.Object

org.eclipse.persistence.tools.profiler.PerformanceMonitor

All Implemented Interfaces:

Serializable, Cloneable, SessionProfiler

public class PerformanceMonitor
extends Object
implements Serializable, Cloneable, SessionProfiler

Purpose: A tool used to provide performance monitoring information in a server environment.

Since:

EclipseLink 2.2

Author:

James Sutherland

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
protected static String	COUNTER
protected long	dumpTime
protected long	lastDumpTime
protected Map<Integer,Map<String,Long>>	operationStartTimesByThread
protected Map<String,Object>	operationTimings
protected int	profileWeight
protected AbstractSession	session
protected static String	TIMER

Fields inherited from interface org.eclipse.persistence.sessions.SessionProfiler

ALL, AssignSequence, CacheCoordination, CacheCoordinationSerialize, CacheHits, CacheMisses, CacheSize, Caching, ChangeSetsNotProcessed, ChangeSetsProcessed, ClientSessionCreated, ClientSessionReleased, ConnectionManagement, ConnectionPing, Connects, DescriptorEvent, Disconnects, DistributedMerge, HEAVY, JtsAfterCompletion, JtsBeforeCompletion, Logging, LoginTime, Merge, NONE, NORMAL, ObjectBuilding, OptimisticLockException, QueryPreparation, RcmReceived, RcmSent, RcmStatus, Register, Remote, RemoteChangeSet, RemoteLazy, RemoteMetadata, RowFetch, SessionEvent, SessionName, SqlGeneration, SqlPrepare, StatementExecute, Transaction, UowCommit, UowCommits, UowCreated, UowReleased, UowRollbacks

Constructor Summary

Constructors

Constructor	Description
PerformanceMonitor()	PUBLIC: Create a new profiler.

Method Summary

Modifier and Type	Method	Description
void	checkDumpTime()	Log the results after a set amount of time has passed.
PerformanceMonitor	clone()
void	dumpResults()	Log the results to the session's log (System.out).
void	endOperationProfile(String operationName)	INTERNAL: End the operation timing.
void	endOperationProfile(String operationName, DatabaseQuery query, int weight)	INTERNAL: End the operation timing.
long	getDumpTime()	Return the number of milliseconds after which the monitor results should be logged.
protected Map<String,Long>	getOperationStartTimes()
protected Map<Integer,Map<String,Long>>	getOperationStartTimesByThread()
Object	getOperationTime(String operation)
Map<String,Object>	getOperationTimings()
int	getProfileWeight()	Return the level of profiling.
AbstractSession	getSession()
void	initialize()	INTERNAL: Initialize EclipseLink noun tree(DMS)
void	occurred(String operationName, AbstractSession session)	INTERNAL: Increase DMS Event sensor occurrence.(DMS)
void	occurred(String operationName, DatabaseQuery query, AbstractSession session)	INTERNAL: Increase DMS Event sensor occurrence.(DMS)
Object	profileExecutionOfQuery(DatabaseQuery query, DataRecord row, AbstractSession session)	INTERNAL: Monitoring is done on the endOperation only.
void	setDumpTime(long dumpTime)	Set the number of milliseconds after which the monitor results should be logged.
void	setProfileWeight(int profileWeight)	Set the level of profiling.
void	setSession(Session session)	INTERNAL: Set the session.
void	startOperationProfile(String operationName)	INTERNAL: Start the operation timing.
void	startOperationProfile(String operationName, DatabaseQuery query, int weight)	INTERNAL: Start the operation timing.
void	update(String operationName, Object value)	INTERNAL: Update the value of the State sensor.(DMS)

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

COUNTER

protected static final String COUNTER

See Also:

Constant Field Values

TIMER

protected static final String TIMER

See Also:

Constant Field Values

session

protected transient AbstractSession session

operationTimings

protected Map<String,Object> operationTimings

operationStartTimesByThread

protected Map<Integer,Map<String,Long>> operationStartTimesByThread

lastDumpTime

protected long lastDumpTime

dumpTime

protected long dumpTime

profileWeight

protected int profileWeight

Constructor Detail

PerformanceMonitor

public PerformanceMonitor()

PUBLIC: Create a new profiler. The profiler can be registered with a session to log performance information on queries.

Method Detail

getDumpTime

public long getDumpTime()

Return the number of milliseconds after which the monitor results should be logged.

setDumpTime

public void setDumpTime(long dumpTime)

Set the number of milliseconds after which the monitor results should be logged.

clone

public PerformanceMonitor clone()

Overrides:

clone in class Object

checkDumpTime

public void checkDumpTime()

Log the results after a set amount of time has passed.

dumpResults

public void dumpResults()

Log the results to the session's log (System.out).

endOperationProfile

public void endOperationProfile(String operationName)

INTERNAL: End the operation timing.

Specified by:

endOperationProfile in interface SessionProfiler

endOperationProfile

public void endOperationProfile(String operationName,
                                DatabaseQuery query,
                                int weight)

INTERNAL: End the operation timing.

Specified by:

endOperationProfile in interface SessionProfiler

getOperationStartTimes

protected Map<String,Long> getOperationStartTimes()

getOperationStartTimesByThread

protected Map<Integer,Map<String,Long>> getOperationStartTimesByThread()

getOperationTime

public Object getOperationTime(String operation)

getOperationTimings

public Map<String,Object> getOperationTimings()

getSession

public AbstractSession getSession()

profileExecutionOfQuery

public Object profileExecutionOfQuery(DatabaseQuery query,
                                      DataRecord row,
                                      AbstractSession session)

INTERNAL: Monitoring is done on the endOperation only.

Specified by:

profileExecutionOfQuery in interface SessionProfiler

Returns:

the execution result of the query.

setSession

public void setSession(Session session)

Description copied from interface: SessionProfiler

INTERNAL: Set the session.

Specified by:

setSession in interface SessionProfiler

startOperationProfile

public void startOperationProfile(String operationName)

INTERNAL: Start the operation timing.

Specified by:

startOperationProfile in interface SessionProfiler

startOperationProfile

public void startOperationProfile(String operationName,
                                  DatabaseQuery query,
                                  int weight)

INTERNAL: Start the operation timing.

Specified by:

startOperationProfile in interface SessionProfiler

update

public void update(String operationName,
                   Object value)

Description copied from interface: SessionProfiler

INTERNAL: Update the value of the State sensor.(DMS)

Specified by:

update in interface SessionProfiler

occurred

public void occurred(String operationName,
                     AbstractSession session)

Description copied from interface: SessionProfiler

INTERNAL: Increase DMS Event sensor occurrence.(DMS)

Specified by:

occurred in interface SessionProfiler

occurred

public void occurred(String operationName,
                     DatabaseQuery query,
                     AbstractSession session)

Description copied from interface: SessionProfiler

INTERNAL: Increase DMS Event sensor occurrence.(DMS)

Specified by:

occurred in interface SessionProfiler

setProfileWeight

public void setProfileWeight(int profileWeight)

Set the level of profiling. One of ALL, HEAVY, NORMAL, NONE. The higher the level, the more operations are profiled.

Specified by:

setProfileWeight in interface SessionProfiler

See Also:

SessionProfiler

getProfileWeight

public int getProfileWeight()

Return the level of profiling. One of ALL, HEAVY, NORMAL, NONE.

Specified by:

getProfileWeight in interface SessionProfiler

See Also:

SessionProfiler

initialize

public void initialize()

Description copied from interface: SessionProfiler

INTERNAL: Initialize EclipseLink noun tree(DMS)

Specified by:

initialize in interface SessionProfiler