@cybernetyx1/atlasflow-opentelemetry

Maps the AtlasFlow runtime event stream onto OpenTelemetry spans — one span per run and per operation, with tool calls and token usage recorded.

Install

npm install @cybernetyx1/atlasflow-opentelemetry

Part of the AtlasFlow monorepo. Proprietary.

Usage

createOpenTelemetryObserver(options) returns an event subscriber. Subscribe it with observe(); spans export through whatever OpenTelemetry tracer provider you have configured (OTLP, Braintrust, Sentry, etc.).

import { observe } from "@cybernetyx1/atlasflow-runtime";
import { createOpenTelemetryObserver } from "@cybernetyx1/atlasflow-opentelemetry";

observe(createOpenTelemetryObserver());

Pass a custom tracer or a sanitize hook to inspect or drop events before they become spans:

observe(
  createOpenTelemetryObserver({
    tracer: myTracer,
    sanitize: (event) => (event.type === "tool_call" ? undefined : event),
  }),
);

Exports: createOpenTelemetryObserver and the OpenTelemetryObserverOptions type. Requires @opentelemetry/api.

License

Proprietary. © 2026 Cybernetyx. See LICENSE.