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 de conectores de transferencia 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 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).Haber creado una app de Gemini Enterprise (para crear una, consulta Crea 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.
Activaste la configuración de observabilidad para ver los registros de errores del conector federado. Para obtener más información, consulta Activa 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 .
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 muestra.
Accede a los registros de errores del conector de transferencia
Para ver los registros de errores de tus almacenes de datos que se conectan a Gemini Enterprise con 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 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, 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 por 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. Filtrar haciendo clic en los metadatos JSON
Para la mayoría de las advertencias y los errores, consulta los detalles en
jsonPayload.messageyjsonPayload.status.Para realizar 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.