@radaros/observability

Opt-in tracing, metrics, and structured logging for RadarOS agents.

Install

npm install @radaros/observability

Quick Start

import { Agent, openai } from "@radaros/core";
import { instrument } from "@radaros/observability";

const agent = new Agent({ name: "assistant", model: openai("gpt-4o") });

const obs = instrument(agent, {
  exporters: ["console"],       // or "langfuse", "otel", "json-file"
});

await agent.run("Hello!");
await obs.tracer.flush();

Exporters

| Shorthand | Env Vars | Description | |-----------|----------|-------------| | "console" | — | Pretty-print trace tree | | "langfuse" | LANGFUSE_PUBLIC_KEY, LANGFUSE_SECRET_KEY | Langfuse cloud | | "otel" | OTEL_EXPORTER_OTLP_ENDPOINT | OpenTelemetry collector | | "json-file" | — | Local JSON file |

Documentation

Full docs at radaros.mintlify.dev

License

MIT