Go [Logs]

Requirements: Go ≥ 1.21

1. Environment

OTEL_SERVICE_NAME=my-service
OTEL_RESOURCE_ATTRIBUTES=deployment.environment=production
OTEL_EXPORTER_OTLP_ENDPOINT=https://ingest.tracelit.app
OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf
OTEL_EXPORTER_OTLP_HEADERS=Authorization=Bearer <WORKSPACE_INGEST_KEY>

2. Install packages

go get go.opentelemetry.io/otel@latest
go get go.opentelemetry.io/otel/sdk@latest
go get go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp@latest
go get go.opentelemetry.io/otel/exporters/otlp/otlplog/otlploghttp@latest
go get go.opentelemetry.io/otel/log@latest
go get go.opentelemetry.io/otel/sdk/log@latest
go get go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp@latest

Create an otelsetup package that builds a TracerProvider and a LoggerProvider (OTLP HTTP). Call it once from main before serving traffic.

3. Framework instrumentation

Framework	Package
Gin	`go.opentelemetry.io/contrib/instrumentation/github.com/gin-gonic/gin/otelgin`
Echo	`go.opentelemetry.io/contrib/instrumentation/github.com/labstack/echo/otelecho`
Chi	`go.opentelemetry.io/contrib/instrumentation/github.com/go-chi/chi/otelchi`
net/http	`otelhttp.NewHandler(mux, "server")`

4. Log library bridges

Traces alone are not enough for the onboarding connection check — bridge your logger.

slog
zerolog
zap
logrus

Install

go get go.opentelemetry.io/contrib/bridges/otelslog

Wire

After you create a LoggerProvider pointed at Tracelit:

import (
  "log/slog"
  "go.opentelemetry.io/contrib/bridges/otelslog"
)

slog.SetDefault(slog.New(otelslog.NewHandler("app", otelslog.WithLoggerProvider(lp))))

Produce signals

slog.Info("order listed", "count", 3)
slog.Error("payment failed", "err", err)

Approach

zerolog does not ship a first-party OTel bridge in every version. Recommended pattern:

Keep zerolog for local pretty/JSON output
Add a Hook that forwards each event to go.opentelemetry.io/otel/log using your LoggerProvider

Minimal OTel emit (smoke test)

logger := lp.Logger("app")
var rec otelLog.Record
rec.SetSeverity(otelLog.SeverityInfo)
rec.SetBody(attribute.StringValue("order listed"))
logger.Emit(ctx, rec)

For production, implement a zerolog Hook that maps levels (Debug→DEBUG, Info→INFO, Error/Fatal→ERROR/FATAL) and copies fields as attributes.

Produce signals

log.Info().Int("count", 3).Msg("order listed")
log.Error().Err(err).Msg("payment failed")

Install

go get go.opentelemetry.io/contrib/bridges/otelzap
go get go.uber.org/zap

Wire

import (
  "os"
  "go.uber.org/zap"
  "go.uber.org/zap/zapcore"
  "go.opentelemetry.io/contrib/bridges/otelzap"
)

core := zapcore.NewTee(
  zapcore.NewCore(zapcore.NewJSONEncoder(zap.NewProductionEncoderConfig()), zapcore.AddSync(os.Stdout), zap.InfoLevel),
  otelzap.NewCore("app", otelzap.WithLoggerProvider(lp)),
)
log := zap.New(core)

Produce signals

log.Info("order listed", zap.Int("count", 3))
log.Error("payment failed", zap.Error(err))

Install

go get go.opentelemetry.io/contrib/bridges/otellogrus
go get github.com/sirupsen/logrus

Wire

import (
  "github.com/sirupsen/logrus"
  "go.opentelemetry.io/contrib/bridges/otellogrus"
)

logrus.AddHook(otellogrus.NewHook("app", otellogrus.WithLoggerProvider(lp)))

Produce signals

logrus.WithField("count", 3).Info("order listed")
logrus.WithError(err).Error("payment failed")

5. Verify

Produce one INFO log and one ERROR log, then use Check connection in onboarding (or open Logs in the dashboard). Continue only when both appear.

Frontend

Backend

1. Environment

2. Install packages

3. Framework instrumentation

4. Log library bridges

Install

Wire

Produce signals

Approach

Minimal OTel emit (smoke test)

Produce signals

Install

Wire

Produce signals

Install

Wire

Produce signals

5. Verify

​1. Environment

​2. Install packages

​3. Framework instrumentation

​4. Log library bridges

​Install

​Wire

​Produce signals

​Approach

​Minimal OTel emit (smoke test)

​Produce signals

​Install

​Wire

​Produce signals

​Install

​Wire

​Produce signals

​5. Verify

1. Environment

2. Install packages

3. Framework instrumentation

4. Log library bridges

Install

Wire

Produce signals

Approach

Minimal OTel emit (smoke test)

Produce signals

Install

Wire

Produce signals

Install

Wire

Produce signals

5. Verify