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);