Meter (opentelemetry-api 0.5.0 API)

All Known Implementing Classes:

DefaultMeter
```
@ThreadSafe
public interface Meter
```
Meter is a simple, interface that allows users to record measurements (metrics).
There are two ways to record measurements:
- Record raw measurements, and defer defining the aggregation and the labels for the exported Instrument. This should be used in libraries like gRPC to record measurements like "server_latency" or "received_bytes".
- Record pre-defined aggregation data (or already aggregated data). This should be used to report cpu/memory usage, or simple metrics like "queue_length".
TODO: Update comment.

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method and Description
`DoubleCounter.Builder`	`doubleCounterBuilder(String name)` Returns a builder for a `DoubleCounter`.
`DoubleSumObserver.Builder`	`doubleSumObserverBuilder(String name)` Returns a new builder for a `DoubleSumObserver`.
`DoubleUpDownCounter.Builder`	`doubleUpDownCounterBuilder(String name)` Returns a builder for a `DoubleUpDownCounter`.
`DoubleUpDownSumObserver.Builder`	`doubleUpDownSumObserverBuilder(String name)` Returns a new builder for a `DoubleUpDownSumObserver`.
`DoubleValueObserver.Builder`	`doubleValueObserverBuilder(String name)` Returns a new builder for a `DoubleValueObserver`.
`DoubleValueRecorder.Builder`	`doubleValueRecorderBuilder(String name)` Returns a new builder for a `DoubleValueRecorder`.
`LongCounter.Builder`	`longCounterBuilder(String name)` Returns a builder for a `LongCounter`.
`LongSumObserver.Builder`	`longSumObserverBuilder(String name)` Returns a new builder for a `LongSumObserver`.
`LongUpDownCounter.Builder`	`longUpDownCounterBuilder(String name)` Returns a builder for a `LongUpDownCounter`.
`LongUpDownSumObserver.Builder`	`longUpDownSumObserverBuilder(String name)` Returns a new builder for a `LongUpDownSumObserver`.
`LongValueObserver.Builder`	`longValueObserverBuilder(String name)` Returns a new builder for a `LongValueObserver`.
`LongValueRecorder.Builder`	`longValueRecorderBuilder(String name)` Returns a new builder for a `LongValueRecorder`.
`BatchRecorder`	`newBatchRecorder(String... keyValuePairs)` Utility method that allows users to atomically record measurements to a set of Instruments with a common set of labels.

- Method Detail
  - doubleCounterBuilder
```
DoubleCounter.Builder doubleCounterBuilder(String name)
```
    Returns a builder for a DoubleCounter.
    
    Parameters:
    
    name - the name of the instrument. Should be a ASCII string with a length no greater than 255 characters.
    
    Returns:
    
    a DoubleCounter.Builder.
    
    Throws:
    
    NullPointerException - if name is null.
    
    IllegalArgumentException - if different metric with the same name already registered.
    
    IllegalArgumentException - if the name does not match the requirements.
    
    Since:
    
    0.1.0
  - longCounterBuilder
```
LongCounter.Builder longCounterBuilder(String name)
```
    Returns a builder for a LongCounter.
    
    Parameters:
    
    name - the name of the instrument. Should be a ASCII string with a length no greater than 255 characters.
    
    Returns:
    
    a LongCounter.Builder.
    
    Throws:
    
    NullPointerException - if name is null.
    
    IllegalArgumentException - if different metric with the same name already registered.
    
    IllegalArgumentException - if the name does not match the requirements.
    
    Since:
    
    0.1.0
  - doubleUpDownCounterBuilder
```
DoubleUpDownCounter.Builder doubleUpDownCounterBuilder(String name)
```
    Returns a builder for a DoubleUpDownCounter.
    
    Parameters:
    
    name - the name of the instrument. Should be a ASCII string with a length no greater than 255 characters.
    
    Returns:
    
    a DoubleCounter.Builder.
    
    Throws:
    
    NullPointerException - if name is null.
    
    IllegalArgumentException - if different metric with the same name already registered.
    
    IllegalArgumentException - if the name does not match the requirements.
    
    Since:
    
    0.1.0
  - longUpDownCounterBuilder
```
LongUpDownCounter.Builder longUpDownCounterBuilder(String name)
```
    Returns a builder for a LongUpDownCounter.
    
    Parameters:
    
    name - the name of the instrument. Should be a ASCII string with a length no greater than 255 characters.
    
    Returns:
    
    a LongCounter.Builder.
    
    Throws:
    
    NullPointerException - if name is null.
    
    IllegalArgumentException - if different metric with the same name already registered.
    
    IllegalArgumentException - if the name does not match the requirements.
    
    Since:
    
    0.1.0
  - doubleValueRecorderBuilder
```
DoubleValueRecorder.Builder doubleValueRecorderBuilder(String name)
```
    Returns a new builder for a DoubleValueRecorder.
    
    Parameters:
    
    name - the name of the instrument. Should be a ASCII string with a length no greater than 255 characters.
    
    Returns:
    
    a new builder for a DoubleValueRecorder.
    
    Throws:
    
    NullPointerException - if name is null.
    
    IllegalArgumentException - if different metric with the same name already registered.
    
    IllegalArgumentException - if the name does not match the requirements.
    
    Since:
    
    0.1.0
  - longValueRecorderBuilder
