Type to search.

OpenTelemetry internal telemetry Assets

Serverless Observability

Elastic Cloud Serverless projects are autoscaled environments, fully managed by Elastic and available on Elastic Cloud.

Availability

  • Generally available

    This functionality is generally available and ready for production usage.

Serverless Security

Elastic Cloud Serverless projects are autoscaled environments, fully managed by Elastic and available on Elastic Cloud.

Availability

  • Generally available

    This functionality is generally available and ready for production usage.

Stack 9.3+

The Elastic Stack includes Elastic's core products such as Elasticsearch, Kibana, Logstash, and Beats.

Availability

  • Generally available since 9.3

    This functionality is generally available and ready for production usage.

Unless stated otherwise on the page, this functionality is available when your Elastic Stack is deployed on Elastic Cloud Hosted, Elastic Cloud Enterprise, Elastic Cloud on Kubernetes, and self-managed environments.

This documentation corresponds to the latest patch available for each minor version. If you're not using the latest patch, check the release notes for changes.

Version 1.2.3 (View all)
Subscription level
What's this?
Basic
Developed by
What's this?
Elastic
Minimum Kibana version(s) 9.3.0

This package contains dashboards that visualize the internal metrics from OpenTelemetry components.

The OTel collector dashboards are compatible with the metrics defined here in the OpenTelemetry collector documentation. The oldest tested version of the OpenTelemetry Collector in combination with this package is v1.44.0.

Furthermore, the package also contains dashboards to visualize metrics from the tailsamplingprocessor. Those metrics are documented here.

The dashboards query metrics from the collectortelemetry dataset. Set the resource attribute data_stream.dataset to collectortelemetry on the collector that emits internal telemetry (see below).

Note

The dashboards expect metrics without postfixes. In particular, Prometheus-format metrics—which apply unit suffixes by default—are not supported. The dashboards are designed for metrics exported via OTLP. If you use the Prometheus exporter, set without_type_suffix and without_units to true. For more information, see the upstream documentation.

The dashboards rely on field names defined in above documentations.

You need to follow the documentation of the OpenTelemetry collector to setup and send internal telemetry to your cluster.

The most important prerequisite is to define the telemetry section under service and to set data_stream.dataset to collectortelemetry.

Text
service:
  telemetry:
    resource:
      data_stream.dataset: 'collectortelemetry'
    metrics:
      readers:
        - periodic:
            exporter:
              otlp:
                protocol: http/protobuf
                endpoint: https://backend:4318

With this, you'll have internal telemetry on normal verbosity level.

The above configuration defines an OTLP endpoint that sends internal telemetry to a target collector over an OTLP connection. This target collector then exports the internal telemetry data to Elasticsearch using the elasticsearch exporter. The integration subsequently reads this internal telemetry data from Elasticsearch.

For all the other config, refer to the upstream documentation.

This integration includes one or more Kibana dashboards that visualizes the data collected by the integration. The screenshots below illustrate how the ingested data is displayed.

Metrics Overview
Changelog
Version Details Minimum Kibana version
1.2.3 Bug fix (View pull request)
Fix Overview dashboard ES|QL failing on unmapped collector counter metrics.
9.3.0
1.2.2 Enhancement (View pull request)
Doc update. Clarify expected metrics format and explicitly calling out that Prometheus format is not supported.
9.3.0
1.2.1 Bug fix (View pull request)
Document setting data_stream.dataset to collectortelemetry and fix queries for TBS dashboards.
9.3.0
1.2.0 Enhancement (View pull request)
Add tailsamplingprocessor specific visualizations and dashboards.
9.3.0
1.1.0 Enhancement (View pull request)
Add alerting rules for failed span, metric point and log record exports.
9.3.0
1.0.0 Enhancement (View pull request)
Add ES|QL based dashboards and increase minimum Kibana version to 9.3.
9.3.0
0.1.0 Enhancement (View pull request)
Add lens based dashboards for older Kibana versions (8.19+).
8.19.0
0.0.4 Enhancement (View pull request)
Separate dashboards per event type and adding more dropdowns to filter by receiver, exporter, processor and more.
9.3.0
0.0.3 Enhancement (View pull request)
Extend docs
—
0.0.2 Enhancement (View pull request)
Use SVG for icon
—
0.0.1 Enhancement (View pull request)
Adding visualizations for OpenTelemetry Collector internal telemetry including CPU, memory, usage, queue size, failed and exported spans, metrics, traces.
—