Gere métricas do Gemini Code Assist

Este documento descreve como gerar métricas do Gemini Code Assist. Por exemplo, pode gerar métricas que comunicam a utilização ativa diária ou a aceitação de recomendações de código para uma variedade de produtos, incluindo o Cloud Logging, a CLI gcloud, o Cloud Monitoring e o BigQuery. Google Cloud

Se precisar de ativar e ver o Gemini para registos de comandos, respostas e metadados, consulte o artigo Ver registos do Google Cloud Gemini. Google Cloud

Antes de começar

Indique o número de utilizadores únicos

As instruções seguintes descrevem como usar a CLI gcloud para listar o número de utilizadores únicos do Gemini Code Assist no período de 28 dias mais recente:

  1. Num ambiente de shell, certifique-se de que atualizou todos os componentes instalados da CLI gcloud para a versão mais recente:

    gcloud components update

  2. Leia as entradas do registo para utilizadores e utilização do Gemini Code Assist:

    gcloud logging read 'resource.type=cloudaicompanion.googleapis.com/Instance labels.product=~"code_assist"' \
--freshness 28d \
--project PROJECT_ID \
--format "csv(timestamp.date('%Y-%m-%d'),labels.user_id)"

    Substitua PROJECT_ID pelo ID do seu Google Cloud projeto.

    Pode usar o comando Unix uniq para identificar utilizadores de forma exclusiva com base em cada dia.

    O resultado é semelhante ao seguinte:

    2024-10-30,user1@company.com
2024-10-29,user2@company.com
2024-10-29,user2@company.com
2024-10-29,user2@company.com
2024-10-29,user1@company.com
2024-10-28,user1@company.com

Crie um gráfico que apresente a utilização diária

Os passos seguintes mostram como usar a monitorização para criar gráficos de utilização diária que mostram o total agregado de utilizadores ativos diários do Gemini Code Assist e o número de pedidos por dia.

  1. Crie uma métrica de monitorização a partir dos dados de registo que registam o número de utilizadores do Gemini Code Assist:

    1. Na Google Cloud consola, aceda à página Explorador de registos:

      Aceda ao Explorador de registos

      Se usar a barra de pesquisa para encontrar esta página, selecione o resultado cuja legenda é Registo.

    2. No painel de consultas, introduza a seguinte consulta e, de seguida, clique em Executar consulta:

       resource.type="cloudaicompanion.googleapis.com/Instance" AND labels.product="code_assist" AND jsonPayload.@type="type.googleapis.com/google.cloud.cloudaicompanion.logging.v1.ResponseLog"

    3. Na barra de ferramentas, clique em Ações e, de seguida, selecione Criar métrica.

      É apresentada a caixa de diálogo Criar métrica baseada em registos.

    4. Configure os seguintes detalhes da métrica:

      • Certifique-se de que o Tipo de métrica está definido como Contador.
      • Atribua o nome code_assist_example à métrica.

      • Certifique-se de que a seleção de filtros está definida para apontar para a localização onde os registos estão a ser armazenados, ou seja, Project ou Bucket.

        Para obter informações sobre como gerar métricas de monitorização a partir dos dados de registo, consulte o artigo Vista geral das métricas baseadas em registos.

    5. Clique em Criar métrica.

      É apresentado um banner de êxito a explicar que a métrica foi criada.

    6. Nesse banner de sucesso, clique em Ver no explorador de métricas.

      O explorador de métricas é aberto e apresenta um gráfico pré-configurado.

  2. Guarde o gráfico num painel de controlo:

    1. Na barra de ferramentas, clique em Guardar gráfico.
    2. Opcional: atualize o título do gráfico.
    3. Use o menu Painel de controlo para selecionar um painel de controlo personalizado existente ou criar um novo.
    4. Clique em Guardar gráfico.

Analise a utilização através do BigQuery

Os passos seguintes mostram como usar o BigQuery para analisar os seus dados de registo.

Existem duas abordagens que pode usar para analisar os dados de registo no BigQuery:

  • Crie um destino de registo e exporte os seus dados de registo para um conjunto de dados do BigQuery.
  • Atualize o contentor de registos que armazena os seus dados de registo para usar o Log Analytics e, em seguida, crie um conjunto de dados do BigQuery associado.

