Skip to content

go.opentelemetry.io/otel — v1.47.0 snapshot

Pinned: v1.47.0 (semconv API: v1.26.0) Source: tagged source

Tracer

import "go.opentelemetry.io/otel"

tracer := otel.Tracer("github.com/golusoris/golusoris/mypackage")

ctx, span := tracer.Start(ctx, "operation-name")
defer span.End()

span.SetAttributes(attribute.String("key", "value"))
span.RecordError(err)
span.SetStatus(codes.Error, "something went wrong")

Meter

import "go.opentelemetry.io/otel/metric"

meter := otel.Meter("github.com/golusoris/golusoris/mypackage")

counter, err := meter.Int64Counter("requests_total",
    metric.WithDescription("Total requests"),
    metric.WithUnit("{request}"))
if err != nil {
    return fmt.Errorf("create request counter: %w", err)
}
counter.Add(ctx, 1, metric.WithAttributes(attribute.String("method", "GET")))

histogram, err := meter.Float64Histogram("request_duration_seconds")
if err != nil {
    return fmt.Errorf("create request histogram: %w", err)
}
histogram.Record(ctx, duration.Seconds())

SDK setup (OTLP exporter)

import (
    "go.opentelemetry.io/otel/sdk/trace"
    "go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracegrpc"
)

exp, err := otlptracegrpc.New(ctx, otlptracegrpc.WithEndpoint("localhost:4317"))
if err != nil {
    return fmt.Errorf("create OTLP trace exporter: %w", err)
}
tp := trace.NewTracerProvider(
    trace.WithBatcher(exp),
    trace.WithResource(resource.NewWithAttributes(
        semconv.SchemaURL,
        semconv.ServiceName("my-service"),
        semconv.ServiceVersion("v1.0.0"),
    )),
)
otel.SetTracerProvider(tp)

Own tp.Shutdown(ctx) in an Fx lifecycle hook so queued spans are flushed on shutdown.

Semantic conventions (v1.26)

import semconv "go.opentelemetry.io/otel/semconv/v1.26.0"

semconv.ServiceName("my-service")
semconv.HTTPRequestMethodKey.String("GET")
semconv.HTTPResponseStatusCodeKey.Int(200)
semconv.DBSystemPostgreSQL
semconv.MessagingSystemKafka

Context propagation

import "go.opentelemetry.io/otel/propagation"

otel.SetTextMapPropagator(propagation.NewCompositeTextMapPropagator(
    propagation.TraceContext{},
    propagation.Baggage{},
))

// Inject (outbound)
otel.GetTextMapPropagator().Inject(ctx, propagation.HeaderCarrier(req.Header))

// Extract (inbound)
ctx = otel.GetTextMapPropagator().Extract(ctx, propagation.HeaderCarrier(req.Header))

golusoris usage

  • otel/ — SDK initialization and OTLP exporter provided via Fx; sets global tracer and meter providers.
  • core/log/ — slog factory; otel.ModuleWithSlogBridge installs the OTel bridge via go.opentelemetry.io/contrib/bridges/otelslog.
  • otel.export.prometheus adds go.opentelemetry.io/otel/exporters/prometheus v0.69.0 (the release built against v1.47.0) as a pull reader on the app's Prometheus registry.
  • Logs: go.opentelemetry.io/otel/log and go.opentelemetry.io/otel/sdk/log are stable from v1.47.0. The global logger provider is read and set with otel.GetLoggerProvider and otel.SetLoggerProvider; otel/ uses them.