Observability — Agentuity Documentation

Observability

Logging, tracing, and debugging for agents

Monitor and debug your agents with built-in observability tools.

Quick Reference

Logging

ctx.logger.info('Processing request', { userId, action });
ctx.logger.error('Failed to process', { error: err.message });

Tracing

await ctx.tracer.withSpan('fetch-data', async (span) => {
  span.setAttribute('source', 'api');
  return await fetchData();
});

Sessions

// Access session ID for debugging
const sessionId = ctx.session.id;
ctx.logger.info('Session started', { sessionId });

Access Patterns

ContextLoggerTracer
Agentsctx.loggerctx.tracer
Routesc.var.loggerc.var.tracer

All logs and traces are automatically correlated with session IDs for easy debugging in the Agentuity dashboard.