Access metrics Stay organized with collections Save and categorize content based on your preferences.

This document describes how to access the metrics generated by your Gemini Enterprise app. These metrics provide insights into the performance and health of your application.

You can view metric telemetry using either the Metrics Explorer or directly within individual agents using the agent's Observability tab.

Key concepts

This section introduces key concepts related to observability in Gemini Enterprise.

Before you begin

Make sure you have the following:

• The Gemini Enterprise Admin role or Google Cloud console Gemini Enterprise User role.

• An existing Gemini Enterprise web app. For information about creating a new app, see Create an app.

• To access the Metrics Explorer, you must have the Monitoring Viewer role (roles/monitoring.viewer).

• Enable the Enable instrumentation of OpenTelemetry traces and logs observability setting. Depending on the agent type, enable this in the app-level configurations (for the Core Assistant agent) or inside the agent's Configuration tab (for Agent Designer employee-made agents and Deep Research agents). For more information, see Manage observability settings.

Data retention

Metrics generated by your Gemini Enterprise app are stored in Cloud Monitoring in your Google Cloud project, and their retention is governed by Cloud Monitoring. Gemini Enterprise metrics are published under the discoveryengine.googleapis.com/ prefix, which falls under the "all other Google Cloud metrics" tier and is retained for 6 weeks by default. Data older than the retention period is automatically deleted. For the authoritative and most current retention values, see Data retention in the Cloud Monitoring quotas and limits documentation.

Access metrics in Metrics Explorer

To access the metrics, follow these steps:

1. In the Google Cloud console, go to the Metrics Explorer page.

   Go to Metrics Explorer

2. Select the Google Cloud project where your Gemini Enterprise app was created.

3. Click Select a metric to open a search bar.

4. In the search bar, look for the following metrics:

   Note: Metrics data refreshes every minute.

   Metric Name	Description
   Gemini Enterprise Agent - Gemini Enterprise Agent Session Count	The number of sessions handled by the Gemini Enterprise Agent.
   Gemini Enterprise Agent - Gemini Enterprise Agent Tool Count	The number of times tools were invoked by the Gemini Enterprise Agent.
   Gemini Enterprise Agent - Gemini Enterprise Agent Turn Count	The number of conversational turns within Gemini Enterprise Agent sessions.
   Gemini Enterprise Agent - Gemini Enterprise Agent Total Latency	The total latency of responses from the Gemini Enterprise Agent.
   Gemini Enterprise Agent - Gemini Enterprise Agent Tool Total Latency	The total latency incurred by tool executions within the Gemini Enterprise Agent.
   Gemini Enterprise DataConnector - Gemini Enterprise DataConnector Request Count	The total count of requests made to the Gemini Enterprise data connectors (also referred to as data stores in the Google Cloud console).

5. Select the metric you want to explore and click Apply.

6. Optionally, set additional label filters, aggregation elements, and adjust the time range.

   Note: For more information on using the Metrics Explorer, see Create charts with Metrics Explorer.

   [Screenshot of the Metrics Explorer in the Google Cloud console, showing Gemini Enterprise Agent metrics.]

Access metrics for agents

You can also view operational, tool-specific, and session metric dashboards directly for individual agents on the agent's Observability tab in the Google Cloud console.

To access metrics for an agent:

1. In the Google Cloud console, navigate to your app, and then click Agents.
2. Select the agent you want to inspect, and then click the Observability tab.

The Observability tab provides key operational telemetry divided into two views: Overview and Tools.

Overview metrics

This view provides a dashboard summarizing standard session and agent health data, which includes:

• Sessions: Total user session count.
• Avg. time per session: Average time elapsed during a session.
• Agent invocations: Total times that the agent was called.
• Agent latency: Latency across time and specific metrics.
• Agent traffic: Inbound request volume.
• Agent error rate: Percentage of failed agent invocations.

[Screenshot of the Observability tab's Overview view in the Google Cloud console, showing sessions, average turns per session, and agent invocations, latency, traffic, and error rate]

Tools metrics

This view focuses specifically on the usage and latency of tools connected to your agent, which includes:

• Total calls: Number of tool execution requests.
• P95 duration by tool: The 95th percentile latency of executions, categorized by tool.
• Count of calls by tool: Total call count divided among different tools.
• Error rate by tool: The failure rate of executions by tool.
• "No tool called" rate: The rate at which interactions did not trigger any tool execution.

What's next

• Create dashboards with the Gemini Enterprise metrics. For more information, see Create and manage custom dashboards.
• Create alerts when metrics cross a threshold. For more information, see Create metric-threshold alerting policies
• To turn off Metrics Explorer tracking, see Turn off observability settings.