Noções básicas sobre métricas de performance da consulta

A análise detalhada Métricas de performance de consulta em Atividade do sistema fornece detalhamentos de cada consulta executada na sua instância do Looker.

Por exemplo, você pode usar essa análise detalhada para investigar quais componentes de uma consulta demoraram mais para carregar. Você também pode usar essa análise detalhada para identificar tendências e anomalias de desempenho de consultas.

Para mais informações sobre as Análises disponíveis na atividade do sistema, consulte a página de documentação Monitorar o uso do Looker com as Análises da atividade do sistema.

Como visualizar métricas de desempenho de consultas

As métricas de performance de consultas ficam visíveis na análise detalhada Métricas de performance de consultas da atividade do sistema. É necessário ser um administrador do Looker ou ter a permissão see_system_activity para acessar a análise detalhada Métricas de performance de consultas.

Entender o ciclo de vida da consulta do Looker

Cada consulta que o Looker envia ao seu banco de dados passa por várias fases, cada uma com várias etapas. Cada uma dessas etapas é representada como uma dimensão na análise detalhada Métricas de performance da consulta.

Em um nível alto, as fases podem ser conceituadas da seguinte maneira:

  1. Fase do worker assíncrono: primeiro, a tarefa de consulta precisa ser atribuída a um worker assíncrono disponível. Pode haver um tempo de espera se nenhum worker estiver disponível.
  2. Fase de inicialização: depois que um worker assíncrono é atribuído, a instância do Looker executa várias etapas de inicialização para preparar a consulta.
  3. Fase de processamento de conexão: depois que a inicialização é concluída, a instância do Looker estabelece uma conexão com o banco de dados do cliente.
  4. Fase principal de consulta: depois que a instância do Looker estabelece uma conexão com o banco de dados do cliente, a consulta principal é executada nele. Outras consultas para calcular resultados, como totais, também podem ser executadas dependendo das opções escolhidas para a consulta. Se a consulta não for transmitida, ela será carregada na memória da instância do Looker. Depois disso, a conexão da instância do Looker com o banco de dados do cliente é fechada.
  5. Fase pós-consulta: por fim, a instância do Looker executa várias etapas pós-consulta para preparar a consulta para o próximo destino. Nesse momento, o worker assíncrono é liberado.

Métricas de performance de consulta

As seções a seguir listam cada fase e etapa da consulta em ordem cronológica.

Métricas da fase de worker assíncrono

Etapa de consulta Descrição da métrica
Queued Tempo em segundos que uma consulta aguarda a disponibilidade de um worker assíncrono para ser executada.
Async processing Tempo em segundos que um worker assíncrono gasta na consulta. O worker continua trabalhando na consulta até depois que a fase pós-consulta é concluída. Portanto, essa métrica se sobrepõe à maioria das outras métricas nesta página.

Métricas da fase de inicialização

Etapa de consulta Descrição da métrica
Model Init: From Cache Tempo em segundos para extrair a definição do modelo do cache. Se isso retornar um valor nulo, significa que o modelo foi carregado e analisado em vez de extraído do cache. Consulte a etapa Model Init: Computed.
Model Init: Computed Tempo em segundos que leva para carregar e analisar o modelo necessário para executar uma consulta. Se isso retornar um valor nulo, significa que o modelo foi recuperado do cache em vez de carregado e analisado do zero. Consulte a etapa Model Init: From Cache.
Explore Init: From Cache Tempo em segundos para extrair a inicialização do recurso "Explorar" do cache. Se isso retornar um valor nulo, significa que a análise foi carregada e analisada em vez de extraída do cache. Consulte a etapa Explore Init: Computed.
Explore Init: Computed Tempo em segundos para inicializar a análise detalhada antes de começar a prepare. Se isso retornar um valor nulo, significa que a análise detalhada foi recuperada do cache em vez de ser carregada e analisada do zero. Consulte a etapa Explore Init: From Cache.
Prepare Tempo em segundos para preparar a consulta com base na definição da análise detalhada.

Métricas da fase de tratamento de conexões

Etapa de consulta Descrição da métrica
Per User Throttler Tempo em segundos que a consulta passa esperando que uma conexão fique disponível para o usuário executar a consulta.
Acquire Connection Tempo, em segundos, que a instância do Looker leva para adquirir uma conexão com o banco de dados do cliente. Esta etapa inclui o tempo para pesquisar as credenciais do usuário, criar o pool de conexões, se ele ainda não existir, e inicializar a conexão para uso.
Connection Held Tempo em segundos que a instância do Looker mantém uma conexão com o banco de dados do cliente. Essa etapa inclui o tempo necessário para que o banco de dados do cliente execute a consulta SQL.

Principais métricas da fase de consultas