Com ambas as abordagens, pode usar SQL para consultar e analisar os seus dados de registo, e pode representar graficamente os resultados dessas consultas. Se usar o Log Analytics, pode guardar os seus gráficos num painel de controlo personalizado. No entanto, existem diferenças nos preços. Para mais detalhes, consulte os preços do Log Analytics e os preços do BigQuery.

Esta secção descreve como criar um destino de registo para exportar entradas de registo selecionadas para o BigQuery e fornece uma lista de consultas de exemplo. Se quiser saber mais acerca da análise de registos, consulte os artigos Consultar e analisar registos com a análise de registos e Consultar um conjunto de dados do BigQuery associado.

Crie um destino de registo

  1. Na Google Cloud consola, aceda à página Log Router:

    Aceda a Registar router

    Se usar a barra de pesquisa para encontrar esta página, selecione o resultado cuja legenda é Registo.

  2. Selecione o Google Cloud projeto no qual as entradas de registo que quer encaminhar têm origem.
  3. Selecione Criar destino.

  4. No painel Detalhes do destino, introduza os seguintes detalhes:

    • Em Nome do destino, indique um identificador para o destino. Depois de criar o destino, não pode mudar-lhe o nome, mas pode eliminá-lo e criar um novo destino.

    • Para Descrição do destino, descreva a finalidade ou o exemplo de utilização do destino.

  5. No painel Destino de sincronização, configure os seguintes detalhes:

    • Em Selecionar serviço de destino, selecione Conjunto de dados do BigQuery.
    • Em Selecionar conjunto de dados do BigQuery, crie um novo conjunto de dados do BigQuery e atribua-lhe o nome code_assist_bq.

  6. Abra o painel Escolher registos a incluir no destino e, no campo Criar filtro de inclusão, introduza o seguinte:

    resource.type="cloudaicompanion.googleapis.com/Instance" AND labels.product="code_assist"

  7. Opcional: para verificar se introduziu o filtro correto, selecione Pré-visualizar registos. O Explorador de registos é aberto num novo separador com o filtro pré-preenchido.

  8. Clique em Criar destino.

Autorize o destino do registo a escrever entradas de registo no conjunto de dados

Quando tem acesso de proprietário ao conjunto de dados do BigQuery, o Cloud Logging concede ao destino de registo as autorizações necessárias para escrever dados de registo.

Se não tiver acesso de proprietário ou não vir nenhuma entrada no conjunto de dados, é possível que o destino do registo não tenha as autorizações necessárias. Para resolver esta falha, siga as instruções em Defina autorizações de destino.

Consultas

Pode usar os seguintes exemplos de consultas do BigQuery para gerar dados ao nível do utilizador e agregados para a utilização ativa diária e as sugestões geradas.

Antes de usar as consultas de exemplo seguintes, tem de obter o caminho totalmente qualificado do destino recém-criado. Para obter o caminho, faça o seguinte:

  1. Na Google Cloud consola, aceda à página BigQuery.

    Aceda ao BigQuery

  2. Na lista de recursos, localize o conjunto de dados denominado code_assist_bq. Estes dados são o destino de sincronização.

  3. Selecione a tabela de respostas abaixo de code_assist_bq_dataset, clique no ícone e, de seguida, clique em Copiar ID para gerar o ID do conjunto de dados. Tome nota para poder usá-lo nas secções seguintes como a variável GENERATED_BIGQUERY_TABLE.

Liste utilizadores individuais por dia

SELECT DISTINCT labels.user_id as user, DATE(timestamp) as use_date
FROM GENERATED_BIGQUERY_TABLE
ORDER BY use_date

Substitua GENERATED_BIGQUERY_TABLE pelo caminho totalmente qualificado da tabela de respostas do BigQuery que anotou nos passos anteriores para criar um destino.

Apresente uma lista de utilizadores agregados por dia

SELECT COUNT(DISTINCT labels.user_id) as total_users, DATE(timestamp) as use_date
FROM GENERATED_BIGQUERY_TABLE
GROUP BY use_date
ORDER BY use_date

Indicar pedidos individuais por dia e por utilizador

SELECT COUNT(*), DATE(timestamp) as use_date, labels.user_id as user
FROM GENERATED_BIGQUERY_TABLE
GROUP BY use_date, user
ORDER BY use_date

Liste pedidos agregados por dia e por data

SELECT COUNT(*), DATE(timestamp) as use_date
FROM GENERATED_BIGQUERY_TABLE
GROUP BY use_date
ORDER BY use_date

O que se segue?