United StatesChange Country, Oracle Worldwide Web Sites Communities I am a... I want to...
JDK-6375105 : Document conventional metricType Descriptor field

Details
Type:
Enhancement
Submit Date:
2006-01-20
Status:
Closed
Updated Date:
2010-07-29
Project Name:
JDK
Resolved Date:
2006-03-23
Component:
core-svc
OS:
generic
Sub-Component:
javax.management
CPU:
generic
Priority:
P3
Resolution:
Fixed
Affected Versions:
6
Fixed Versions:

Related Reports

Sub Tasks

Description
One of the important properties that attributes in management systems typically have is, when they represent metrics, to say whether they are gauges or counters.  We should reflect this in the conventional Descriptor fields.  The proposal is to add this to the table in javax.management.Descriptor:

Name        Type    Used in
metricType  String  MBeanAttributeInfo, MBeanOperationInfo

Meaning
The type of a metric, one of the strings "counter" or "gauge".  A metric is a measurement exported by an MBean, usually an attribute but sometimes the result of an operation.  A metric that is a counter has a value that never decreases except by being reset to a starting value.  Counter metrics are almost always non-negative integers.  An example might be the number of requests received.  A metric that is a gauge has a numeric value that can increase or decrease.  Examples might be the number of open connections or a cache hit rate or a temperature reading.

                                    

Comments
EVALUATION

This is just a documentation change.  It does not imply any changes to the implementation or to existing tools and it does not document any existing behavior.
                                     
2006-01-20



Hardware and Software, Engineered to Work Together