Acessar registros de erros do conector do Gemini Enterprise com o Cloud Logging

O Gemini Enterprise oferece o Cloud Logging para que os clientes monitorem erros e avisos ao conectar os dados ao Gemini Enterprise.

Este documento descreve como acessar registros de erros de conectores federados e de ingestão do Gemini Enterprise usando o Cloud Logging.

Principais conceitos

Esta seção apresenta os principais conceitos relacionados à observabilidade no Gemini Enterprise.

Conceito	Descrição
Registros de erros do conector do Gemini Enterprise	Os registros de erros do conector do Gemini Enterprise capturam erros e falhas encontrados ao integrar o Gemini Enterprise a fontes de dados de terceiros, como o Jira e o Microsoft OneDrive. Esses registros incluem problemas de conexão , problemas de transformação de dados e erros de API.

Antes de começar

Antes de acessar os registros de erros, faça o seguinte:

• Para ativar a geração de registros, é necessário ter o administrador do Gemini Enterprise papel do IAM (roles/discoveryengine.agentspaceAdmin).

• Para acessar o Cloud Logging, é necessário ter o papel do IAM de visualizador de registros (roles/logging.viewer).

• Crie um app do Gemini Enterprise. Para criar um, consulte Criar um app.

• Verifique se os repositórios de dados estão configurados e ativos corretamente. Para mais informações sobre como configurar repositórios de dados, consulte Conectar uma fonte de dados do Google ou Conectar uma fonte de dados de terceiros.

• Ative as configurações de observabilidade para conferir os registros de erros de conectores federados. Para mais informações, consulte Ativar as configurações de observabilidade.

Acessar registros de erros de conectores federados

Termo principal: no Gemini Enterprise, o termo app pode ser usado de forma intercambiável com o termo mecanismo no contexto das APIs. Um mecanismo do Gemini Enterprise é um mecanismo de pesquisa genérico em que o app_type campo está definido como APP_TYPE_INTRANET.

Para conferir os registros de erros dos repositórios de dados que se conectam ao Gemini Enterprise usando a federação de dados, siga estas etapas:

1. No Google Cloud console, acesse a página Gemini Enterprise.

   Gemini Enterprise

2. No menu de navegação, selecione Repositório de dados.

3. Selecione um repositório de dados.

4. Clique em Ver registros. Isso abre a página Análise de registros.

5. Para conferir apenas os registros de conectores do Gemini Enterprise, insira a consulta a seguir no campo do editor de consultas e clique em Executar consulta:

    logName="projects/PROJECT_ID/logs/discoveryengine.googleapis.com%2Fconnector_activity"
    jsonPayload.LogMetadata.name="projects/PROJECT_ID/locations/LOCATION/collections/COLLECTION_ID/dataConnector"
   

   Substitua:

   • PROJECT_ID: ID do projeto.
   • LOCATION: local do conector. Por exemplo, global.
   • COLLECTION_ID: ID da coleção que contém o conector, que também é o ID do repositório de dados no Google Cloud console.

6. Refine o escopo da consulta usando um filtro. Por exemplo, clique em Todas as severidades e selecione Erro e superior. Para mais informações sobre como refinar as consultas, consulte Consultas de exemplo.

Acessar registros de erros de conectores de ingestão

Termo principal: no Gemini Enterprise, o termo app pode ser usado de forma intercambiável com o termo mecanismo no contexto das APIs. Um mecanismo do Gemini Enterprise é um mecanismo de pesquisa genérico em que o app_type campo está definido como APP_TYPE_INTRANET.

Para conferir os registros de erros dos repositórios de dados que se conectam ao Gemini Enterprise usando a ingestão de dados, siga estas etapas:

1. No Google Cloud console, acesse a página Gemini Enterprise.

   Gemini Enterprise

2. No menu de navegação, selecione Repositório de dados.

3. Selecione um repositório de dados.

4. Clique em Ver registros. Isso abre a página Análise de registros.

5. Por padrão, a página Análise de registros pesquisa os recursos listados no escopo de registro padrão para entradas de registro. Para filtrar os registros do Gemini Enterprise, faça o seguinte:

   • Selecione Todos os recursos > API consumida > API Discovery Engine e clique em Aplicar.

   • Insira o seguinte na barra de consultas e clique em Executar consulta:

     resource.type="consumed_api"
     resource.labels.service="discoveryengine.googleapis.com"
     

6. Refine o escopo da consulta filtrando os metadados JSON. Por exemplo, para consultar os registros do método ImportDocuments, faça o seguinte:

   • Insira o seguinte na barra de consultas:

     jsonPayload.context.reportLocation.functionName=~"ImportDocuments"
     

   • Expanda os metadados JSON e clique para filtrar:

     

     Figura 1. Filtre clicando nos metadados JSON

7. Para a maioria dos avisos e erros, encontre detalhes em jsonPayload.message e jsonPayload.status.

8. Para uma análise de registro mais detalhada, despeje os registros em um coletor de registros, como o BigQuery. Para mais informações, consulte Enviar registros para destinos compatíveis na documentação do Google Cloud Observability.