> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getnao.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Monitoring

> Monitor usage, costs, feedbacks

Access the "Usage & Costs" dashboard from the admin panel to view analytics, usage metrics, user feedback, and chats replay tools.

<Info>
  The Monitoring views are admin-only. Non-admin users are redirected away from protected routes.
</Info>

# Usage analytics

In the Usage & Costs section, you can monitor:

* Number of message sent by users to the chat
* Total tokens consumed
* Total cost of tokens consumed
* Channel usage split across Web, Slack, and Microsoft Teams

You can filter on a specific model, and look at a day / week / month granularity.

## Feedbacks monitoring

In this section, you can see all postive and negative feedbacks sent by users in message threads.

The **Feedbacks** table shows:

* **Vote** - Thumbs up (👍) for positive feedback or thumbs down (👎) for negative feedback
* **User** - Who provided the feedback
* **Message** - The agent's response that was rated (truncated preview)
* **Reason** - User's explanation for their feedback (if provided)
* **Date** - When the feedback was given

## Chats replay

In this section, admins can inspect historical chats at the project level and replay messages for debugging and quality checks.

The **Chats Replay** view includes:

* **Project-wide chat table** - Browse chats in the current project
* **Filters** - Filter by column visibility, date, users, role, and tool state
* **Replay panel** - Navigate previous and next feedbacks or tool errors from a selected chat

Chats Replay is also available to the [Context Admin role](/nao-agent/chat/admin/setup#user-roles).

## Chat with your nao data (admin mode)

Admin mode lets you ask questions about how your nao project is being used, in natural language, instead of reading the usage dashboards manually. In this mode the agent answers by running read-only SQL over nao's own application data.

**Turn it on** from the chat, in two ways:

* The **Chat with nao data** entry in the settings sidebar.
* The **Admin mode** toggle in the chat input menu. When it's on, the chat input shows an amber border and an **Admin Mode** badge so it's clear you're querying internal data.

Admin mode is available to admins only.

**What it can read.** The agent queries a set of project-scoped, read-only views over nao's usage data. They are already filtered to the current project, so you never need to add a project filter:

* `v_messages` - full message history: user prompts, assistant answers, tool calls and errors, feedback votes and explanations, the model used, and the source (Web, Slack, Teams, etc.). The richest view for adoption, tool errors, and downvotes.
* `v_analytics_event` - asset engagement events (page views, downloads, forks, favorites, refreshes, view duration) for chats and stories.
* `v_llm_inference` - one row per LLM call, with type and token usage.
* `v_mcp_call_log` - MCP tool calls.
* `v_memories` - saved memories.
* `v_project` - project metadata.

Ask things like "how many messages were sent this week by channel?", "which questions got the most downvotes?", or "what are the most downloaded stories?" and the agent writes the SQL for you. Queries are read-only (`SELECT` / `WITH` only) and cannot touch anything outside the allowlisted views.

## Logs

Navigate to **Settings** -> **Logs** to view the agent's server-side logs in a terminal-style viewer.

Features:

* **Date range filter** - filter by preset ranges (last 15 minutes, 1 hour, 24 hours, 7 days) or a custom date and time range. Defaults to the last hour.
* **Load older logs** - scroll to the top of the log viewer or click the header to load older entries. Pagination is cursor-based.
* **Expandable rows** - click a log row to expand the full message text and see the `context` JSON payload when present. Truncated rows show a chevron indicator.

**What's Next?**

<CardGroup cols={2}>
  <Card title="Admin Setup" icon="wrench" href="/nao-agent/chat/admin/setup">
    Configure users, authentication, and integrations
  </Card>

  <Card title="Context Engineering Playbook" icon="book" href="/nao-agent/context-engineering/playbook">
    Learn how to systematically improve answer quality
  </Card>
</CardGroup>
