@opentelemetry/metrics

OpenTelemetry Metrics SDK

OpenTelemetry metrics allow a user to collect data and export it to a metrics backend like Prometheus.

Installation

npm install --save @opentelemetry/metrics

Usage

Counter

Choose this kind of metric when the value is a quantity, the sum is of primary interest, and the event count and value distribution are not of primary interest. Counters are defined as Monotonic = true by default, meaning that positive values are expected.

const { Meter } = require('@opentelemetry/metrics');

// Initialize the Meter to capture measurements in various ways.
const meter = new Meter();

const counter = meter.createCounter('metric_name', {
  labelKeys: ["pid"],
  description: "Example of a counter"
});

const labels = meter.labels({ pid: process.pid });

// Create a Handle associated with specified label values.
const handle = counter.getHandle(labels);
handle.add(10);

Gauge

Gauge metrics express a pre-calculated value. Generally, this kind of metric should be used when the metric cannot be expressed as a sum or because the measurement interval is arbitrary. Use this kind of metric when the measurement is not a quantity, and the sum and event count are not of interest. Gauges are defined as Monotonic = false by default, meaning that new values are permitted to make positive or negative changes to the gauge. There is no restriction on the sign of the input for gauges.

const { Meter } = require('@opentelemetry/metrics');

// Initialize the Meter to capture measurements in various ways.
const meter = new Meter();

const gauge = meter.createGauge('metric_name', {
  labelKeys: ["pid"],
  description: "Example of a gauge"
});

const labels = meter.labels({ pid: process.pid });

// Create a Handle associated with specified label values.
const handle = gauge.getHandle(labels);
handle.set(10); // Set to 10

See examples/prometheus for a short example.

Measure

Work in progress

Useful links

• For more information on OpenTelemetry, visit: https://opentelemetry.io/
• For more about OpenTelemetry JavaScript: https://github.com/open-telemetry/opentelemetry-js
• For help or feedback on this project, join us on gitter

License

Apache 2.0 - See LICENSE for more information.

Changelog

0.3.1

Released 2019-12-20

:bug: (Bug Fix)

• opentelemetry-plugin-grpc
  • #631 fix(grpc): patch original client methods
  • #593 fix: transpile to es2017 as esnext may result in unsupported JS code

:books: (Refine Doc)

• Other
  • #629 ci: deploy documentation on releases
  • #581 feat: add OpenTracing example

:rocket: (Enhancement)

• #633 chore: enable incremental builds

:sparkles: (Feature)

• opentelemetry-plugin-xml-http-request
  • #595 feat: implement XMLHttpRequest plugin