com.sap.util.monitor.jarm
Class JarmJmxMonitor

java.lang.Object
  |
  +--com.sap.util.monitor.jarm.JarmJmxMonitor

All Implemented Interfaces:

IConfMonitor, JarmJmxMonitorMBean

public class JarmJmxMonitor

extends java.lang.Object

implements JarmJmxMonitorMBean

Implementation of JMX Interface for JARM

Fields inherited from interface com.sap.util.monitor.jarm.IConfMonitor

COMPLEVEL, COMPLEVELBASIC, COMPLEVELDETAIL, COMPLEVELMEDIUM, COMPPROPERTIESGETSWITCH, COMPPROPERTIESSETSWITCH, COMPTRACELEVEL, CONSUMERCLASS, CONSUMERPREFIX, CONSUMERRESTART, CONSUMERSWITCH, KEYINSTRCHECK, KEYMAXREQCOMPHIGH, KEYMAXREQCOMPLOW, KEYMONITOR, KEYPARTNEREXCL, KEYVERSION, LOGFILEDIR, LOGLEVEL, MONITORPREFIX, NAMENOTSET, NOCOMPACTIVE, NUMBERNOTSET, REQCOMPNOTCLOSED, REQCOMPTOOMANYHIGH, REQCOMPTOOMANYLOW, REQOK, REQOVERVIEWALL, REQOVERVIEWHEADER, REQOVERVIEWNONE, RESETALL, RESETCOMPONENTS, RESETREQUESTS, RESETUSERS, RMIPORT, RMIPREFIX, RMISTARTREGISTRY, RMISWITCH, TOPACCGROSSTIME, TOPCALLNUM, TOPGROSSCPUTIME, TOPGROSSTIME, TOPNETCPUTIME, TOPNETTIME, TOPOUTDATA, TRACESWITCH, UNDEFDATA, UNDEFNAME, UNDEFTIME, VALUEALL, VALUENONE, VALUEOFF, VALUEON

Constructor Summary

JarmJmxMonitor()

Method Summary

java.util.Properties	getProperties() Delivers the parameters currently valid for monitoring;
boolean	isRunning() Indicates whether monitoring is switched on or off could also be done by getProperties()
ApplThreadOverview[]	listApplThreads() A application specific overview about the thread activities is returned.
ComponentOverview[]	listComponents(java.lang.String namePattern, int maxResults) Gives an overview about the components used by the requests.
ComponentOverviewExt[]	listComponentsExt(java.lang.String namePattern, int maxResults) Gives an overview about the components used by the requests (including CPU specific data).
RequestSummary	listSummaryOfRequests() Returns key numbers for all requests issued since startup.
RequestSummaryExt	listSummaryOfRequestsExt() Returns key numbers for all requests issued since startup (including CPU specific data).
ComponentOverview[]	listTopComponents(int criterion, java.lang.String namePattern, int maxResults) Gives an overview about the top components according to special criteria like gross time, amount of outbound data.
ComponentOverviewExt[]	listTopComponentsExt(int criterion, java.lang.String namePattern, int maxResults) Gives an overview about the top components according to special criteria like gross time, amount of outbound data (including CPU specific data).
RequestOverview[]	listTopRequests(int retOverview, int criterion, java.lang.String namePattern, int maxResults) Gives an overview about the top requests according to special criteria like gross time, amount of outbound data.
RequestOverviewExt[]	listTopRequestsExt(int retOverview, int criterion, java.lang.String namePattern, int maxResults) Gives an overview about the top requests according to special criteria like gross time, amount of outbound data (including CPU specific data).
UserOverview[]	listTopUsers(int criterion, java.lang.String namePattern, int maxResults) Gives an overview about the top users according to special criteria like gross time, number of calls, ...
void	resetMonitorData(int criterion) reset collected monitoring data reset user data (criterion: ConfMonitor.RESETUSERS): the accumulated user data is resetted; data which is being collected in currently open requests or in requests which are finished but not yet condensed is not touched reset component data (criterion: ConfMonitor.RESETCOMPONENTS): the accumulated component data is resetted; data which is being collected in currently open requests or in requests which are finished but not yet condensed is not touched; component attributes like description and the interface for component specific properties are not changed reset request data (criterion: ConfMonitor.RESETREQUESTS): the accumulated request data is resetted; data which is being collected in currently open requestsis not touched; different to the reset of components and users the requests which are finished but not yet condensed are deleted reset all data (criterion: ConfMonitor.RESETALL): combination of all cases above
void	setProperties(java.util.Properties props) Set monitoring parameters;
void	setRunning(boolean switchOn) Switches JARM monitoring on / off; is valid for requests which start after this call could also be done by setProperties()

Methods inherited from class java.lang.Object

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

Constructor Detail

JarmJmxMonitor

public JarmJmxMonitor()

Method Detail

setRunning

