Como visualizar estatísticas de consulta no console

Esta página descreve como usar o Console do Google Cloud para visualizar estatísticas de consultas SQL em um banco de dados do Cloud Spanner que teve o maior uso total da CPU em um período recente.

Se você quer recuperar dados de desempenho para essas consultas usando SQL, consulte Tabelas de estatísticas de consulta.

Noções básicas sobre quais dados o Cloud Spanner captura

As estatísticas que o Console do Cloud exibe são um agregado de todas as execuções de uma consulta em um determinado período, e não informações sobre execuções individuais da consulta. O Cloud Spanner pode não capturar toda execução de consulta e, quanto menos uma consulta for executada, maior a probabilidade de que o Cloud Spanner não capture métricas para ela.

As estatísticas de consulta podem incluir consultas SQL em qualquer tabela do banco de dados. Como resultado, se você consultar as tabelas do esquema de informações ou até mesmo as tabelas de estatísticas de consulta, essas consultas poderão aparecer nas estatísticas da consulta.

Para mais informações sobre as tabelas subjacentes que o Console do Cloud usa para exibir informações na guia Estatísticas de consulta, acesse Tabelas de estatísticas de consulta.

Para ver detalhes sobre o desempenho de consultas individuais, consulte Noções básicas sobre como o Cloud Spanner executa consultas.

Como usar parâmetros de consulta para melhorar a agregação

Usar parâmetros de consulta é uma prática recomendada. Isso melhora o desempenho das consultas e também a precisão do rastreamento de estatísticas de consulta. O Cloud Spanner agrupa as estatísticas pelo texto da consulta SQL. Se uma consulta usar parâmetros de consulta, todas as execuções serão agrupadas em uma linha. Se a consulta usar literais de string, as estatísticas serão agrupadas apenas se o texto completo da consulta for idêntico. Quando qualquer texto difere, cada consulta aparece como uma linha separada.

Como visualizar estatísticas de consultas no Console do Cloud

O Console do Cloud exibe estatísticas resumidas de consultas em um banco de dados que teve o maior uso total da CPU. As estatísticas incluem o uso total da CPU, a contagem de execução, a latência média e os segundos médios da CPU. Na guia Estatísticas da consulta, é possível selecionar um período para as estatísticas e investigar consultas individuais.

Siga estas etapas para exibir as consultas recentes que usaram mais CPU:

  1. Acesse a página Instâncias do Cloud Spanner.

    Ver as instâncias

  2. Clique no nome da instância que contém o banco de dados.

  3. Na guia Visão geral, clique no nome do banco de dados. A página Detalhes do banco de dados é exibida.

  4. Clique em Estatísticas da consulta.

    A lista mostra as consultas que tiveram o maior uso total de CPU para o intervalo completo de um minuto que é o mais recente. Abaixo da lista, o Console do Cloud exibe a hora em que o intervalo terminou.

  5. Clique em 10 min, 1 hora ou 24 horas para alterar o período das estatísticas da consulta.

Na guia Estatísticas da consulta, é possível visualizar métricas adicionais para uma consulta específica:

  1. Clique na consulta para a qual você quer ver métricas adicionais.

    O painel Detalhes exibe as métricas da consulta.

  2. No Painel de informações, clique em Abrir consulta.

    O Console do Cloud exibe a consulta. Agora, é possível executar a consulta e visualizar o respectivo plano de execução de consulta.

O Console do Cloud e o Painel de informações exibem várias estatísticas de consulta:

Estatística Descrição
Uso total da CPU Tempo total de CPU usado para todas as execuções da consulta.
Contagem de execução Número de vezes que o Cloud Spanner viu a consulta durante o intervalo de tempo.
Média de latência Tempo médio, em segundos, para cada execução de consulta no banco de dados. Essa média exclui o tempo de codificação e transmissão do conjunto de resultados e também a sobrecarga.
Tempo médio de CPU Número médio de segundos de tempo de CPU que o Cloud Spanner gastou em todas as operações para executar a consulta.
Média de linhas digitalizadas Número médio de linhas que a consulta verificou, com exceção dos valores excluídos.
Média de linhas retornadas Número médio de linhas que a consulta retornou.
Média de bytes verificados Número médio de bytes que a consulta verificou.
Média de bytes retornados Número médio de bytes de dados retornados das consultas, excluindo a sobrecarga de codificação de transmissão.

A seguir

Saiba como recuperar estatísticas de consulta usando consultas SQL.