25 Monitor Agents

You can monitor details relating to the sessions and metrics of your agents to see information about how it's being used, the resources it consumes, and more.

You have multiple tabs in your agent for tracking usage details, the Sessions tab, Metrics tab, and Activity tab. You can find them at the top of your agent canvas.

Traces and Spans

Traces provide you with observability for your agents by capturing and displaying the flow of agent requests. Spans are the objects that make up a trace. Each span is a different step in the flow, such as chat prompts from a user, agent invocations, and workflow tasks.

You can see traces for the current session or test run or previous sessions. To see the current session trace, go to the Flow tab and click Playground. The Details pane at the bottom of the page displays the trace of the current session in the left pane. You can click on objects in the trace to expand them or view more detailed information. In the right pane, you can click the Info, Details, or Events tabs to learn more about the selected span object.

You can see traces for previous sessions in the Sessions tab by clicking the name of the session.

Sessions

In the Sessions tab, you can see a history of sessions for this agent. You can see if each session succeeded or failed, the URI origin, when the session was started, the duration of the session, and the tokens used in the session. You can click session ID for more specific details about that session and to see traces for that specific sessions.

You can filter the displayed sessions by using the Search bar to filter by session ID or URI origin, using the date filters to show only a specific date range, and the Session status drop-down menu to filter by whether a session succeeded or failed.

Metrics

The Metrics tab shows a summary of usage data for all agent sessions. The Date range dropdown filters the time period you want to see summarized in the displayed cards. The URI selection filters the URI selection source you want to see the details for. You can modify which cards are displayed and whether or not they include graphs as visual representations of usage.

Activity

The Activity tab shows a summary of agent deployment status. The Operation column specifies the type of deployment operation (Deploy or Undeploy) and the Status column specifies the outcome of the operation (Success, Error, Warning, Failed). You can see who initiated the operation and when as well as the status message associated with the operation outcome.

View Agent Sessions

You can view a history of sessions for you agent and filter the results to see trends and assist with troubleshooting.

  1. On the Home page, navigate to your agent.
  2. Click the Sessions tab.
  3. Use the filters to change the displayed sessions.

View Agent Metrics

You can view summarized details of your agent is used, such as token usage, session durations, latency, and more.

  1. On the Home page, navigate to your agent.
  2. Click the Metrics tab.
  3. Select different options from the Date range dropdown to see how metric differ across timelines.
  4. Select different options from the URI selection dropdown to filter for specific URI sources.