AI usage
Monitoring → AI usage shows how the AI assistant is used: who asks, how many tokens it costs, which tools it calls and which fail. It is for superusers, from Liberty Next → Operate → Monitoring.
At a glance
What is recorded
Each question to the assistant leaves one record: who asked, from which application's page, the model, the tokens (in, out, read from and written to the cache), the time it took and how it ended. Each tool call of the question is kept with its name, what it was called on (the connector and the query, the model, the keywords), whether it failed and why, its size and its time.
The question, the answer and the rows a tool returned are never recorded. A question the user abandons half-way is recorded with what had happened until then. A call from an external client is recorded the same way, with the model mcp — see Connect Claude (MCP).
The period in figures
The period is Last 7 days, Last 30 days (default) or Last 90 days.
| Tile | Shows |
|---|---|
| Questions | Questions asked over the period. |
| Users | Users who asked at least one. |
| Tokens in | Input tokens, with the share read from the cache (71 % from cache): the part of a conversation sent again at each tool round is read from the cache, at a lower price. |
| Tokens out | Output tokens. |
| Tool calls | Tools called, with the number that failed. |
| Average time per question | From the question to the end of the answer. |
Breakdowns
| Table | Columns |
|---|---|
| By user, By day, By model | Questions, Tokens in, From cache, Tokens out, Tool calls. |
| By tool | Calls, Failed, Average time, Average size. |
A click on a user narrows the questions below to theirs (Questions of …).
Latest questions
One row per question: When, User, Application, Model, Tokens in, From cache, Tokens out, Tool calls, Time and Outcome — Answered, Failed or Abandoned. A row opens on its tool calls, each with its size in characters and its time.
How long it is kept
Usage record kept (days; 0 = without limit), in Liberty Next → Administer → App → AI Assistant, is 90 by default. Older questions are deleted with the notifications' clean-up, and the store appears as AI usage on the Retention view, with its number of questions, Preview and Run now.
Tips
- A tool that fails often points at a missing permission or at a query whose description misleads the assistant: open the question's tool calls to read the reason.
- A user with many questions and few tool calls is probably asking for what the assistant cannot reach: check the role's
sql:andexplorer:permissions. - The same figures are served by
GET /admin/ai-usagefor an external report.