npm / nestjs-otel
nestjs-otel
What changed in nestjs-otel 6 to 8, from its official release notes, upgrade guides and advisories. Sources checked 2026-10-27.
5 breaking1 deprecations11 new APIs and options1 behavior and defaults7 fixes and other
See which of these apply to your code, ranked, in your agent:
npx @unstale/cli initnestjs-otel 814 changes
Breaking changes 4
The deprecated API metrics middleware has been removed; use SDK auto-instrumentation or the provided decorators for request tracing.
Metrics generated by decorators now use dots instead of underscores as separators; update dashboards and alerts that use default metric names. Custom names are preserved.
The
apiMetricsoption is no longer available.Temporary middleware features were removed.
New APIs and options 7
Adds wide events support for tracing.
Wide events capture error stacks and accumulate timer durations.
A parameter decorator extracts OpenTelemetry Baggage values.
A parameter decorator injects the current OpenTelemetry Span into controller methods.
The decorator supports an
onResultcallback to capture a method's return value.A class-level decorator automatically applies tracing to all methods in a class.
Adds a traceable decorator.
Behavior and default changes 1
Targets the trace root span via a span processor.
Fixes and other changes 2
The peer range now allows NestJS 12, so developers can use nestjs-otel with NestJS 12.
Functions that return thennable objects are no longer eagerly triggered.
nestjs-otel 710 changes
Breaking changes 1
Adopts OpenTelemetry 2.0 and drops support for NestJS 10.
Deprecations 1
apiMetrics is deprecated and will be removed in version 8.0.
New APIs and options 4
Gauge metrics are added to the service and decorators.
The Span decorator gains overloads.
The Span decorator accepts options without requiring an explicit name.
The Span decorator can access method parameters.
Fixes and other changes 4
Preserves the decorated class name.
Preserves the decorated method name.
Preserves decorated method and class names.
The Span decorator preserves the original method name.
nestjs-otel 61 changes
Fixes and other changes 1
Span is no longer incompatible with the MethodDecorator type.