@application-kit/observability 0.3.0 → 0.4.0

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @application-kit/observability
 
+## 0.4.0
+
+### Minor Changes
+
+- 29b4378: Вход `/tracing` (только ESM): `startTracing({ esmHookedModules, instrumentations, resolveClientIp })` — OpenTelemetry
+  NodeSDK для `node --import` с OTLP gRPC-экспортёром, спанами HTTP-сервера без служебных путей и с `client.address`,
+  ESM-хуком строго по списку модулей и флашем на `beforeExit`; без endpoint'а коллектора не делает ничего.
+
+## 0.3.1
+
+### Patch Changes
+
+- 3ed0384: `HealthCliModule`: команда `health` снова регистрируется в группе потребителя. В 0.3.0 она была унаследована подклассом-группой,
+  а сканер nestjs-console видит только собственные методы класса — CLI отвечал `too many arguments for '<группа>'`, и проверка
+  по крону не выполнялась.
+
 ## 0.3.0
 
 ### Minor Changes

package/README.md

@@ -24,6 +24,7 @@ Peer-зависимости: `@nestjs/common`, `@prometheus-io/client`; оста
 | `@application-kit/observability/http` | `resolveClientIp` — IP клиента за прокси | ничего |
 | `@application-kit/observability/logging` | опции nestjs-pino, request-id, support-id, служебные пути, токен логгера | `@opentelemetry/api`, `class-validator`, `class-transformer`; типы — `nestjs-pino`, `pino` |
 | `@application-kit/observability/metrics` | реестр, гистограммы HTTP и GraphQL, `GET /metrics`, хуки Fastify, сервер `/metrics` | `@nestjs/common`, `@prometheus-io/client`; типы — `fastify`, `@nestjs/platform-fastify` |
+| `@application-kit/observability/tracing` | `startTracing` — OpenTelemetry NodeSDK для `node --import`, только ESM | `@opentelemetry/sdk-node`, `@opentelemetry/instrumentation`, `@opentelemetry/instrumentation-http`, `@opentelemetry/exporter-trace-otlp-grpc`, `@opentelemetry/semantic-conventions` |
 
 Корневого входа нет: каждый вход несёт свои peer-зависимости, и лишнего потребитель не ставит.
 
@@ -137,3 +138,38 @@ export class WebModule {}
 ```ts
 const clientIp = resolveClientIp(request, { trustedHeaders: ['cf-connecting-ip'] })
 ```
+
+## Трейсинг (`/tracing`)
+
+`startTracing({ esmHookedModules, instrumentations, resolveClientIp })` поднимает OpenTelemetry NodeSDK: OTLP gRPC-экспортёр,
+спаны HTTP-сервера без служебных путей (`isInfrastructurePath` входа `/logging`) и с `client.address` корневого спана,
+хук import-in-the-middle строго по списку модулей, флаш спанов на `beforeExit`. Endpoint, sampling, `service.name` и
+атрибуты ресурса SDK читает из стандартных `OTEL_*`; без `OTEL_EXPORTER_OTLP_TRACES_ENDPOINT` (или
+`OTEL_EXPORTER_OTLP_ENDPOINT`) функция не делает ничего — ни хука, ни инструментаций — и отдаёт `undefined`.
+
+Вызов — в отдельном файле, который бандлер собирает в свой выход и который процесс грузит флагом рантайма
+`node --import ./tracing.mjs`: инструментации патчат модули в момент загрузки, а ESM выполняет все `import` бандла до
+его первой строки, поэтому импорт из кода приложения опоздал бы. Вход только ESM — `module.register` есть лишь у
+ESM-загрузчика.
+
+- `esmHookedModules` — пакеты, которые бандл импортирует как ESM (например `kafkajs`): до них не дотягивается
+  require-in-the-middle. Хук без списка обернул бы и чанки самого бандла и порвал бы им live-binding.
+- `instrumentations` — фабрика инструментаций продукта (фреймворк, драйвер БД, брокер): конструктор инструментации
+  сразу патчит модуль, поэтому вызывается фабрика, только когда трейсинг включён.
+- `resolveClientIp` — резолвер адреса клиента; дефолт — `resolveClientIp` входа `/http` без доверенных заголовков.
+
+```ts
+// src/tracing.ts → vite build --ssr src/tracing.ts → node --import ./tracing.mjs ./web.mjs
+startTracing({
+  esmHookedModules: ['kafkajs'],
+  instrumentations: () => [
+    new FastifyOtelInstrumentation({ registerOnInitialization: true }),
+    new PgInstrumentation(),
+    new KafkaJsInstrumentation(),
+  ],
+  resolveClientIp: (request) => resolveClientIp(request, { trustedHeaders: ['cf-connecting-ip'] }),
+})
+```
+
+Версии `@opentelemetry/*` с номером `0.x` выходят одним релизом и между собой совместимы только в пределах одного минора:
+`sdk-node`, `instrumentation`, `instrumentation-http` и `exporter-trace-otlp-grpc` ставятся одной версией `0.221.x`.

