# @opentelemetry/instrumentation-nestjs-core > OpenTelemetry instrumentation for NestJS server side applications framework Latest version **0.68.0** (published 2026-08-31) · Apache-2.0 license · 0 weekly downloads ## Install ```sh npm install @opentelemetry/instrumentation-nestjs-core pnpm add @opentelemetry/instrumentation-nestjs-core yarn add @opentelemetry/instrumentation-nestjs-core bun add @opentelemetry/instrumentation-nestjs-core ``` ## Health **Score 70/100 (B)** — status: active. Positive: has types; no vulnerabilities; has provenance; recently updated; high maintenance score; high quality score. Warnings: low downloads; no esm support; pre 1.0. ## Facts | | | |---|---| | Version | 0.68.0 | | Published | 2026-08-31 | | First published | 2021-09-15 | | Weekly downloads | 0 | | License | Apache-2.0 | | TypeScript types | bundled | | Module format | CommonJS | | Node | ^18.19.0 \|\| >=20.6.0 | | Dependencies | 2 | | Unpacked size | 44.6 KB | | Known vulnerabilities | 0 | | Install scripts | no | | Provenance | attested (GitHub Actions) | | GitHub stars | 929 | | Author | OpenTelemetry Authors | | Maintainers | dyladan, pichlermarc, overbalance, npmjs-account, trentm, martinkuba | | Keywords | instrumentation, nestjs, nestjs-core, nodejs, opentelemetry, profiling, tracing | ## Links - npm: https://www.npmjs.com/package/@opentelemetry/instrumentation-nestjs-core - Repository: https://github.com/open-telemetry/opentelemetry-js-contrib - Homepage: https://github.com/open-telemetry/opentelemetry-js-contrib/tree/main/packages/instrumentation-nestjs-core#readme - Issues: https://github.com/open-telemetry/opentelemetry-js-contrib/issues - npm.io page: https://npm.io/package/@opentelemetry/instrumentation-nestjs-core ## Dependencies (2) - [@opentelemetry/instrumentation](https://npm.io/package/@opentelemetry/instrumentation.md) ^0.222.0 - [@opentelemetry/semantic-conventions](https://npm.io/package/@opentelemetry/semantic-conventions.md) ^1.30.0 ## Recent versions - 0.68.0 (latest) — 2026-08-31 - 0.67.0 — 2026-07-23 - 0.66.0 — 2026-07-03 - 0.65.0 — 2026-06-11 - 0.64.0 — 2026-05-13 - 0.63.0 — 2026-05-06 - 0.62.0 — 2026-04-29 - 0.61.0 — 2026-04-17 - 0.60.0 — 2026-03-26 - 0.59.0 — 2026-03-04 - 0.58.0 — 2026-02-17 - 0.57.0 — 2026-01-22 - 0.56.0 — 2026-01-15 - 0.55.0 — 2025-11-06 - 0.54.0 — 2025-10-21 - … 46 more at https://npm.io/package/@opentelemetry/instrumentation-nestjs-core/versions ## README # OpenTelemetry NestJS Instrumentation for Node.js [![NPM Published Version][npm-img]][npm-url] [![Apache License][license-image]][license-image] This module provides automatic instrumentation for the [Nest framework][pkg-web-url] module. If total installation size is not constrained, it is recommended to use the [`@opentelemetry/auto-instrumentations-node`](https://www.npmjs.com/package/@opentelemetry/auto-instrumentations-node) bundle with [@opentelemetry/sdk-node](https://www.npmjs.com/package/@opentelemetry/sdk-node) for the most seamless instrumentation experience. Compatible with OpenTelemetry JS API and SDK `1.0+`. ## Installation ```bash npm install --save @opentelemetry/instrumentation-nestjs-core ``` ### Supported Versions - [`@nestjs/core`](https://www.npmjs.com/package/@nestjs/core) versions `>=4.0.0 <12` ## Usage OpenTelemetry Nest Instrumentation allows the user to automatically collect trace data from the controller handlers and export them to the backend of choice. To enable a specific instrumentation, pass it to `registerInstrumentations()`. This is commonly done via `NodeSDK` for fully setting up all OpenTelemetry SDK components: ```js const { NodeSDK } = require('@opentelemetry/sdk-node'); const { NestInstrumentation } = require('@opentelemetry/instrumentation-nestjs-core'); const sdk = new NodeSDK({ instrumentations: [ new NestInstrumentation(), ], }); sdk.start(); process.once('beforeExit', async () => { await sdk.shutdown(); }); ``` ## Emitted Spans | Name | `nestjs.type` | Description | Included attributes | |---------------------------------|-------------------|----------------------------------------------------------------------------|-----------------------------| | `Create Nest App` | `app_creation` | Traces the bootup for the Nest App. The `NestFactory(Static).create` call. | `nestjs.module` | | `.` | `request_context` | Traces the whole request context. | `http.*`, `nestjs.callback` | | `` | `handler` | Traces the work of a specific controller member function. | `nestjs.callback` | ## Semantic Conventions This instrumentation creates spans with attributes from the HTTP and NestJS semantic conventions. The `instrumentation-nestjs-core` versions 0.66.0 and later emit the stable v1.23.0+ semantic conventions. Attributes collected: | Attribute | Short Description | |-----------------------|-------------------------------------------------------------------| | `component`* | "@nestjs/core" | | `nestjs.version`* | Version of instrumented `@nestjs/core` package | | `nestjs.type`* | See [NestType](./src/enums/NestType.ts) | | `nestjs.module` | Nest module class name | | `nestjs.controller` | Nest controller class name | | `nestjs.callback` | The function name of the member in the controller | | `http.route` | Route assigned to handler. Ex: `/users/:id` | | `http.request.method` | HTTP method. | | `url.full` | Full request URL. | \* included in all of the spans. ## Useful links - For more information on OpenTelemetry, visit: - For more about OpenTelemetry JavaScript: - For help or feedback on this project, join us in [GitHub Discussions][discussions-url] ## License Apache 2.0 - See [LICENSE][license-url] for more information. [discussions-url]: https://github.com/open-telemetry/opentelemetry-js/discussions [license-url]: https://github.com/open-telemetry/opentelemetry-js-contrib/blob/main/LICENSE [license-image]: https://img.shields.io/badge/license-Apache_2.0-green.svg?style=flat [npm-url]: https://www.npmjs.com/package/@opentelemetry/instrumentation-nestjs-core [npm-img]: https://badge.fury.io/js/%40opentelemetry%2Finstrumentation-nestjs-core.svg [pkg-web-url]: https://nestjs.com/ --- _Source: https://npm.io/package/@opentelemetry/instrumentation-nestjs-core · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._