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 da ingestão do Gemini Enterprise usando o Cloud Logging.

Principais conceitos

Nesta seção, apresentamos 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, verifique se você fez o seguinte:

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

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

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

• Verifique se os repositórios de dados estão configurados corretamente e ativos. 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 como sinônimo de mecanismo no contexto de APIs. Um mecanismo do Gemini Enterprise é um mecanismo de pesquisa genérico em que o campo app_type é definido como APP_TYPE_INTRANET.

Para ver 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.

4. Clique em Ver registros. A página Análise de registros será aberta.

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 o 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 Consultas de amostra.

Acessar registros de erros do conector de ingestão

Termo-chave:no Gemini Enterprise, o termo app pode ser usado como sinônimo de mecanismo no contexto de APIs. Um mecanismo do Gemini Enterprise é um mecanismo de pesquisa genérico em que o campo app_type é definido como APP_TYPE_INTRANET.

Para ver 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.

4. Clique em Ver registros. A página Análise de registros será aberta.

5. Por padrão, a página Análise de registros pesquisa os recursos listados no escopo do registro padrão em busca de entradas de registro. Para filtrar os registros do Gemini Enterprise, siga um destes procedimentos:

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

   • Insira o seguinte na barra de consulta 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, siga um destes procedimentos:

   • Digite o seguinte na barra de consulta:

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

   • Abra os metadados JSON e clique para filtrar:

     

     Figura 1. Filtrar 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 dados de registros mais detalhada, 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.