Package org.eclipse.microprofile.metrics.annotation

Annotation Interface Gauge

@InterceptorBinding @Retention(RUNTIME) @Target({METHOD,ANNOTATION_TYPE}) public @interface Gauge
An annotation for marking a method or field as a gauge. The metric will be registered in the application MetricRegistry.

Given a method annotated with @Gauge like this: 

 
     @Gauge(name = "queueSize")
     public int getQueueSize() {
         return queue.size;
     }
A gauge with the fully qualified class name + queueSize will be created which uses the annotated method's return value as its value. The annotated method/field must be of numeric type (extends Number).

  • Required Element Summary

    Required Elements
    Modifier and Type
    Required Element
    Description
    String
    unit
    The unit of the gauge.

  • Optional Element Summary

    Optional Elements
    Modifier and Type
    Optional Element
    Description
    boolean
    absolute
    Denotes whether to use the absolute name or use the default given name relative to the annotated class.
    String
    description
    The description of the gauge.
    String
    name
    The name of the gauge.
    String
    scope
    The scope that this gauge belongs to.
    String[]
    tags
    The tags of the gauge.

  • Element Details

    • name

      String name
      The name of the gauge.
      Returns:
      The name of the gauge.
      Default:
      ""

    • tags

      String[] tags
      The tags of the gauge.
      Returns:
      The tags of the gauge. Each String tag must be in the form of 'key=value'. If the input is empty or does not contain a '=' sign, the entry is ignored.
      See Also:
      Default:
      {}

    • absolute

      boolean absolute
      Denotes whether to use the absolute name or use the default given name relative to the annotated class.
      Returns:
      If true, use the given name as an absolute name. If false (default), use the given name relative to the annotated class.
      Default:
      false

    • description

      String description
      The description of the gauge.
      Returns:
      The description of the gauge.
      See Also:
      Default:
      ""

    • scope

      String scope
      The scope that this gauge belongs to.
      Returns:
      The scope this gauge belongs to. By default, the value is MetricRegistry.APPLICATION_SCOPE.
      Default:
      "application"