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 com o Gemini Enterprise.

Neste documento, descrevemos como acessar os registros de erros do conector federado e do conector de ingestão do Gemini Enterprise usando o Cloud Logging.

Principais conceitos

Esta seção apresenta os principais conceitos relacionados à capacidade de observação 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 com fontes de dados de terceiros, como Jira e 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, verifique se você fez o seguinte:

• Para ativar o registro em registros, você precisa ter o papel do IAM de administrador do Gemini Enterprise (roles/discoveryengine.agentspaceAdmin).

• Para acessar o Cloud Logging, você precisa ter o papel do IAM de Visualizador de registros (roles/logging.viewer).

• Criou um app 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.

• Ativou as configurações de observabilidade para ver os registros de erros do conector federado. Para mais informações, consulte Ativar as configurações de observabilidade.

Acessar registros de erros do conector federado

Termo-chave: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 campo app_type é 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 console Google Cloud , 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 da sua escolha.

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

5. Para ver apenas os registros do conector do Gemini Enterprise, insira a seguinte consulta 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: o local do conector. Por exemplo, global.
   • COLLECTION_ID: o ID da coleção que contém seu conector, que também é o ID do repositório de dados no console doGoogle Cloud .

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

Acessar registros de erros do conector de ingestão

Termo-chave: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 campo app_type é 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 console Google Cloud , 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 da sua escolha.

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

5. Por padrão, a página da Análise de registros pesquisa os recursos listados no escopo do 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:

   • Digite o seguinte na barra de consultas:

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

   • Expanda os metadados JSON e clique para filtrar:

     

     Figura 1. Clique em metadados JSON para filtrar

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

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