Manage observability settings

Preview

This product or feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the Service Specific Terms. Pre-GA products and features are available "as is" and might have limited support. For more information, see the launch stage descriptions.

This document describes how to configure the observability settings for your Gemini Enterprise app using the Google Cloud console. After you enable the settings, you can view the following data from your interactions with the assistant in your Gemini Enterprise web app:

• View metrics in Metrics Explorer.
• View traces and spans in Trace Explorer.

Key concepts

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

Concept	Description
Trace	A trace is a collection of spans that represents a single request or transaction as it flows through different services and components. For example, a trace represents the entire lifecycle of a request. This includes a user asking a question from the Gemini Enterprise assistant, the Gemini Enterprise assistant responding, and any subsequent actions triggered by the answer, such as sending an email.
Span	A span is a single, timed unit of work within a trace. It represents a specific operation, such as a function call, an API request, or a database query. Each span includes details like its start and end times, a unique ID, and its relationship to other spans. These relationships together form a trace.
Span logs	Span logs are timestamped, free-form messages or events associated with a specific span. They provide detailed, contextual information about a span's execution, helping users debug issues and understand the flow of a request.
Metrics	Metrics are numerical measurements that systems collect over time. These measurements represent the performance, resource utilization, or behavior of a system. Engineers use metrics to monitor system health, identify trends, and trigger alerts.

Before you begin

Make sure you have the following:

• The Discovery Engine Admin role.

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

Configure observability settings

To configure the observability settings, follow these steps:

1. In the Google Cloud console, go to the Gemini Enterprise page.

   Gemini Enterprise

2. Click the name of the app that you want to configure.

3. Click Configurations and then click the Observability tab.

4. You can turn on or turn off the following settings:

   Observability setting	Description
   Enable instrumentation of OpenTelemetry traces and logs	When enabled, you can view traces, spans, and metrics associated with your logs in the Cloud Logging.
   Enable logging of prompt inputs and response outputs	When enabled, Cloud Logging logs the full content of user prompts and responses as part of the span logs. This includes sensitive data or Personally Identifiable Information (PII). To enable this setting, you must first enable Enable instrumentation of OpenTelemetry traces and logs. Caution: Enabling this setting logs potentially sensitive data, including PII. Restrict log access to authorized personnel only.

What's next

• To learn more about how to access the Gemini Enterprise logs, see Configure usage audit logging for Gemini Enterprise.
• To learn more about how to access the Gemini Enterprise trace and span data, see Access traces and spans in Trace Explorer.
• To learn more about how to access the Gemini Enterprise metrics, see Access metrics in Metrics Explorer.