```
LongValueRecorder.Builder longValueRecorderBuilder(String name)
```
    Returns a new builder for a LongValueRecorder.
    
    Parameters:
    
    name - the name of the instrument. Should be a ASCII string with a length no greater than 255 characters.
    
    Returns:
    
    a new builder for a LongValueRecorder.
    
    Throws:
    
    NullPointerException - if name is null.
    
    IllegalArgumentException - if different metric with the same name already registered.
    
    IllegalArgumentException - if the name does not match the requirements.
    
    Since:
    
    0.1.0
  - doubleSumObserverBuilder
```
DoubleSumObserver.Builder doubleSumObserverBuilder(String name)
```
    Returns a new builder for a DoubleSumObserver.
    
    Parameters:
    
    name - the name of the instrument. Should be a ASCII string with a length no greater than 255 characters.
    
    Returns:
    
    a new builder for a DoubleSumObserver.
    
    Throws:
    
    NullPointerException - if name is null.
    
    IllegalArgumentException - if different metric with the same name already registered.
    
    IllegalArgumentException - if the name does not match the requirements.
    
    Since:
    
    0.1.0
  - longSumObserverBuilder
```
LongSumObserver.Builder longSumObserverBuilder(String name)
```
    Returns a new builder for a LongSumObserver.
    
    Parameters:
    
    name - the name of the instrument. Should be a ASCII string with a length no greater than 255 characters.
    
    Returns:
    
    a new builder for a LongSumObserver.
    
    Throws:
    
    NullPointerException - if name is null.
    
    IllegalArgumentException - if different metric with the same name already registered.
    
    IllegalArgumentException - if the name does not match the requirements.
    
    Since:
    
    0.1.0
  - doubleUpDownSumObserverBuilder
```
DoubleUpDownSumObserver.Builder doubleUpDownSumObserverBuilder(String name)
```
    Returns a new builder for a DoubleUpDownSumObserver.
    
    Parameters:
    
    name - the name of the instrument. Should be a ASCII string with a length no greater than 255 characters.
    
    Returns:
    
    a new builder for a DoubleUpDownObserver.
    
    Throws:
    
    NullPointerException - if name is null.
    
    IllegalArgumentException - if different metric with the same name already registered.
    
    IllegalArgumentException - if the name does not match the requirements.
    
    Since:
    
    0.1.0
  - longUpDownSumObserverBuilder
```
LongUpDownSumObserver.Builder longUpDownSumObserverBuilder(String name)
```
    Returns a new builder for a LongUpDownSumObserver.
    
    Parameters:
    
    name - the name of the instrument. Should be a ASCII string with a length no greater than 255 characters.
    
    Returns:
    
    a new builder for a LongUpDownSumObserver.
    
    Throws:
    
    NullPointerException - if name is null.
    
    IllegalArgumentException - if different metric with the same name already registered.
    
    IllegalArgumentException - if the name does not match the requirements.
    
    Since:
    
    0.1.0
  - doubleValueObserverBuilder
```
DoubleValueObserver.Builder doubleValueObserverBuilder(String name)
```
    Returns a new builder for a DoubleValueObserver.
    
    Parameters:
    
    name - the name of the instrument. Should be a ASCII string with a length no greater than 255 characters.
    
    Returns:
    
    a new builder for a DoubleValueObserver.
    
    Throws:
    
    NullPointerException - if name is null.
    
    IllegalArgumentException - if different metric with the same name already registered.
    
    IllegalArgumentException - if the name does not match the requirements.
    
    Since:
    
    0.1.0
  - longValueObserverBuilder
```
LongValueObserver.Builder longValueObserverBuilder(String name)
```
    Returns a new builder for a LongValueObserver.
    
    Parameters:
    
    name - the name of the instrument. Should be a ASCII string with a length no greater than 255 characters.
    
    Returns:
    
    a new builder for a LongValueObserver.
    
    Throws:
    
    NullPointerException - if name is null.
    
    IllegalArgumentException - if different metric with the same name already registered.
    
    IllegalArgumentException - if the name does not match the requirements.
    
    Since:
    
    0.1.0
  - newBatchRecorder
```
BatchRecorder newBatchRecorder(String... keyValuePairs)
```
    Utility method that allows users to atomically record measurements to a set of Instruments with a common set of labels.
    
    Parameters:
    
    keyValuePairs - The set of labels to associate with this recorder and all it's recordings.
    
    Returns:
    
    a MeasureBatchRecorder that can be use to atomically record a set of measurements associated with different Measures.
    
    Since:
    
    0.1.0

Interface Meter

Method Summary

Method Detail

doubleCounterBuilder

longCounterBuilder

doubleUpDownCounterBuilder

longUpDownCounterBuilder

doubleValueRecorderBuilder

longValueRecorderBuilder

doubleSumObserverBuilder

longSumObserverBuilder

doubleUpDownSumObserverBuilder

longUpDownSumObserverBuilder

doubleValueObserverBuilder

longValueObserverBuilder

newBatchRecorder