package/dist/cjs/health/cli/health-cli-commands.d.ts

@@ -0,0 +1,10 @@
+import { HealthCheckService } from '@nestjs/terminus';
+import type { ObservabilityLoggerInterface } from '../../logging/observability-logger.interface.js';
+import { HealthChecks } from '../health-checks.js';
+export declare class HealthCliCommands {
+    private readonly health;
+    private readonly logger;
+    private readonly healthChecks;
+    constructor(health: HealthCheckService, logger: ObservabilityLoggerInterface, healthChecks: HealthChecks);
+    getHealth(): Promise<void>;
+}

package/dist/cjs/health/cli/health-cli-commands.js

@@ -0,0 +1,46 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HealthCliCommands = void 0;
+const common_1 = require("@nestjs/common");
+const terminus_1 = require("@nestjs/terminus");
+const constants_js_1 = require("../../logging/constants.js");
+const health_checks_js_1 = require("../health-checks.js");
+let HealthCliCommands = class HealthCliCommands {
+    health;
+    logger;
+    healthChecks;
+    constructor(health, logger, healthChecks) {
+        this.health = health;
+        this.logger = logger;
+        this.healthChecks = healthChecks;
+    }
+    async getHealth() {
+        try {
+            const healthResult = await this.health.check(this.healthChecks.build());
+            this.logger.info({ healthResult }, healthResult.status);
+        }
+        catch (error) {
+            const healthResult = error instanceof common_1.ServiceUnavailableException ? error.getResponse() : 'unknown';
+            this.logger.error({ healthResult }, 'error');
+        }
+    }
+};
+exports.HealthCliCommands = HealthCliCommands;
+exports.HealthCliCommands = HealthCliCommands = __decorate([
+    __param(0, (0, common_1.Inject)(terminus_1.HealthCheckService)),
+    __param(1, (0, common_1.Inject)(constants_js_1.OBSERVABILITY_LOGGER)),
+    __param(2, (0, common_1.Inject)(health_checks_js_1.HealthChecks)),
+    __metadata("design:paramtypes", [terminus_1.HealthCheckService, Object, health_checks_js_1.HealthChecks])
+], HealthCliCommands);

package/dist/cjs/health/cli/health-cli.d.ts

@@ -1,13 +1,4 @@
 import type { Type } from '@nestjs/common';
-import { HealthCheckService } from '@nestjs/terminus';
-import type { ObservabilityLoggerInterface } from '../../logging/observability-logger.interface.js';
 import type { HealthCliOptionsInterface } from './health-cli-options.interface.js';
-import { HealthChecks } from '../health-checks.js';
-export declare class HealthCliCommands {
-    private readonly health;
-    private readonly logger;
-    private readonly healthChecks;
-    constructor(health: HealthCheckService, logger: ObservabilityLoggerInterface, healthChecks: HealthChecks);
-    getHealth(): Promise<void>;
-}
+import { HealthCliCommands } from './health-cli-commands.js';
 export declare const createHealthCli: (options: HealthCliOptionsInterface) => Type<HealthCliCommands>;

package/dist/cjs/health/cli/health-cli.js