public void setRunning(boolean switchOn)

Switches JARM monitoring on / off;
is valid for requests which start after this call
could also be done by setProperties()

Specified by:

setRunning in interface JarmJmxMonitorMBean

Parameters:

switchOn - true -> monitoring is switched on; false -> monitoring is switched off

isRunning

public boolean isRunning()

Indicates whether monitoring is switched on or off
could also be done by getProperties()

Specified by:

isRunning in interface JarmJmxMonitorMBean

Returns:

true <-> monitoring is switched on

setProperties

public void setProperties(java.util.Properties props)

Set monitoring parameters;

Specified by:

setProperties in interface JarmJmxMonitorMBean

Parameters:

props - properties object containing the key-value pairs for the parameters; only parameters contained in the properties object will be changed;
to be handled parameter names have to start with "jarm/"

getProperties

public java.util.Properties getProperties()

Delivers the parameters currently valid for monitoring;

Specified by:

getProperties in interface JarmJmxMonitorMBean

Returns:

the properties object

listApplThreads

public ApplThreadOverview[] listApplThreads()

A application specific overview about the thread activities is returned. Only these threads are listed which are still alive and which were used by applications instrumented with monitor API calls.

Specified by:

listApplThreads in interface JarmJmxMonitorMBean

Returns:

array with one entry for every thread; if no thread was ever used by an application with monitoring switched on, null is returned consistency is guaranteed on an entry basis, this means for each thread the information is consistent, but the information across all the entries is collected at slightly different timestamps

listTopRequests

public RequestOverview[] listTopRequests(int retOverview,
                                         int criterion,
                                         java.lang.String namePattern,
                                         int maxResults)

Gives an overview about the top requests according to special criteria like gross time, amount of outbound data.

Specified by:

listTopRequests in interface JarmJmxMonitorMBean

Parameters:

retOverview - ConfMonitor.REQOVERVIEWALL <-> return all collected monitoring data; ConfMonitor.REQOVERVIEWNONE <-> 'null' is returned currently only ConfMonitor.REQOVERVIEWALL makes sense for call; the parameter was just added to be able to make compatible extensions in future

criterion - ConfMonitor.TOPGROSSTIME, ConfMonitor.TOPOUTDATA

namePattern - restriction for request name; allowed are
- null or "*": no restriction
- "prefix[*]": only names which starts with "prefix"; e.g. "wcm*" or "abc"

maxResults - maximum number of result entries;
internally only ConfMonitor.initNrTops records are stored; this will be the upper limit of result entries if no restriction applies

Returns:

array with one entry for each request; if no request is matching or retOverview = ConfMonitor.REQOVERVIEWNONE, null is returned; the entries are sorted according the criterion; null is also returned if criterion has no correct value

listTopRequestsExt

public RequestOverviewExt[] listTopRequestsExt(int retOverview,
                                               int criterion,
                                               java.lang.String namePattern,
                                               int maxResults)

Gives an overview about the top requests according to special criteria like gross time, amount of outbound data (including CPU specific data).

Specified by:

listTopRequestsExt in interface JarmJmxMonitorMBean

Parameters:

retOverview - ConfMonitor.REQOVERVIEWALL <-> return all collected monitoring data; ConfMonitor.REQOVERVIEWNONE <-> 'null' is returned currently only ConfMonitor.REQOVERVIEWALL makes sense for call; the parameter was just added to be able to make compatible extensions in future

criterion - ConfMonitor.TOPGROSSTIME, ConfMonitor.TOPOUTDATA

namePattern - restriction for request name; allowed are
- null or "*": no restriction
- "prefix[*]": only names which starts with "prefix"; e.g. "wcm*" or "abc"

maxResults - maximum number of result entries;
internally only ConfMonitor.initNrTops records are stored; this will be the upper limit of result entries if no restriction applies

Returns:

array with one entry for each request; if no request is matching or retOverview = ConfMonitor.REQOVERVIEWNONE, null is returned; the entries are sorted according the criterion; null is also returned if criterion has no correct value

listSummaryOfRequests

public RequestSummary listSummaryOfRequests()

Returns key numbers for all requests issued since startup.

Specified by:

listSummaryOfRequests in interface JarmJmxMonitorMBean

Returns:

structure of key numbers like avg. response time and average amount of outbound data

listSummaryOfRequestsExt

public RequestSummaryExt listSummaryOfRequestsExt()

Returns key numbers for all requests issued since startup (including CPU specific data).

Specified by:

listSummaryOfRequestsExt in interface JarmJmxMonitorMBean

Returns:

structure of key numbers like avg. response time and average amount of outbound data

listTopComponents

public ComponentOverview[] listTopComponents(int criterion,
                                             java.lang.String namePattern,
                                             int maxResults)

Gives an overview about the top components according to special criteria like gross time, amount of outbound data.

Specified by:

listTopComponents in interface JarmJmxMonitorMBean

Parameters:

criterion - ConfMonitor.TOPGROSSTIME, ConfMonitor.TOPOUTDATA ConfMonitor.TOPNETTIME, ConfMonitor.TOPCALLNUM

namePattern - restriction for component name; allowed are
- null or "*": no restriction
- "[*]": only names which starts with ""; e.g. "wcm*" or "a.b.c"

maxResults - maximum number of result entries; the value is restricted by ConfMonitor.initMaxCompRet; if a big number is used, the response time could be high!!

Returns:

array with one entry for each component; if no component is matching, null is returned; the entries are sorted according the criterion

listTopComponentsExt

public ComponentOverviewExt[] listTopComponentsExt(int criterion,
                                                   java.lang.String namePattern,
                                                   int maxResults)

Gives an overview about the top components according to special criteria like gross time, amount of outbound data (including CPU specific data).

Specified by:

listTopComponentsExt in interface JarmJmxMonitorMBean

Parameters:

criterion - ConfMonitor.TOPGROSSTIME, ConfMonitor.TOPOUTDATA ConfMonitor.TOPNETTIME, ConfMonitor.TOPCALLNUM ConfMonitor.TOPGROSSCPUTIME, ConfMonitor.TOPNETCPUTIME

namePattern - restriction for component name; allowed are
- null or "*": no restriction
- "[*]": only names which starts with ""; e.g. "wcm*" or "a.b.c"

maxResults - maximum number of result entries; the value is restricted by ConfMonitor.initMaxCompRet; if a big number is used, the response time could be high!!

Returns:

array with one entry for each component; if no component is matching, null is returned; the entries are sorted according the criterion

listComponents

public ComponentOverview[] listComponents(java.lang.String namePattern,
                                          int maxResults)

Gives an overview about the components used by the requests.

Specified by:

listComponents in interface JarmJmxMonitorMBean

Parameters:

namePattern - restriction for component name; allowed are
- null or "*": no restriction
- "[*]": only names which starts with ""; e.g. "wcm*" or "a.b.c"

maxResults - maximum number of result entries; the value is restricted by ConfMonitor.initMaxCompRet; if a big number is used, the response time could be high!!

Returns:

array with one entry for each component; if no component is matching, null is returned; no special sequence guaranteed

listComponentsExt

public ComponentOverviewExt[] listComponentsExt(java.lang.String namePattern,
                                                int maxResults)

Gives an overview about the components used by the requests (including CPU specific data).

Specified by:

listComponentsExt in interface JarmJmxMonitorMBean

Parameters:

namePattern - restriction for component name; allowed are
- null or "*": no restriction
- "[*]": only names which starts with ""; e.g. "wcm*" or "a.b.c"

maxResults - maximum number of result entries; the value is restricted by ConfMonitor.initMaxCompRet; if a big number is used, the response time could be high!!

Returns:

array with one entry for each component; if no component is matching, null is returned; no special sequence guaranteed

listTopUsers

public UserOverview[] listTopUsers(int criterion,
                                   java.lang.String namePattern,
                                   int maxResults)

Gives an overview about the top users according to special criteria like gross time, number of calls, ...

Specified by:

listTopUsers in interface JarmJmxMonitorMBean

Parameters:

criterion - ConfMonitor.TOPGROSSTIME, ConfMonitor.TOPACCGROSSTIME, ConfMonitor.TOPCALLNUM

namePattern - restriction for component name; allowed are
- null or "*": no restriction
- "[*]": only names which starts with ""; e.g. "wcm*" or "a.b.c"

maxResults - maximum number of result entries; the value is restricted by ConfMonitor.initMaxUserRet; if a big number is used, the response time could be high!!

Returns:

array with one entry for each user; if no user is matching, null is returned; the entries are sorted according the criterion

resetMonitorData

public void resetMonitorData(int criterion)

reset collected monitoring data
reset user data (criterion: ConfMonitor.RESETUSERS):
the accumulated user data is resetted; data which is being collected in currently open requests or in requests which are finished but not yet condensed is not touched
reset component data (criterion: ConfMonitor.RESETCOMPONENTS):
the accumulated component data is resetted; data which is being collected in currently open requests or in requests which are finished but not yet condensed is not touched; component attributes like description and the interface for component specific properties are not changed
reset request data (criterion: ConfMonitor.RESETREQUESTS):
the accumulated request data is resetted; data which is being collected in currently open requestsis not touched; different to the reset of components and users the requests which are finished but not yet condensed are deleted
reset all data (criterion: ConfMonitor.RESETALL):
combination of all cases above

Specified by:

resetMonitorData in interface JarmJmxMonitorMBean

Parameters:

criterion - ConfMonitor.RESETALL, CONFMONITOR.RESETREQUESTS, ConfMonitor.RESETCOMPONENTS, ConfMonitor.RESETUSERS