Gemini Enterprise proporciona Cloud Logging para que los clientes supervisen los errores y las advertencias cuando conectan sus datos con Gemini Enterprise.
En este documento, se describe cómo acceder a los registros de errores de conectores federados y a los registros de errores de conectores de ingesta para Gemini Enterprise con Cloud Logging.
Conceptos clave
En esta sección, se presentan conceptos clave relacionados con la observabilidad en Gemini Enterprise.
| Concepto | Descripción |
|---|---|
| Registros de errores de conectores de Gemini Enterprise | Los registros de errores de conectores de Gemini Enterprise capturan los errores y las fallas que se producen cuando se integra Gemini Enterprise con fuentes de datos de terceros, como Jira y Microsoft OneDrive. Estos registros incluyen problemas de conexión , problemas de transformación de datos y errores de la API. |
Antes de comenzar
Antes de acceder a los registros de errores, asegúrate de haber hecho lo siguiente:
Para activar el registro, debes tener el rol de IAM de administrador de Gemini Enterprise (
roles/discoveryengine.agentspaceAdmin).Para acceder a Cloud Logging, debes tener el rol de IAM de visualizador de registros (
roles/logging.viewer).Creaste una app de Gemini Enterprise. Para crear una, consulta Crea una app.
Te aseguraste de que tus almacenes de datos estén configurados y activos correctamente. Para obtener más información sobre la configuración de almacenes de datos, consulta Conecta una fuente de datos de Google o Conecta una fuente de datos de terceros.
Activaste la configuración de observabilidad para ver los registros de errores de conectores federados. Para obtener más información, consulta Activa la configuración de observabilidad.
Accede a los registros de errores de conectores federados
Para ver los registros de errores de tus almacenes de datos que se conectan a Gemini Enterprise mediante la federación de datos, sigue estos pasos:
En la Google Cloud consola de, ve a la página Gemini Enterprise.
En el menú de navegación, haz clic en Almacenes de datos.
Selecciona un almacén de datos de tu elección.
Haz clic en View Logs (Ver registros). Se abrirá la página Explorador de registros.
Para ver solo los registros de conectores de Gemini Enterprise, ingresa la siguiente consulta en el campo del editor de consultas y haz clic en Ejecutar consulta:
logName="projects/PROJECT_ID/logs/discoveryengine.googleapis.com%2Fconnector_activity" jsonPayload.LogMetadata.name="projects/PROJECT_ID/locations/LOCATION/collections/COLLECTION_ID/dataConnector"Reemplaza lo siguiente:
PROJECT_ID: el ID de tu proyecto.LOCATION: la ubicación de tu conector. Por ejemplo,global.COLLECTION_ID: el ID de la colección que contiene tu conector, que también es el ID del almacén de datos en la Google Cloud consola.
Define mejor el alcance de tu consulta con un filtro. Por ejemplo, haz clic en Todos los niveles de gravedad y selecciona Error y superior. Para obtener más información sobre cómo definir mejor tus consultas, consulta Consultas de ejemplo.
Accede a los registros de errores de conectores de ingesta
Para ver los registros de errores de tus almacenes de datos que se conectan a Gemini Enterprise mediante la ingesta de datos, sigue estos pasos:
En la Google Cloud consola de, ve a la página Gemini Enterprise.
En el menú de navegación, haz clic en Almacenes de datos.
Selecciona un almacén de datos de tu elección.
Haz clic en View Logs (Ver registros). Se abrirá la página Explorador de registros.
De forma predeterminada, la página Explorador de registros busca en los recursos que se enumeran en el ámbito de registros predeterminado las entradas de registro. Para filtrar los registros de Gemini Enterprise, realiza una de las siguientes acciones:
- Selecciona Todos los recursos > API consumida > API de Discovery Engine y, luego, haz clic en Aplicar.
Ingresa lo siguiente en la barra de consultas y haz clic en Ejecutar consulta:
resource.type="consumed_api" resource.labels.service="discoveryengine.googleapis.com"
Define mejor el alcance de tu consulta filtrando los metadatos JSON. Por ejemplo, para consultar los registros del método
ImportDocuments, realiza una de las siguientes acciones:Ingresa lo siguiente en la barra de consultas:
jsonPayload.context.reportLocation.functionName=~"ImportDocuments"Expande los metadatos JSON y haz clic para filtrar:
Figura 1. Filtra haciendo clic en los metadatos JSON
Para la mayoría de las advertencias y los errores, busca los detalles en
jsonPayload.messageyjsonPayload.status.Para un análisis de registros más detallado, vuelca los registros en un receptor de registros, como BigQuery. Para obtener información, consulta Enruta registros a destinos admitidos en la documentación de Google Cloud Observability.