@brushy/di-otel

OpenTelemetry hooks for resolve tracing in @brushy/di-core.

Part of the @brushy/di 2.0.0 umbrella release.

Install

npm install @brushy/di-otel @brushy/di-core @opentelemetry/api

Or use the umbrella package:

npm install @brushy/di @opentelemetry/api

@opentelemetry/api is an optional peer dependency. If it is not installed, tracing helpers become no-ops.

Usage

Wrap a container to trace every resolve:

import { Container, createToken } from "@brushy/di-core";
import { traceContainer } from "@brushy/di-otel";

const container = new Container();
const LOGGER = container.register(createToken("LOGGER"), {
  useValue: { log: console.log },
});

const restore = traceContainer(container, {
  tracerName: "my-app",
  attributeToken: true,
});

container.resolve(LOGGER);

restore(); // unwrap when done

Trace a single resolve:

import { traceResolve } from "@brushy/di-otel";

const logger = traceResolve(container, LOGGER);

Umbrella import:

import { traceContainer } from "@brushy/di/otel";

API

| Export | Description | | --- | --- | | traceContainer(container, options?) | Patches container.resolve with spans; returns restore function | | traceResolve(container, token, options?) | Traces one resolve call |

Options: tracerName (default @brushy/di), attributeToken (add di.token attribute).

Related

• @brushy/di-monitor for in-process event logging
• Full DI documentation
• Changelog · Umbrella release notes