How to View Agent Insights and Logs

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 Metrics

The agent Metrics 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 metrics for an agent from the DigitalOcean 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, and then select the agent you want to view the metrics 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 displays the average amount of tokens the agent uses per second and the average end-to-end latency for the agent to process a request.

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, Conversation Logs, and Insights

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 open the Enable trace storage window.

To enable insights, click the Enable log stream insights checkbox in the same window. Log stream insights uses a third party model to analyze your agent’s trace data and deliver data-driven recommendations that help improve performance. By enabling insights, you consent to us sending your agent’s trace data to a third-party model. Log stream insights incur additional costs. For details, see our pricing page.

To finish setup, click Start storing (and if you enabled insights, click Start storing with insights) to begin storing traces, conversation logs, and optionally, insights.

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. Insights do not generate until your agent processes at least one prompt. If the agent has not received input or returned output, insights remain unavailable. 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.

Disable Traces, Conversation Logs, and Insights

To disable traces, conversation logs, or insights at any time, open the control panel, click Agent Platform in the left menu, then go to the Agent Workspaces tab. Select the workspace that contains the agent you want to inspect. From the Agents tab, select the agent, then click the Settings tab. Under the Traces and Insights section, on the right, click Edit, and then choose either Disable trace storage or Disable log stream insights.

Disabling trace storage deletes all stored trace data, conversation logs, and insights for the agent, and stops collecting new trace and insights data. Disabling insights alone only stops the collection of new insights and does not stop trace storage or delete existing insights. Only disabling trace storage permanently deletes all associated data and cannot be undone.

If you click Disable trace storage, the Disable trace routing and conversation log stream storing window opens. Disabling trace storage also disables log stream insights. To confirm, type your agent’s name, then click Destroy.

If you click Disable log stream insights, the Disable log stream insights window opens. To confirm, type your agent’s name, then click Destroy.