3 Releases 3 Tags

RSS Feed

• v1.1.0 00d15bee8d

  Compare

  Release v1.1.0 Stable

  Rene Nochebuena released this 2026-05-12 13:20:22 -06:00 | 0 commits to main since this release

  v1.1.0

  code.nochebuena.dev/go/telemetry

  Overview

  v1.1.0 adds NewConsole — a logz-backed alternative to New for local development.
  All OTel signals (traces, metrics, OTel log records) are emitted as structured logz log
  lines instead of being forwarded to a Grafana Alloy collector. No infrastructure required.

  What Changed Since v1.0.0

  New: NewConsole

  func NewConsole(ctx context.Context, logger logz.Logger, cfg ConsoleConfig) (func(context.Context) error, error)
  

  Same shutdown pattern as New — drop-in swap for development environments.

  ConsoleConfig requires only service identity fields:

  Field	Env var	Required	Default
  ServiceName	OTEL_SERVICE_NAME	yes	—
  ServiceVersion	OTEL_SERVICE_VERSION	no	unknown
  Environment	OTEL_ENVIRONMENT	no	development

  Output format:

  INFO  otel: span    name=GET /api/v1/permisos  trace_id=3f2a9c...  duration_ms=18  status=Ok
  INFO  otel: metric  name=http.server.duration  kind=histogram  count=5  sum=87.3  unit=ms
  INFO  otel: log     body=cache miss  severity=INFO
  

  Signal details:

  • Traces — synchronous (WithSyncer): one log line immediately on span.End()
  • Metrics — periodic reader (60s interval), flushed on shutdown
  • OTel logs — batch processor, for third-party libs using the OTel log API

  Warning: do not wire the OTel slog bridge alongside NewConsole. It would create a
  feedback loop: logz → slog → OTel log API → logLogExporter → logz.

  Dependency update

  • logz v1.0.1 added as direct dependency; module tier bumped from 1 → 2

  Full API (stable)

  • Config — ServiceName, ServiceVersion, Environment, OTLPEndpoint, OTLPInsecure
  • ConsoleConfig — ServiceName, ServiceVersion, Environment
  • New(ctx, cfg) (func(context.Context) error, error)
  • NewConsole(ctx, logger, cfg) (func(context.Context) error, error)

  Installation

  go get code.nochebuena.dev/go/telemetry@v1.1.0
  

  Changelog

  See CHANGELOG.md.

  Downloads

  • Source Code (ZIP)
  • Source Code (TAR.GZ)