JDK-6375105 : Document conventional metricType Descriptor field
  • Type: Enhancement
  • Component: core-svc
  • Sub-Component: javax.management
  • Affected Version: 6
  • Priority: P3
  • Status: Closed
  • Resolution: Fixed
  • OS: generic
  • CPU: generic
  • Submitted: 2006-01-20
  • Updated: 2010-07-29
  • Resolved: 2006-03-23
The Version table provides details related to the release that this issue/RFE will be addressed.

Unresolved : Release in which this issue/RFE will be addressed.
Resolved: Release in which this issue/RFE has been resolved.
Fixed : Release in which this issue/RFE has been fixed. The release containing this fix may be available for download as an Early Access Release or a General Availability Release.

To download the current JDK release, click here.
JDK 6
6 b78Fixed
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