Etapa de consulta Descrição da métrica
Cache Load Tempo em segundos para extrair resultados brutos do cache de conjunto de resultados.
PDTs Tempo em segundos para criar as tabelas derivadas persistentes necessárias para a consulta.
Execute Main Query Tempo, em segundos, para executar a consulta primary no banco de dados de clientes. Isso não inclui o tempo necessário para adquirir uma conexão no banco de dados do cliente. Isso não é rastreado para consultas que exigem o uso do recurso Permitir resultados extensos.
Execute Totals Query Tempo em segundos para executar a consulta e gerar totais no banco de dados de clientes. Aplicável apenas a consultas com totais ativados.
Execute Row Totals Query Tempo em segundos para executar a consulta e gerar totais de linhas no banco de dados de clientes. Aplicável apenas a consultas com totais de linhas ativados.
Execute Grand Totals Query Tempo em segundos para executar a consulta e gerar o total geral no banco de dados de clientes. Só se aplica a consultas com totais e totais da linha ativados.
Load Process and Stream Main Query Tempo em segundos para carregar a consulta principal (do banco de dados do cliente), processá-la (na instância do Looker) e transmiti-la (ao cliente). Aplicável apenas a consultas transmitidas por streaming.
Load Main Query In Memory Tempo, em segundos, para carregar os principais resultados da consulta na memória do banco de dados do cliente. Válido apenas para consultas não transmitidas.
Load Totals Query In Memory Tempo em segundos que leva para carregar a consulta e gerar totais na memória. Aplicável somente a consultas não transmitidas com totais ativados.
Load Row Totals Query In Memory Tempo em segundos para carregar a consulta e gerar os totais de linhas na memória. Aplicável apenas a consultas não transmitidas com totais de linhas ativados.
Load Grand Totals Query In Memory Tempo em segundos que leva para carregar a consulta e gerar o total geral na memória. Só se aplica a consultas sem streaming com totais e totais de linha ativados.

Métricas da fase pós-consulta

Etapa de consulta Descrição da métrica
Postprocessing Tempo em segundos necessário para o pós-processamento da consulta. Ocorre depois que a conexão é fechada.
Stream to Cache Tempo em segundos para processar e transmitir resultados para o cache de renderização.

Métricas do BigQuery BI Engine

Se você estiver usando o BigQuery BI Engine com o Looker, use a análise detalhada Métricas de desempenho da consulta para conferir informações específicas do banco de dados sobre suas consultas. As consultas que não usam o BI Engine e as consultas de bancos de dados que não são do BigQuery retornam valores nulos para essas métricas.

Métrica Descrição da métrica
BigQuery Job ID

O ID do job do BigQuery para a consulta (ou NULL).

Para reduzir o tempo de resposta das consultas no BigQuery, o Looker executa consultas do BigQuery usando jobCreationMode=JOB_CREATION_OPTIONAL. Nesse modo, quando o BigQuery determina que pode concluir uma consulta rapidamente, ele prioriza o retorno de resultados imediatos em vez de criar um job do BigQuery. Nesse caso, a consulta terá um ID de consulta do BigQuery, e o ID do job do BigQuery será NULL.

Se o BigQuery determinar que não pode retornar resultados imediatos, ele vai criar um job, e a consulta terá um ID de job do BigQuery (e o ID de consulta do BigQuery será NULL).
BigQuery Query ID

O ID da consulta do BigQuery (ou NULL).

Para reduzir o tempo de resposta das consultas no BigQuery, o Looker executa consultas do BigQuery usando jobCreationMode=JOB_CREATION_OPTIONAL. Nesse modo, quando o BigQuery determina que pode concluir uma consulta rapidamente, ele prioriza o retorno de resultados imediatos em vez de criar um job do BigQuery. Nesse caso, a consulta terá um ID de consulta do BigQuery em vez de um ID de job do BigQuery.

Se o BigQuery determinar que não pode retornar resultados imediatos, ele vai criar um job, e a consulta terá um ID de job do BigQuery (e o ID de consulta do BigQuery será NULL). Se esse campo estiver em branco, o BigQuery não conseguiu executar a consulta imediatamente e criou um job para isso. Consulte BigQuery Job ID para receber um ID do job do BigQuery.
BI Engine Mode Indica se a consulta foi executada parcialmente ou totalmente acelerada. Consulte Estatísticas de aceleração do BI Engine para mais informações sobre os valores possíveis desse campo.
BI Engine Reason Se a consulta não puder ser executada totalmente acelerada, esse campo vai mostrar o motivo. Essa mensagem vem diretamente do Google BigQuery.

Solução de problemas com métricas de performance de consulta

Analisar as métricas de consulta pode ajudar a melhorar a performance na sua instância do Looker. Para começar, selecione o painel Recomendações de performance na lista de painéis de atividade do sistema.