Documentation
¶
Overview ¶
Package tracing configures the project-wide OpenTelemetry tracer.
Init wires an OTLP/gRPC exporter when the standard OTEL_EXPORTER_* env vars are set (see https://opentelemetry.io/docs/specs/otel/protocol/exporter/); otherwise tracing stays a no-op and instrumented call sites pay only the cost of a Tracer.Start/End pair on the noop tracer. This means binaries can be instrumented unconditionally without requiring an operator to run a collector for local development.
Context propagation (W3C traceparent + baggage) is installed unconditionally so a traceparent header on an incoming RPC is honoured even when this process itself isn't exporting.
Index ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func Init ¶
Init configures the global OpenTelemetry tracer for the process. Returns a shutdown function the caller should defer to flush pending spans on exit; the function is safe to call once and is a no-op when tracing is disabled.
serviceName tags every emitted span with the OTel semantic `service.name` attribute so exporters can group traces by binary (e.g. "hpcc-worker", "hpcc-scheduler").
Tracing is enabled only when OTEL_EXPORTER_OTLP_ENDPOINT (or the trace-specific OTEL_EXPORTER_OTLP_TRACES_ENDPOINT) is set. Without it we leave the global noop tracer in place and return a no-op shutdown — instrumentation in the rest of the codebase still compiles and runs but emits nothing.
Types ¶
This section is empty.
Source Files