Interface TracerHost

Optional ReadonlyotelProvider

Optionalactivate

• activate?<T>(span: unknown, fn: () => Promise<T>): Promise<T>

  Runs work with the supplied span as the active OTel span, when supported.

  Type Parameters

  • T

  Parameters

  • span: unknown
  • fn: () => Promise<T>

  Returns Promise<T>

OptionalactiveSpanContext

• activeSpanContext?(): SpanContext | undefined

  Reports the identifiers of the span the OTel context currently holds active, or undefined when nothing is active.

  This is the read that lets a signal emitted OUTSIDE a withSpan call — a log record, above all — name the trace it belongs to (X34-2). It cannot be answered from ITelemetryService alone, which hands its span only to its own callback, so the host is where it lives.

  Optional, and paired with activate: a host with no registered context manager never has an active span, so it omits this member rather than answering undefined forever. Omitted means "this host cannot see"; undefined from an implemented member means "nothing is running".

  Returns SpanContext | undefined

  The active span's identifiers, or undefined

  Since

  0.5.0

extractContext

• extractContext(headers: Headers): TelemetryContext

  Extracts a context from incoming headers (for traceparent propagation).

  Parameters

  • headers: Headers

  Returns TelemetryContext

forceFlush

• forceFlush(): Promise<void>

  Forces flush of pending spans.

  Returns Promise<void>

injectContext

• injectContext(context: TelemetryContext): Record<string, string>

  Injects a context into outgoing headers.

  Parameters

  • context: TelemetryContext

  Returns Record<string, string>

shutdown

• shutdown(): Promise<void>

  Shuts down the provider and flushes pending spans.

  Returns Promise<void>

startSpan

• startSpan(
      name: string,
      options?: {
          attributes?: Record<string, unknown>;
          kind?: number;
          parentContext?: TelemetryContext;
          root?: boolean;
      },
  ): unknown

  Starts a new span.

  root: true starts a parentless span, ignoring both parentContext and the active span (OTel's own SpanOptions.root).

  Parameters

  • name: string
  • Optionaloptions: {
        attributes?: Record<string, unknown>;
        kind?: number;
        parentContext?: TelemetryContext;
        root?: boolean;
    }

  Returns unknown