The package-doc examples showed a fictional launcher.Register / health.Register
API (and launcher.Append as a package func). Corrected to the real wiring:
lc.Append + web/health.NewHandler(...).ServeHTTP.
Also: launcher.BeforeStop (nonexistent) -> defer shutdown, matching the README.
Documentation-only. No code, API, or dependency changes; version stays v1.1.0
(the v1.1.0 tag is moved to include this fix). Verified by compiling the
corrected pattern against the real API.
Introduces code.nochebuena.dev/einherjar/telemetry — the observability bootstrap
starter for the Einherjar framework. Absorbs the telemetry package from micro-lib,
migrating from OpenCensus to OpenTelemetry SDK v1.42.
Bootstrap functions (not lifecycle.Component — telemetry must be initialized before
the launcher starts, and its shutdown must run after all components stop):
- New(ctx, cfg) (func(context.Context) error, error) — production mode; exports
traces, metrics, and logs via OTLP over gRPC to the configured endpoint;
returns a shutdown function to be deferred in main()
- NewConsole(ctx, logger, cfg) (func(context.Context) error, error) — development
mode; writes structured telemetry to the provided logging.Logger; no network
dependency; suitable for local development and CI
Config (EINHERJAR_OTEL_* env vars):
ServiceName(required), ServiceVersion(unknown), Environment(development),
OTLPEndpoint(required for New), OTLPInsecure(false)
ConsoleConfig (EINHERJAR_OTEL_* env vars):
ServiceName(required), ServiceVersion(unknown), Environment(development)
- identifiable.go: package-level Module variable (observability.Identifiable) for version
identification — telemetry bootstraps before the launcher; not registered as a lifecycle component
Rene Nochebuena