This documentation is provided as a reference for users who may wish to evaluate or explore OTLP Metrics as it’s being developed.

The OpenTelemetry Collector allows for metric data to be received, processed, and exported via OpenTelemetry Protocol (OTLP). Lightstep supports receiving metric data in the OTLP format.

The Collector has a variety of third party receivers that allow for integration into a wide variety of metric sources.

Please note that not all metrics receivers available for the OpenTelemetry Collector have been tested by Lightstep, and there may be bugs or unexpected issues in using these contributed receivers with Lightstep metrics.

Requirements

  • OpenTelemetry Collector v0.10.0+

Prerequisites

You must have a Lightstep access token for the project to report metrics to.

Configuration

Installation of the OpenTelemetry Collector varies, please refer to the collector documentation for more information.

To configure your collector to report metrics to Lightstep, add the following to your collector’s configuration file:

1
2
3
4
5
6
7
8
9
10
11
12
# add a new exporter and update a pipeline to send metrics to lightstep
exporters:
  otlp/lightstep:
    endpoint: ingest.lightstep.com:443
    headers: {"lightstep-access-token": "<token>"}
    retry_on_failure:
      enabled: false

service:
  pipelines:
    metrics:
      exporters: [otlp/lightstep]

<token> is your Lightstep project access token.

We suggest disabling retry_on_failure until you’ve determined that the metrics you’re attempting to send are successfully ingested by Lightstep. Take advantage of the logging exporter to get more information.