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

# Workspace Analytics

Monitor agent performance, sessions, and request-level traces across your workspace.

**Workspace Analytics** gives you visibility into how agents behave in production — from aggregate metrics to individual session transcripts and step-level execution logs.

* **Navigation**: Settings > Analytics
* **Required role**: Owner, Admin, or Operator; Member for project-scoped views.

Use the **All Projects** dropdown and time range controls (24h, 7d, 30d, 90d) to filter data across all tabs.

***

## Agents

The **Agents** tab shows aggregate performance metrics for all agents in the selected project and time range.

<Note>Agent performance metrics appear once agents start processing sessions.</Note>

### Metrics

| Metric                    | Description                                               |
| ------------------------- | --------------------------------------------------------- |
| Total sessions            | Number of agent sessions in the selected time range.      |
| Avg. session duration     | Mean time from session start to last message.             |
| Resolution rate           | Percentage of sessions that reached a successful outcome. |
| Avg. messages per session | Mean number of user and agent messages per session.       |
| Total tokens consumed     | Input and output tokens across all models.                |
| Total estimated cost      | Calculated LLM cost for the period.                       |
| Error rate                | Percentage of sessions that encountered errors.           |

Filter by date range, project, agent, or model. Charts show session volume over time, token usage, cost trends, top agents by session count and cost, and error breakdown.

***

## Sessions

The **Sessions** tab lists individual user sessions across all agents in the selected project and time range.

<Note>Session data appears once agents start processing requests.</Note>

### Browse sessions

1. Go to **Settings > Analytics > Session Explorer**.
2. Search by session ID, user message content, or agent name.
3. Filter by status, date range, or agent.
4. Click a session to view the conversation transcript, tool calls, model usage, state transitions, and metadata.

***

## Traces

The **Traces** tab provides a step-by-step execution log of agent runs. It offers two views: **Event Stream** and **SQL Query**.

<Note>Trace events appear once agents start processing sessions.</Note>

### Event Stream

The **Event Stream** view shows a chronological log of all agent events in the selected project and time range.

Each trace records a span tree — a hierarchical view of all operations:

| Event type             | What it captures                                    |
| ---------------------- | --------------------------------------------------- |
| LLM calls              | Prompt, response, tokens, and latency.              |
| Tool executions        | Name, input, output, and duration.                  |
| Step transitions       | Flow step changes for agents with a FLOW section.   |
| Guardrail evaluations  | Category, score, and decision.                      |
| Knowledge base queries | Query text, retrieved chunks, and relevance scores. |

Filter events by type:

| Filter   | Description                          |
| -------- | ------------------------------------ |
| All      | Show all event types.                |
| LLM      | LLM call events.                     |
| Tool     | Tool invocation events.              |
| Decision | Agent decision and routing events.   |
| Error    | Events that resulted in an error.    |
| Handoff  | Agent handoff and delegation events. |
| Agent    | Agent lifecycle events.              |
| Session  | Session start and end events.        |

Use the search bar to find events by session ID, agent name, or event type. The total event count is shown next to the search bar.

**Trace search syntax:**

| Operator     | Example                  | Description               |
| ------------ | ------------------------ | ------------------------- |
| `agent:`     | `agent:customer-support` | Filter by agent name.     |
| `status:`    | `status:error`           | Filter by outcome.        |
| `model:`     | `model:claude-4-sonnet`  | Filter by model used.     |
| `duration:>` | `duration:>2s`           | Filter by total duration. |
| `tokens:>`   | `tokens:>5000`           | Filter by token count.    |

### SQL Query

The **SQL Query** view lets you run custom queries against trace event data.

<Note>Admin access is required to use the SQL Query view.</Note>

| Control         | Description                                                                                 |
| --------------- | ------------------------------------------------------------------------------------------- |
| Example Queries | A dropdown of pre-built queries to help you get started.                                    |
| SQL editor      | Write or paste a SQL query. Use `{tenantId:String}` and `{projectId:String}` for isolation. |
| Clear           | Clear the current query from the editor.                                                    |
| Execute         | Run the query and view results.                                                             |