instanaexporter

README

Instana Exporter

Status
Stability	alpha: traces
Distributions	contrib
Issues
Code Owners	@jpkrohling, @hickeyma

The Instana Exporter converts OpenTelemetry trace data and then sends it to the Instana Backend.

Exporter Configuration

The following exporter configuration parameters are supported.

Parameter	Description
endpoint	The 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_key	Your 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:
  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]

Documentation

Index

• func NewFactory() exporter.Factory
• type Config
  • func (cfg *Config) Validate() error

Functions

func NewFactory

func NewFactory() exporter.Factory

NewFactory creates an Instana exporter factory

Types

type Config

type Config struct {
	Endpoint string `mapstructure:"endpoint"`

	AgentKey configopaque.String `mapstructure:"agent_key"`

	confighttp.HTTPClientSettings `mapstructure:",squash"`
}

Config defines configuration for the Instana exporter

func (*Config) Validate

func (cfg *Config) Validate() error

Validate checks if the exporter configuration is valid