Arclet
Observability

Tracing & Telemetry

Inspect execution telemetry and track runs.

Integrations & Observability

Observability features provide deep visibility into every tool call, turn latency, and token count.

Attaching a Telemetry Logger

import { AgentBuilder, OpenAIAdapter, Tracer } from 'arclet';

const tracer = new Tracer({
  serviceName: 'agent-service',
  logLevel: 'info',
  onSpanEnd(span) {
    console.log(`[Span]: ${span.name} | Duration: ${span.durationMs}ms | Status: ${span.status}`);
  },
});

const adapter = new OpenAIAdapter({ apiKey: process.env.OPENAI_API_KEY!, model: 'gpt-4o' });

const agent = new AgentBuilder()
  .name('ObservedAgent')
  .llm(adapter)
  .tracer(tracer)
  .build();

async function run() {
  const result = await agent.run('Run diagnostic telemetry audit');
  const trace = tracer.exportTrace(result.runId);
  console.log(`Trace Duration: ${trace.totalDurationMs}ms (${trace.spans.length} spans)`);
}

run().catch(console.error);