Monitorar consultas ativas

Nesta página, descrevemos como monitorar e solucionar problemas das consultas que estão sendo executadas na sua instância do Spanner. Consultas ativas são consultas de longa duração que podem afetar o desempenho da instância. O monitoramento dessas consultas pode ajudar a identificar as causas de latência da instância e o alto uso da CPU.

Usando o console Google Cloud , é possível conferir as consultas ativas na página Query Insights do Spanner. Elas são classificadas pelo horário de início da consulta. Se houver muitas consultas ativas, os resultados poderão ser limitados a um subconjunto do total de consultas devido às restrições de memória que o Spanner impõe à coleta de dados.

Antes de começar

Para receber as permissões necessárias para ver as consultas ativas, peça ao administrador para conceder a você os seguintes papéis do IAM na instância:

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias por meio de papéis personalizados ou de outros papéis predefinidos.

Visualizar consultas ativas

Para conferir as consultas ativas de cada banco de dados, faça o seguinte:

  1. No console Google Cloud , acesse a página Instâncias do Spanner.

    Acessar a página "Instâncias do Spanner"

  2. Clique na instância que contém as consultas que você quer monitorar.

  3. No menu de navegação, clique em Query Insights.

  4. Use o menu Banco de dados para especificar o banco de dados que você quer monitorar.

  5. Clique na guia Consultas ativas. A guia contém um resumo das consultas ativas e uma tabela com as 50 consultas ativas mais longas.

Ver consultas de maior duração

A tabela a seguir descreve as colunas na tabela Consultas em execução há mais tempo da guia Consultas ativas:

Nome da coluna Descrição
ID da consulta O identificador exclusivo da consulta.
Consulta O texto da consulta SQL.
Impressão digital O hash do REQUEST_TAG ou do texto da consulta SQL.
Horário de início O carimbo de data/hora de quando a consulta começou.
Duração da consulta A duração da consulta ativa em execução.
Ação Contém um link para encerrar a consulta.

Quando a opção Atualização automática está ativada, a tela é atualizada a cada 60 segundos.

Encerrar uma consulta

É possível encerrar uma consulta em execução na sua instância. Encerrar uma consulta pode ajudar a liberar recursos e reduzir a carga na sua instância. Encerrar uma consulta é uma operação de melhor esforço.

A página do console Google Cloud é atualizada depois que você inicia o encerramento. Se o encerramento for bem-sucedido, a consulta será removida da tabela. Se o encerramento falhar, ele vai ocorrer em segundo plano, e a consulta vai continuar aparecendo na tabela Consultas em execução há mais tempo.

O Spanner pode não cancelar uma consulta quando os servidores estão ocupados. Você pode tentar encerrar uma consulta novamente para cancelar.

Para receber a permissão necessária para encerrar uma consulta, peça ao administrador para conceder a você o papel do IAM Leitor do banco de dados do Cloud Spanner (spanner.databaseReader) na instância.

Esse papel predefinido contém a permissão spanner.sessions.delete, que é necessária para encerrar uma consulta.

Para encerrar uma consulta, faça o seguinte:

  1. Selecione a consulta que você quer encerrar na tabela Consultas em execução há mais tempo.
  2. Na coluna Ações, clique em Encerrar.
  3. Na janela Encerrar consulta, clique em Confirmar.

A seguir