---
title: "Observability Kit"
description: "Usage, spend, feedback, replay, errors, and run diagnostics for agent-native apps."
---
# Observability Kit
The Observability Kit makes agent work measurable and debuggable. It covers
usage, spend, feedback, replay, errors, traces, run diagnostics, and the app UI
that operators use to understand what happened.
Observability
"
}
/>
## Pieces {#pieces}
| Piece | Purpose |
| -------------------------- | ----------------------------------------------------------------- |
| `` | Standard operator dashboard. |
| Usage and spend | Workspace/app-level model usage and cost views. |
| Feedback | User thumbs, comments, and product feedback loops. |
| Replay | Inspectable agent run and UI/event timelines. |
| Errors | Surfaced runtime, provider, and action failures. |
| Run diagnostics | Tool calls, model choice, context, approvals, and recovery state. |
| Tracking | Server-side analytics events with pluggable providers. |
## Usage {#usage}
Mount the dashboard on its own route, and drop `` next to any
assistant message you want feedback on — both write into the same
usage/spend/feedback data the dashboard reads back:
```tsx
import {
ObservabilityDashboard,
ThumbsFeedback,
} from "@agent-native/core/client/observability";
export default function ObservabilityPage() {
return (
);
}
export function AssistantMessageFooter({
threadId,
runId,
messageSeq,
}: {
threadId: string;
runId: string;
messageSeq: number;
}) {
return (
);
}
```
The dashboard has 5 tabs (overview, conversations, evals, experiments,
feedback) and scopes all data to the signed-in user.
## UX Standard {#ux-standard}
- Every background or agent run should be traceable to a user-visible outcome.
- Feedback should connect to the run, resource, or page that caused it.
- Spend and usage should distinguish app, organization, user, and provider.
- Error states should link back to setup when the fix is a missing connection.
## What's next
- [**Observability**](/docs/observability) — the full data model and routes
behind this dashboard.
- [**Tracking**](/docs/tracking) — server-side analytics events with
pluggable providers.
- [**Progress**](/docs/progress) — the run-progress surface `` also
reads.
- [**Agent UX Kit**](/docs/toolkit-agent-ux) — the composer and runs tray this
kit's diagnostics tie back to.