Observability

Fetch https://developers.cloudflare.com/agents/api-reference/observability/ for complete documentation.

Agents emit structured events via Node.js diagnostics_channel. Subscribe in development or forward via Tail Workers in production.

Subscribe to Events

import { subscribe } from "agents/observability";

subscribe("agents:rpc", (event) => {
  console.log(`RPC call: ${event.payload.method}`);
});

subscribe("agents:state", (event) => {
  console.log(`State change on ${event.agent}`);
});

Available Channels

Per-Agent Override

export class MyAgent extends Agent<Env, State> {
  observability = undefined; // disable for this agent
}

Production: Tail Workers

In production, events appear as diagnosticsChannelEvents on the Tail Worker event object. Attach a Tail Worker to your agent's Worker to forward events to your observability platform.