Quality-Rate Monitor (SAP Library - Developing Applications Using Java)

Quality-Rate Monitor

A performance monitor that computes an average (and actual) quality rate according to the reported number of total tries and successful tries. For example, you have one successful try from a total amount of 10 tries. Then the average quality rate would be 10%.

There are to ways for instrumenting the quality-rate monitor in the monitor-configuration.xml and in the source code:

Case 1

· In the monitor-configuration.xml this monitor is specified in the following way:

<quality-rate-monitor name="Cache Hit Rate" configuration-group="ConfigMgr.CacheHitRate">

<monitored-resource name="ConfigurationManager" type="MANAGER"/>

<quality-rate-attribute-mapping>

<total-tries-attribute>

<observed-resource-attribute name="AccNrOfRequests"/>

</total-tries-attribute>

<total-hits-attribute>

<observed-resource-attribute name="AccNrOfCacheRequests"/>

</total-hits-attribute>

</quality-rate-attribute-mapping>

</quality-rate-monitor>

· The method returning the total tries from startup is:

public long getAccNrOfRequests();

· The method returning the total successful tries from startup is:

public long getAccNrOfCacheRequests();

Case 2

· In the monitor-configuration.xml this monitor is specified in the following way:

<quality-rate-monitor name="Cache Hit Rate" configuration-group="ConfigMgr.CacheHitRate">

<monitored-resource name="ConfigurationManager" type="MANAGER"/>

<quality-rate-attribute-mapping>

<quality-rate-attribute>

<observed-resource-attribute name="QualityRate"/>

</quality-rate-attribute>

</quality-rate-attribute-mapping>

</quality-rate-monitor>

· The method returning the necessary data is:

public com.sap.jmx.monitoring.api.QualityRateValue getQualityRate();