Why Observability Matters
Observability is essential at every stage — whether you’re building, testing, or scaling your agents. When you’re developing, it helps you confirm that everything is working as expected and understand how your systems behave. As you scale, those same insights help you detect issues early, measure performance, and make confident improvements. No matter how you’re using agents, you need detailed, real-time visibility into what’s happening so you can understand what’s going well, what’s slowing down, and where things might be breaking. MeshAgent captures this information through telemetry — structured data about what your agents, tools, and rooms are doing as they run. Under the hood, MeshAgent uses OpenTelemetry, an open standard for collecting and analyzing telemetry data such as:- Traces — the complete path a request takes through your agents and tools
- Spans — the individual steps within that path (like
TaskRunner.askorTool.execute) - Metrics — performance and usage counters (e.g. response times, token and cost tracking)
- Logs — contextual messages that help you understand what happened and why
What MeshAgent Provides
MeshAgent includes built-in observability so you get detailed, structured insights by default. At the project level, the Usage tab in MeshAgent Studio shows aggregated insights like:- Cost by provider
- Most active rooms and participants
- Most used tools
- Tool call latency
- Logs for room, agent, and tool activity
- Traces to understand task execution and tool calls
- Metrics for insights into session costs
Next Steps
- How Observability Works: Learn how MeshAgent instruments telemetry and where to see it.
- Custom Traces, Logs, and Metrics: Add your own instrumentation to get deeper insights.