@@ -8,49 +8,25 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
-var __param = (this && this.__param) || function (paramIndex, decorator) {
-    return function (target, key) { decorator(target, key, paramIndex); }
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createHealthCli = exports.HealthCliCommands = void 0;
-const common_1 = require("@nestjs/common");
-const terminus_1 = require("@nestjs/terminus");
+exports.createHealthCli = void 0;
 const nestjs_console_1 = require("nestjs-console");
-const constants_js_1 = require("../../logging/constants.js");
-const with_class_decorator_js_1 = require("../../shared/with-class-decorator.js");
-const health_checks_js_1 = require("../health-checks.js");
-let HealthCliCommands = class HealthCliCommands {
-    health;
-    logger;
-    healthChecks;
-    constructor(health, logger, healthChecks) {
-        this.health = health;
-        this.logger = logger;
-        this.healthChecks = healthChecks;
-    }
-    async getHealth() {
-        try {
-            const healthResult = await this.health.check(this.healthChecks.build());
-            this.logger.info({ healthResult }, healthResult.status);
-        }
-        catch (error) {
-            const healthResult = error instanceof common_1.ServiceUnavailableException ? error.getResponse() : 'unknown';
-            this.logger.error({ healthResult }, 'error');
+const health_cli_commands_js_1 = require("./health-cli-commands.js");
+const createHealthCli = (options) => {
+    let HealthCli = class HealthCli extends health_cli_commands_js_1.HealthCliCommands {
+        async getHealth() {
+            await super.getHealth();
         }
-    }
+    };
+    __decorate([
+        (0, nestjs_console_1.Command)({ command: 'health' }),
+        __metadata("design:type", Function),
+        __metadata("design:paramtypes", []),
+        __metadata("design:returntype", Promise)
+    ], HealthCli.prototype, "getHealth", null);
+    HealthCli = __decorate([
+        (0, nestjs_console_1.Console)({ command: options.command })
+    ], HealthCli);
+    return HealthCli;
 };
-exports.HealthCliCommands = HealthCliCommands;
-__decorate([
-    (0, nestjs_console_1.Command)({ command: 'health' }),
-    __metadata("design:type", Function),
-    __metadata("design:paramtypes", []),
-    __metadata("design:returntype", Promise)
-], HealthCliCommands.prototype, "getHealth", null);
-exports.HealthCliCommands = HealthCliCommands = __decorate([
-    __param(0, (0, common_1.Inject)(terminus_1.HealthCheckService)),
-    __param(1, (0, common_1.Inject)(constants_js_1.OBSERVABILITY_LOGGER)),
-    __param(2, (0, common_1.Inject)(health_checks_js_1.HealthChecks)),
-    __metadata("design:paramtypes", [terminus_1.HealthCheckService, Object, health_checks_js_1.HealthChecks])
-], HealthCliCommands);
-const createHealthCli = (options) => (0, with_class_decorator_js_1.withClassDecorator)(HealthCliCommands, (0, nestjs_console_1.Console)({ command: options.command }));
 exports.createHealthCli = createHealthCli;

package/dist/cjs/health/cli/index.d.ts

@@ -1,3 +1,4 @@
 export * from './health-cli.js';
+export * from './health-cli-commands.js';
 export * from './health-cli-options.interface.js';
 export * from './health-cli.module.js';

package/dist/cjs/health/cli/index.js

@@ -15,5 +15,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./health-cli.js"), exports);
+__exportStar(require("./health-cli-commands.js"), exports);
 __exportStar(require("./health-cli-options.interface.js"), exports);
 __exportStar(require("./health-cli.module.js"), exports);

package/dist/esm/health/cli/health-cli-commands.d.ts

@@ -0,0 +1,10 @@
+import { HealthCheckService } from '@nestjs/terminus';
+import type { ObservabilityLoggerInterface } from '../../logging/observability-logger.interface.js';
+import { HealthChecks } from '../health-checks.js';
+export declare class HealthCliCommands {
+    private readonly health;
+    private readonly logger;
+    private readonly healthChecks;
+    constructor(health: HealthCheckService, logger: ObservabilityLoggerInterface, healthChecks: HealthChecks);
+    getHealth(): Promise<void>;
+}

package/dist/esm/health/cli/health-cli-commands.js

@@ -0,0 +1,43 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { Inject, ServiceUnavailableException } from '@nestjs/common';
+import { HealthCheckService } from '@nestjs/terminus';
+import { OBSERVABILITY_LOGGER } from '../../logging/constants.js';
+import { HealthChecks } from '../health-checks.js';
+let HealthCliCommands = class HealthCliCommands {
+    health;
+    logger;
+    healthChecks;
+    constructor(health, logger, healthChecks) {
+        this.health = health;
+        this.logger = logger;
+        this.healthChecks = healthChecks;
+    }
+    async getHealth() {
+        try {
+            const healthResult = await this.health.check(this.healthChecks.build());
+            this.logger.info({ healthResult }, healthResult.status);
+        }
+        catch (error) {
+            const healthResult = error instanceof ServiceUnavailableException ? error.getResponse() : 'unknown';
+            this.logger.error({ healthResult }, 'error');
+        }
+    }
+};
+HealthCliCommands = __decorate([
+    __param(0, Inject(HealthCheckService)),
+    __param(1, Inject(OBSERVABILITY_LOGGER)),
+    __param(2, Inject(HealthChecks)),
+    __metadata("design:paramtypes", [HealthCheckService, Object, HealthChecks])
+], HealthCliCommands);
+export { HealthCliCommands };

package/dist/esm/health/cli/health-cli.d.ts

@@ -1,13 +1,4 @@
 import type { Type } from '@nestjs/common';
-import { HealthCheckService } from '@nestjs/terminus';
-import type { ObservabilityLoggerInterface } from '../../logging/observability-logger.interface.js';
 import type { HealthCliOptionsInterface } from './health-cli-options.interface.js';
-import { HealthChecks } from '../health-checks.js';
-export declare class HealthCliCommands {
-    private readonly health;
-    private readonly logger;
-    private readonly healthChecks;
-    constructor(health: HealthCheckService, logger: ObservabilityLoggerInterface, healthChecks: HealthChecks);
-    getHealth(): Promise<void>;
-}
+import { HealthCliCommands } from './health-cli-commands.js';
 export declare const createHealthCli: (options: HealthCliOptionsInterface) => Type<HealthCliCommands>;

package/dist/esm/health/cli/health-cli.js

@@ -7,46 +7,22 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
-var __param = (this && this.__param) || function (paramIndex, decorator) {
-    return function (target, key) { decorator(target, key, paramIndex); }
-};
-import { Inject, ServiceUnavailableException } from '@nestjs/common';
-import { HealthCheckService } from '@nestjs/terminus';
 import { Command, Console } from 'nestjs-console';
-import { OBSERVABILITY_LOGGER } from '../../logging/constants.js';
-import { withClassDecorator } from '../../shared/with-class-decorator.js';
-import { HealthChecks } from '../health-checks.js';
-let HealthCliCommands = class HealthCliCommands {
-    health;
-    logger;
-    healthChecks;
-    constructor(health, logger, healthChecks) {
-        this.health = health;
-        this.logger = logger;
-        this.healthChecks = healthChecks;
-    }
-    async getHealth() {
-        try {
-            const healthResult = await this.health.check(this.healthChecks.build());
-            this.logger.info({ healthResult }, healthResult.status);
-        }
-        catch (error) {
-            const healthResult = error instanceof ServiceUnavailableException ? error.getResponse() : 'unknown';
-            this.logger.error({ healthResult }, 'error');
+import { HealthCliCommands } from './health-cli-commands.js';
+export const createHealthCli = (options) => {
+    let HealthCli = class HealthCli extends HealthCliCommands {
+        async getHealth() {
+            await super.getHealth();
         }
-    }
+    };
+    __decorate([
+        Command({ command: 'health' }),
+        __metadata("design:type", Function),
+        __metadata("design:paramtypes", []),
+        __metadata("design:returntype", Promise)
+    ], HealthCli.prototype, "getHealth", null);
+    HealthCli = __decorate([
+        Console({ command: options.command })
+    ], HealthCli);
+    return HealthCli;
 };
-__decorate([
-    Command({ command: 'health' }),
-    __metadata("design:type", Function),
-    __metadata("design:paramtypes", []),
-    __metadata("design:returntype", Promise)
-], HealthCliCommands.prototype, "getHealth", null);
-HealthCliCommands = __decorate([
-    __param(0, Inject(HealthCheckService)),
-    __param(1, Inject(OBSERVABILITY_LOGGER)),
-    __param(2, Inject(HealthChecks)),
-    __metadata("design:paramtypes", [HealthCheckService, Object, HealthChecks])
-], HealthCliCommands);
-export { HealthCliCommands };
-export const createHealthCli = (options) => withClassDecorator(HealthCliCommands, Console({ command: options.command }));

package/dist/esm/health/cli/index.d.ts

@@ -1,3 +1,4 @@
 export * from './health-cli.js';
+export * from './health-cli-commands.js';
 export * from './health-cli-options.interface.js';
 export * from './health-cli.module.js';

package/dist/esm/health/cli/index.js

@@ -1,3 +1,4 @@
 export * from './health-cli.js';
+export * from './health-cli-commands.js';
 export * from './health-cli-options.interface.js';
 export * from './health-cli.module.js';

package/dist/esm/tracing/index.d.ts

@@ -0,0 +1,2 @@
+export * from './start-tracing.js';
+export * from './tracing-options.interface.js';

package/dist/esm/tracing/index.js

@@ -0,0 +1,2 @@
+export * from './start-tracing.js';
+export * from './tracing-options.interface.js';

package/dist/esm/tracing/start-tracing.d.ts

@@ -0,0 +1,3 @@
+import { NodeSDK } from '@opentelemetry/sdk-node';
+import type { TracingOptionsInterface } from './tracing-options.interface.js';
+export declare const startTracing: (options: TracingOptionsInterface) => NodeSDK | undefined;

package/dist/esm/tracing/start-tracing.js

@@ -0,0 +1,55 @@
+import { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-grpc';
+import { HttpInstrumentation } from '@opentelemetry/instrumentation-http';
+import { NodeSDK } from '@opentelemetry/sdk-node';
+import { ATTR_CLIENT_ADDRESS } from '@opentelemetry/semantic-conventions';
+import { register } from 'node:module';
+import nodeProcess from 'node:process';
+import { resolveClientIp } from '../http/resolve-client-ip.js';
+import { isInfrastructurePath } from '../logging/infrastructure-paths.js';
+const withoutQuery = (url) => {
+    const queryStart = url.indexOf('?');
+    return queryStart === -1 ? url : url.slice(0, queryStart);
+};
+const isServiceRequest = (request) => request.url !== undefined
+    && isInfrastructurePath(withoutQuery(request.url));
+const createHttpInstrumentation = (clientIp = resolveClientIp) => {
+    const clientAddressAttributes = (request) => {
+        const address = clientIp(request);
+        return address === '' ? {} : { [ATTR_CLIENT_ADDRESS]: address };
+    };
+    return new HttpInstrumentation({
+        ignoreIncomingRequestHook: isServiceRequest,
+        startIncomingSpanHook: clientAddressAttributes,
+    });
+};
+const flushSpans = async (sdk) => {
+    try {
+        await sdk.shutdown();
+    }
+    catch {
+    }
+};
+const tracesEndpoint = () => {
+    const { env } = nodeProcess;
+    return (env.OTEL_EXPORTER_OTLP_TRACES_ENDPOINT ?? env.OTEL_EXPORTER_OTLP_ENDPOINT ?? '').trim();
+};
+export const startTracing = (options) => {
+    if (tracesEndpoint() === '') {
+        return undefined;
+    }
+    register('@opentelemetry/instrumentation/hook.mjs', import.meta.url, {
+        data: { include: options.esmHookedModules },
+    });
+    const sdk = new NodeSDK({
+        instrumentations: [
+            createHttpInstrumentation(options.resolveClientIp),
+            ...options.instrumentations?.() ?? [],
+        ],
+        traceExporter: new OTLPTraceExporter(),
+    });
+    sdk.start();
+    nodeProcess.once('beforeExit', () => {
+        void flushSpans(sdk);
+    });
+    return sdk;
+};

package/dist/esm/tracing/tracing-options.interface.d.ts

@@ -0,0 +1,8 @@
+import type { Instrumentation } from '@opentelemetry/instrumentation';
+import type { ClientIpResolver } from '../logging/pino-logger-options.interface.js';
+export type InstrumentationsFactory = () => Instrumentation[];
+export interface TracingOptionsInterface {
+    readonly esmHookedModules: readonly string[];
+    readonly instrumentations?: InstrumentationsFactory;
+    readonly resolveClientIp?: ClientIpResolver;
+}

package/dist/esm/tracing/tracing-options.interface.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@application-kit/observability",
-  "version": "0.3.0",
-  "description": "Наблюдаемость NestJS-процесса: метрики Prometheus и RED-гистограммы, health-чеки и пробы, опции pino с request-id и trace-контекстом, логирование CQRS-шин, реальный IP клиента за прокси",
+  "version": "0.4.0",
+  "description": "Наблюдаемость NestJS-процесса: метрики Prometheus и RED-гистограммы, health-чеки и пробы, опции pino с request-id и trace-контекстом, логирование CQRS-шин, реальный IP клиента за прокси, трейсинг OpenTelemetry",
   "keywords": [
     "cqrs",
     "health",
@@ -9,9 +9,11 @@
     "metrics",
     "nestjs",
     "observability",
+    "opentelemetry",
     "pino",
     "prometheus",
-    "terminus"
+    "terminus",
+    "tracing"
   ],
   "homepage": "https://gitlab.com/application-kit/application-kit/-/tree/main/packages/observability",
   "bugs": "https://gitlab.com/application-kit/application-kit/-/issues",
@@ -97,7 +99,13 @@
         "default": "./dist/cjs/metrics/index.js"
       }
     },
-    "./package.json": "./package.json"
+    "./package.json": "./package.json",
+    "./tracing": {
+      "import": {
+        "types": "./dist/esm/tracing/index.d.ts",
+        "default": "./dist/esm/tracing/index.js"
+      }
+    }
   },
   "main": "./dist/cjs/metrics/index.js",
   "module": "./dist/esm/metrics/index.js",
@@ -106,7 +114,7 @@
     "dist"
   ],
   "scripts": {
-    "build": "rm -rf ./dist && node ../../scripts/barrels.mjs create ./src/cqrs && node ../../scripts/barrels.mjs create ./src/health --entry-only=cli,graphql && node ../../scripts/barrels.mjs create ./src/http && node ../../scripts/barrels.mjs create ./src/logging && node ../../scripts/barrels.mjs create ./src/metrics && tsc --project tsconfig.build.json && tsc --project tsconfig.build.cjs.json && node ../../scripts/barrels.mjs clean ./src && node ../../scripts/mark-cjs.mjs ./dist/cjs",
+    "build": "rm -rf ./dist && node ../../scripts/barrels.mjs create ./src/cqrs && node ../../scripts/barrels.mjs create ./src/health --entry-only=cli,graphql && node ../../scripts/barrels.mjs create ./src/http && node ../../scripts/barrels.mjs create ./src/logging && node ../../scripts/barrels.mjs create ./src/metrics && node ../../scripts/barrels.mjs create ./src/tracing && tsc --project tsconfig.build.json && tsc --project tsconfig.build.cjs.json && node ../../scripts/barrels.mjs clean ./src && node ../../scripts/mark-cjs.mjs ./dist/cjs",
     "lint:tsc": "tsc --noEmit --pretty --project .",
     "test:mutation": "stryker run",
     "test:unit": "vitest run"
@@ -124,6 +132,11 @@
     "@nestjs/testing": "^11.2.7",
     "@nestjs/typeorm": "^11.0.3",
     "@opentelemetry/api": "^1.9.1",
+    "@opentelemetry/exporter-trace-otlp-grpc": "^0.221.0",
+    "@opentelemetry/instrumentation": "^0.221.0",
+    "@opentelemetry/instrumentation-http": "^0.221.0",
+    "@opentelemetry/sdk-node": "^0.221.0",
+    "@opentelemetry/semantic-conventions": "^1.43.0",
     "@prometheus-io/client": "^0.16.0",
     "@stryker-mutator/core": "^10.0.0",
     "@stryker-mutator/vitest-runner": "^10.0.0",
@@ -149,6 +162,11 @@
     "@nestjs/terminus": "^11.0.0",
     "@nestjs/typeorm": "^11.0.0",
     "@opentelemetry/api": "^1.9.0",
+    "@opentelemetry/exporter-trace-otlp-grpc": "^0.221.0",
+    "@opentelemetry/instrumentation": "^0.221.0",
+    "@opentelemetry/instrumentation-http": "^0.221.0",
+    "@opentelemetry/sdk-node": "^0.221.0",
+    "@opentelemetry/semantic-conventions": "^1.43.0",
     "@prometheus-io/client": "^0.16.0",
     "class-transformer": "^0.5.1",
     "class-validator": "^0.15.1",
@@ -178,6 +196,21 @@
     "@opentelemetry/api": {
       "optional": true
     },
+    "@opentelemetry/exporter-trace-otlp-grpc": {
+      "optional": true
+    },
+    "@opentelemetry/instrumentation": {
+      "optional": true
+    },
+    "@opentelemetry/instrumentation-http": {
+      "optional": true
+    },
+    "@opentelemetry/sdk-node": {
+      "optional": true
+    },
+    "@opentelemetry/semantic-conventions": {
+      "optional": true
+    },
     "class-transformer": {
       "optional": true
     },