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 del conector federado y del conector de transferencia de datos para Gemini Enterprise con Cloud Logging.
Conceptos clave
En esta sección, se presentan los conceptos clave relacionados con la observabilidad en Gemini Enterprise.
| Concepto | Descripción |
|---|---|
| Registros de errores del conector de Gemini Enterprise | Los registros de errores del conector 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 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 Cómo crear una app.
Asegúrate de que tus almacenes de datos estén configurados correctamente y activos. Para obtener más información sobre cómo configurar almacenes de datos, consulta Conecta una fuente de datos de Google o Conecta una fuente de datos de terceros.
Se activó la configuración de observabilidad para ver los registros de errores del conector federado. Para obtener más información, consulta Cómo activar la configuración de observabilidad.
Accede a los registros de errores del conector federado
Para ver los registros de errores de tus almacenes de datos que se conectan a Gemini Enterprise con la federación de datos, sigue estos pasos:
En la consola de Google Cloud , ve a la página Gemini Enterprise.
En el menú de navegación, haz clic en Almacenes de datos.
Selecciona el almacén de datos que prefieras.
Haz clic en View Logs (Ver registros). Se abrirá la página Explorador de registros.
Para ver solo los registros del conector 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: Es la ubicación de tu conector. Por ejemplo,globalCOLLECTION_ID: Es el ID de la colección que contiene tu conector, que también es el ID del almacén de datos en la consola deGoogle Cloud .
Usa un filtro para definir mejor el alcance de tu búsqueda. Por ejemplo, haz clic en Todas las gravedades y selecciona Error y superior. Para obtener más información sobre cómo definir mejor tus búsquedas, consulta Consultas de muestra.
Accede a los registros de errores del conector de transferencia de datos
Para ver los registros de errores de tus almacenes de datos que se conectan a Gemini Enterprise a través de la transferencia de datos, sigue estos pasos:
En la consola de Google Cloud , ve a la página Gemini Enterprise.
En el menú de navegación, haz clic en Almacenes de datos.
Selecciona el almacén de datos que prefieras.
Haz clic en View Logs (Ver registros). Se abrirá la página Explorador de registros.
De forma predeterminada, la página del Explorador de registros busca entradas de registro en los recursos que se indican en el ámbito de registros predeterminado. Para filtrar los registros de Gemini Enterprise, haz 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"
Para refinar el alcance de tu búsqueda, filtra los metadatos JSON. Por ejemplo, para consultar los registros del método
ImportDocuments, haz una de las siguientes acciones:Ingresa lo siguiente en la barra de búsqueda:
jsonPayload.context.reportLocation.functionName=~"ImportDocuments"Expande los metadatos JSON y haz clic para filtrar:
Figura 1. Haz clic en los metadatos JSON para filtrar.
En el caso de la mayoría de las advertencias y los errores, encontrarás 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 más información, consulta Enruta registros a destinos admitidos en la documentación de Google Cloud Observability.