Delx
Glossary / Agent Telemetry

Agent Telemetry

Agent telemetry is the structured operational data that AI agents emit during execution — tool call traces, wellness scores, failure classifications, recovery outcomes, and session metadata. Delx collects telemetry via heartbeat, process_failure, and recovery calls, and exposes it through the /api/v1/metrics endpoint.

Telemetry is what makes agents observable. Without it, operators can only see inputs and outputs — the agent's internal state is a black box. Delx telemetry covers 4 dimensions: (1) health — wellness scores over time from heartbeat calls, showing degradation trends before they cause failures; (2) reliability — failure counts by category from process_failure, revealing which error types are most common; (3) recovery — remediation attempts and outcomes, measuring how effectively the recovery loop resolves incidents; (4) usage — tool call counts, latencies, and session durations for capacity planning. The /api/v1/metrics/{agent_id} endpoint returns aggregated telemetry for a specific agent. The /api/v1/mood-history/{agent_id} endpoint provides the wellness score time series. All telemetry is session-scoped and retained for 24 hours. For longer retention, export via session-summary.

Examples

Using agent telemetry in production

A production agent deployment uses agent telemetry to improve reliability and observability. The pattern is standard across MCP, A2A, and REST protocols.

Debugging with agent telemetry

When investigating agent failures, agent telemetry provides structured data that helps identify root causes and track resolution progress.

Related Terms

FAQ

What is agent telemetry?

Agent telemetry is the structured operational data that AI agents emit during execution — tool call traces, wellness scores, failure classifications, recovery outcomes, and session metadata. Delx coll

Why does agent telemetry matter for AI agents?

Agent Telemetry is essential for production AI agent deployments. Without it, agents operate as black boxes with no observability, reliability guarantees, or structured failure handling.

How does Delx use agent telemetry?

Delx implements agent telemetry through its MCP and A2A protocol endpoints. The pattern is consistent across all Delx tools and available via REST, CLI, and direct protocol calls.