This project is a configuration layer that chooses default values for configuration options that many OpenTelemetry users would ultimately configure manually, allowing for minimal code to quickly instrument with OpenTelemetry.

Latest release built with:

• OpenTelemetry Go v1.28.0/v0.50.0
• OpenTelemetry Go Contrib v1.28.0/v0.53.0
• OpenTelemetry Semantic Conventions v1.26.0

Minimum Go Version: 1.21

See the OpenTelemetry SDK's compatability matrix for more information.

go get github.com/honeycombio/otel-config-go

Minimal setup - by default will send all telemetry via GRPC to localhost:4317

import "github.com/honeycombio/otel-config-go/otelconfig"

func main() {
    otelShutdown, err := otelconfig.ConfigureOpenTelemetry()
    defer otelShutdown()
}

You can set headers directly instead.

import "github.com/honeycombio/otel-config-go/otelconfig"

func main() {
    otelShutdown, err := otelconfig.ConfigureOpenTelemetry(
        otelconfig.WithServiceName("service-name"),
        otelconfig.WithHeaders(map[string]string{
            "service-auth-key": "value",
            "service-useful-field": "testing",
        }),
    )
    defer otelShutdown()
}

As of v1.8.0, this package has been renamed from otel-launcher-go to otel-config-go. When migrating to use the renamed package, all references to launcher should be changed to otelconfig.

This is a joint effort alongside LightStep and is based their initial otel-launcher-go. The intention is to contribute this to OpenTelemetry Go Contrib.