Skip to main content

Instana Exporter

Status Source: opentelemetry-collector-contrib

Overview

Status
Stabilityalpha
Supported pipeline typestraces
Distributionscontrib
The Instana Exporter converts OpenTelemetry trace data and then sends it to the Instana Backend.

Exporter Configuration

The following exporter configuration parameters are supported.
ParameterDescription
endpointThe Instana backend endpoint that the Exporter connects to. It depends on your region and how it is hosted. It starts with https://serverless- for SaaS. Otherwise, it starts with https://. It corresponds to the Instana environment variable INSTANA_ENDPOINT_URL
agent_keyYour Instana Agent key. The same agent key can be used for host agents and serverless monitoring. It corresponds to the Instana environment variable INSTANA_AGENT_KEY
tls/ca_file[Optional] Certificate authority file for an Instana backend connection where the backend uses a self signed certificate.
These parameters match the Instana Serverless Monitoring environment variables and can be found here.

Sample Configuration

The code snippet below shows how your configuration file should look like:
[...]

exporters:
  instana:
    endpoint: ${env:INSTANA_ENDPOINT_URL}
    agent_key: ${env:INSTANA_AGENT_KEY}

[...]

service:
  pipelines:
    traces:
      exporters: [instana]

[...]

Full Example

receivers:
  otlp:
    protocols:
      grpc:
      http:

processors:
  batch:
exporters:
  logging:
    loglevel: debug
  instana:
    endpoint: ${env:INSTANA_ENDPOINT_URL}
    agent_key: ${env:INSTANA_AGENT_KEY}
    tls:
      ca_file: someCA.pem # Optional. Certificate authority file for Instana backend connection.

service:
  pipelines:
    traces:
      receivers: [otlp]
      processors: [batch]
      exporters: [instana]

Configuration

Example Configuration

instana/bad_endpoint:
  endpoint: never a url
  agent_key: key1
  tls:
    ca_file: ca.crt
instana/missing_agent_key:
  endpoint: https://example.com/api/
  tls:
    ca_file: ca.crt
instana/valid:
  endpoint: https://example.com/api/
  agent_key: key1
instana/valid_with_ca_file:
  endpoint: https://example.com/api/
  agent_key: key1
  tls:
    ca_file: ca.crt
instana/valid_no_ca_file:
  endpoint: https://example.com/api/
  agent_key: key1
instana/non_https_endpoint:
  endpoint: http://example.com/api/
  agent_key: key1

Last generated: 2026-04-14