How to View Agent Insights and Logs
Validated on 30 Jun 2025 • Last edited on 8 Jul 2025
GradientAI Platform lets you build fully-managed AI agents with knowledge bases for retrieval-augmented generation, multi-agent routing, guardrails, and more, or use serverless inference to make direct requests to popular foundation models.
You can view performance insights and runtime logs for your agents to help you troubleshoot issues and understand how your agents are performing.
View Agent Insights
The agent Insights feature provides an overview of your agent’s token usage and performance. This can help you understand how your agent is performing and then adjust your agent’s configuration to improve its performance.
To view insights for an agent from the DigitalOcean Control Panel, click Agent Platform in the left menu, then click the Agents tab, and then select the agent you want to view the insights for.
From the agent’s Overview page, scroll down to the Insights section.
The Insights section allows you to view the following information:
- Tokens In: The number of input tokens sent by users to generate responses over the selected time period.
- Tokens Out: The number of output tokens generated by the agent over the selected time period.
- All tokens: The total number of tokens used by the agent over the selected time period.
- Requests in: The number of user requests received by the agent over the selected time period.
The Token Metrics section currently displays the average time it takes for the agent to generate the first token of a response, in seconds.
View Agent Logs
Viewing agent runtime logs can help you understand how your agent is performing and troubleshoot issues. Runtime logs show the events that occur while your agent processes a prompt, such as which knowledge bases and functions were accessed to generate a response.
To view the runtime logs for an agent, go to the DigitalOcean Control Panel, click Agent Platform in the left menu, then click the Agents tab and select the agent you want to view the logs for. From the agent’s Overview page, click the Logs tab.
In the Logs tab, you can view the logs emitted by your agent in real time.
View Traces and Conversation Logs
Conversation logs capture every input your agent receives and every output it returns, across all interaction channels, including playground sessions and API calls. Reviewing conversation logs helps you understand how your agent performs and what interactions users have with it.
To view a conversation log, open the control panel, click Agent Platform in the left menu, then in the Agent Workspaces tab, select the workspace that contains the agent you want to inspect. From the workspace’s Agents tab, select the agent, click the Observability tab, and scroll to the Traces and conversation logs section.
Before you can view conversation logs, you must enable trace storage for your agent. Click Enable trace storage to start saving traces and conversation logs for later review. You can disable storage at any time by selecting Disable trace storage. When disabled, the platform permanently deletes all stored trace and conversation-log data, so export any data you want to keep first.
Once you enable trace storage, the Traces and conversation logs section remains empty until the agent processes new prompts. Once you’ve enabled trace storage, send a few requests to your agent to generate traces. Then, return to the Observability tab and click View log stream. The log stream opens in a new window where you can inspect sessions and prompt traces. For details on trace data, see How to Trace Agent Responses.
To view a traces and conversation logs within the log stream, on the left, select a session from the list. Then, click the Messages tab to see the conversation between the user and the agent.
Export Conversation Logs
Exporting session and tracing logs lets you download session or trace data as a .csv file for offline analysis or archiving.
To begin exporting data, open the control panel, click GenAI Platform in the left menu, then in Agent Workspaces, select the workspace that contains your agent. From the workspace’s Agents tab, select the agent, then click the Observability tab and scroll to the Traces and conversation logs section.
In the log stream window, switch to either the Sessions or Traces tab, select the interactions you want to export using the checkboxes, then click Export to open the Export Data window.
In the export window, choose the columns you want to include. You can click All, None, or Visible Columns (the default set), or manually select individual columns using the checkboxes.
After selecting your columns, choose a file name or leave the field blank to use the autogenerated name. Then, click Export to download the .csv file to your local machine.