# What changed in nestjs-otel

> 25 changes in nestjs-otel 6 to 8 from its official release notes, upgrade guides and advisories: 5 breaking, 1 deprecations, 11 new APIs and options. Each one cited. Sources checked 2026-10-27. HTML: https://unstale.sh/npm/nestjs-otel/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## nestjs-otel 8

### Breaking changes

- The deprecated API metrics middleware has been removed; use SDK auto-instrumentation or the provided decorators for request tracing. (8.0.0) — [upgrade guide](https://github.com/pragmaticivan/nestjs-otel/blob/HEAD/UPGRADING.md)
- 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. (8.0.0) — [upgrade guide](https://github.com/pragmaticivan/nestjs-otel/blob/HEAD/UPGRADING.md), [release notes](https://github.com/pragmaticivan/nestjs-otel/releases/tag/v8.0.0)
- The `apiMetrics` option is no longer available. (8.0.0) — [upgrade guide](https://github.com/pragmaticivan/nestjs-otel/blob/HEAD/UPGRADING.md)
- Temporary middleware features were removed. (8.0.0) — [release notes](https://github.com/pragmaticivan/nestjs-otel/releases/tag/v8.0.0)

### New APIs and options

- Adds wide events support for tracing. (8.1.0) — [release notes](https://github.com/pragmaticivan/nestjs-otel/releases/tag/v8.1.0)
- Wide events capture error stacks and accumulate timer durations. (8.1.0) — [release notes](https://github.com/pragmaticivan/nestjs-otel/releases/tag/v8.1.0)
- A parameter decorator extracts OpenTelemetry Baggage values. (8.0.0) — [upgrade guide](https://github.com/pragmaticivan/nestjs-otel/blob/HEAD/UPGRADING.md), [release notes](https://github.com/pragmaticivan/nestjs-otel/releases/tag/v8.0.0)
- A parameter decorator injects the current OpenTelemetry Span into controller methods. (8.0.0) — [upgrade guide](https://github.com/pragmaticivan/nestjs-otel/blob/HEAD/UPGRADING.md), [release notes](https://github.com/pragmaticivan/nestjs-otel/releases/tag/v8.0.0)
- The decorator supports an `onResult` callback to capture a method's return value. (8.0.0) — [upgrade guide](https://github.com/pragmaticivan/nestjs-otel/blob/HEAD/UPGRADING.md), [release notes](https://github.com/pragmaticivan/nestjs-otel/releases/tag/v8.0.0)
- A class-level decorator automatically applies tracing to all methods in a class. (8.0.0) — [upgrade guide](https://github.com/pragmaticivan/nestjs-otel/blob/HEAD/UPGRADING.md)
- Adds a traceable decorator. (8.0.0) — [release notes](https://github.com/pragmaticivan/nestjs-otel/releases/tag/v8.0.0)

### Behavior and default changes

- Targets the trace root span via a span processor. (8.1.0) — [release notes](https://github.com/pragmaticivan/nestjs-otel/releases/tag/v8.1.0)

### Fixes and other changes

- The peer range now allows NestJS 12, so developers can use nestjs-otel with NestJS 12. (8.1.1) — [release notes](https://github.com/pragmaticivan/nestjs-otel/releases/tag/v8.1.1)
- Functions that return thennable objects are no longer eagerly triggered. (8.0.3) — [release notes](https://github.com/pragmaticivan/nestjs-otel/releases/tag/v8.0.3)

## nestjs-otel 7

### Breaking changes

- Adopts OpenTelemetry 2.0 and drops support for NestJS 10. (7.0.0) — [release notes](https://github.com/pragmaticivan/nestjs-otel/releases/tag/v7.0.0)

### Deprecations

- apiMetrics is deprecated and will be removed in version 8.0. (7.0.0) — [release notes](https://github.com/pragmaticivan/nestjs-otel/releases/tag/v7.0.0)

### New APIs and options

- Gauge metrics are added to the service and decorators. (7.0.0) — [release notes](https://github.com/pragmaticivan/nestjs-otel/releases/tag/v7.0.0)
- The Span decorator gains overloads. (7.0.0) — [release notes](https://github.com/pragmaticivan/nestjs-otel/releases/tag/v7.0.0)
- The Span decorator accepts options without requiring an explicit name. (7.0.0) — [release notes](https://github.com/pragmaticivan/nestjs-otel/releases/tag/v7.0.0)
- The Span decorator can access method parameters. (7.0.0) — [release notes](https://github.com/pragmaticivan/nestjs-otel/releases/tag/v7.0.0)

### Fixes and other changes

- Preserves the decorated class name. (7.0.0) — [release notes](https://github.com/pragmaticivan/nestjs-otel/releases/tag/v7.0.0)
- Preserves the decorated method name. (7.0.0) — [release notes](https://github.com/pragmaticivan/nestjs-otel/releases/tag/v7.0.0)
- Preserves decorated method and class names. (7.0.0) — [release notes](https://github.com/pragmaticivan/nestjs-otel/releases/tag/v7.0.0)
- The Span decorator preserves the original method name. (7.0.0) — [release notes](https://github.com/pragmaticivan/nestjs-otel/releases/tag/v7.0.0)

## nestjs-otel 6

### Fixes and other changes

- Span is no longer incompatible with the MethodDecorator type. (6.0.0) — [release notes](https://github.com/pragmaticivan/nestjs-otel/releases/tag/v6.0.0)