Configurações de administrador: painéis de atividade do sistema

A seção Atividade do sistema do menu Administrador do Looker mostra painéis criados pelo Looker com informações de uso e desempenho sobre a instância do Looker. É possível fazer o download, programar, ativar alertas e detalhar métricas e elementos, assim como em qualquer outro painel. Os dados nos painéis "Atividade do sistema" são atualizados e armazenados em cache a cada 12 horas.

Antes de ativar a atividade do sistema em uma implantação do Looker hospedada pelo cliente com o back-end do MySQL, verifique se você configurou corretamente o usuário para o banco de dados de back-end. Especificamente, você precisa executar a etapa para grant all on looker_tmp.* to '<DB_username>'@'%'; antes de ativar o recurso Atividade do sistema. Consulte o procedimento na página de documentação Como migrar o banco de dados de back-end do Looker para o MySQL.

Como a permissão para entregar conteúdo a destinos de e-mail é específica do modelo, para enviar ou programar painéis de atividade do sistema para destinos de e-mail, os usuários precisam selecionar Todos os modelos no Conjunto de modelos especificado para a função deles.

Os painéis de atividades do sistema se conectam ao banco de dados de aplicativos do Looker. Elas mostram informações sobre sua instância do Looker, incluindo Looks e dashboards salvos na instância, informações do usuário, informações históricas de consultas e estatísticas de desempenho da instância. A granularidade e a retenção de dados da Atividade do sistema estão sujeitas a restrições. A atividade do sistema foi criada para coletar dados de alto volume, e agregá-los para complementar seus registros de negócios.

Esses dados podem ser úteis para complementar as atividades de monitoramento e auditoria, mas não substituem sua estratégia de compliance atual.

Por padrão, os dados da Atividade do sistema são armazenados no banco de dados interno do Looker. Nessa configuração, o Looker armazena no máximo 90 dias de dados históricos de consultas e eventos.

O texto em filtros executados pelos usuários pode ser acessado em "Atividade do sistema" e pode ser visualizado por qualquer usuário que tenha permissão para visualizar o modelo Atividade do sistema.

Entre em ação: modifique quem tem acesso de leitura ao modelo "Atividade do sistema". Os administradores do Looker têm acesso a esse modelo por padrão. Os usuários que não são administradores podem receber acesso ao modelo de atividade do sistema se receberem a permissão see_system_activity.

As Análises e os painéis de atividades do sistema têm restrições quanto ao número de consultas simultâneas que podem ser executadas. Essa restrição pode aumentar o tempo de carregamento dos painéis de atividade do sistema.

Dica para a equipe do chat: os dados com base no tempo na atividade do sistema são armazenados no fuso horário do sistema do Looker. Para mais informações, consulte a página de documentação Como usar configurações de fuso horário.

Painéis de atividades do sistema

Estes são os painéis de atividade do sistema:

Painel de atividades do usuário

O painel Atividade do usuário mostra informações sobre os usuários e como eles usam sua instância do Looker.

O painel Atividade do usuário inclui blocos que mostram as seguintes informações:

  • O número total de usuários na sua instância do Looker
  • O número de usuários sem incorporação classificados como Desenvolvedores (Administrador)
  • O número de usuários sem incorporação classificados como Padrão (criador)
  • O número de usuários sem incorporação classificados como Leitor
  • O número de usuários incorporados classificados como Leitor
  • O número de usuários de incorporação classificados como Padrão (criador)

  • A porcentagem de usuários que fizeram pelo menos uma consulta na sua instância do Looker nos últimos sete dias

  • O número de usuários que realizaram pelo menos uma consulta por semana nas últimas seis semanas

  • Média de minutos de atividade e número médio de consultas por usuário a cada semana nas 6 semanas anteriores

  • O número de usuários que emitiram pelo menos uma consulta nos sete dias anteriores, agrupados por origem da consulta

  • Uma lista de usuários que passaram a maior parte do tempo usando sua instância do Looker nos últimos sete dias

  • Uma lista de usuários que criaram a maioria dos novos painéis na sua instância do Looker nos últimos sete dias

  • Uma lista de usuários que acionaram a maioria dos eventos Git da instância do Looker ao longo do tempo

  • Uma lista de usuários que não fizeram login na sua instância do Looker nos últimos 90 dias

  • Um bloco de texto com links para os recursos de educação e treinamento do Looker

Painel de atividades de conteúdo

O painel Atividade de conteúdo mostra informações sobre quais dashboards, Looks e Explores estão sendo visualizados e programados na sua instância do Looker.

O painel Atividade de conteúdo inclui blocos que mostram os seguintes dados:

  • O número de painéis que não foram excluídos
  • A quantidade de Looks que não foram excluídos
  • O número de planos programados
  • A porcentagem de painéis que foram consultados nos 30 dias anteriores
  • É a porcentagem de Looks que foram consultados nos últimos 30 dias
  • O número de jobs programados para cada dia nos últimos sete dias
  • O número de consultas do Explore que foram emitidas nos últimos 30 dias
  • Uma lista de todos os dashboards e Looks acessados nos últimos 30 dias, que pode ser classificado pelo número de visualizações na interface do Looker, número de visualizações em uma incorporação, quantas vezes foram visualizados na API, quantas vezes o conteúdo foi adicionado como favorito e quantas vezes o conteúdo foi enviado em um job programado.
  • Uma lista de Análises criadas nos últimos 30 dias, mostrando o número de vezes que ele foi executado e o número de usuários que o fizeram
  • Uma lista de dashboards e Looks que não foram acessados nos últimos 30 dias, mostrando o número de visualizações do conteúdo nos últimos 90 dias na interface do Looker, em uma incorporação e usando a API. Nos últimos 90 dias, o número de vezes que o conteúdo foi adicionado como favorito e o número de vezes que ele foi exibido em um job programado
  • Uma lista de Análises criadas nos 90 dias anteriores que não foram consultadas nos últimos 30 dias, mostrando quanto tempo passou desde a última execução, o número de vezes que ela foi executada nos últimos 90 dias, a data em que ela foi executada pela última vez e a data em que ela foi executada pela primeira vez

Painel de desempenho do banco de dados

O painel Desempenho do banco de dados mostra informações sobre a performance do conteúdo e das TDPs na sua instância do Looker, incluindo os ambientes de execução total e médio de consultas e TDPs, além do número de erros de consulta e falhas de build das TDPs.

O painel Desempenho do banco de dados inclui blocos que mostram os seguintes dados:

  • A porcentagem de consultas retornadas do cache
  • Todas as consultas que foram executadas nos últimos 30 dias, agrupadas por origem, com ambientes de execução de consulta agregados em níveis e com cada nível de ambiente de execução mostrado como uma porcentagem de todas as consultas.
  • Uma tabela dos 15 principais usuários que mostra o número de consultas executadas nos últimos sete dias
  • Uma tabela das 10 principais origens de consulta que mostra o número de consultas executadas nos últimos sete dias.
  • O número de consultas que foram executadas, o número de usuários ativos e a porcentagem de consultas retornadas do cache do Looker para cada hora do dia
  • O número de tarefas e planos programados para cada hora do dia
  • O número de builds de TDP para cada conexão em cada hora do dia
  • O tempo de execução médio de cada Análise nos últimos sete dias, classificado pelo tempo de execução mais longo
  • O ambiente de execução médio de cada Look nos últimos sete dias, classificado pelo maior tempo de execução
  • O tempo de execução médio de cada painel nos últimos sete dias, classificado pelo tempo de execução mais longo
  • Uma lista de cada TDP criada nos sete dias anteriores, mostrando o número de falhas de gatilho, falhas de criação e builds bem-sucedidos
  • O tempo médio de build para cada TDP nos sete dias anteriores, classificado pelo maior tempo médio de build

Painel de desempenho da instância

O painel Desempenho da instância mostra informações sobre a carga e o desempenho do programador e do conteúdo que exige alto desempenho.

O painel Desempenho da instância inclui blocos que mostram os seguintes dados:

  • Um mapa de calor que mostra o número de jobs programados e o tempo médio deles na fila para cada hora de cada dia da semana, mostrando quais horas ou dias têm o maior impacto no programador
  • O número de consultas e o tempo de execução médio de consultas para os dias em que o tempo de execução médio excede 1,5 vez o desvio padrão para todos os dias, mostrando quais dias têm impacto excepcionalmente grande no programador
  • O número de jobs programados para cada Explore
  • Uma lista de todos os painéis com a atualização automática ativada com o número de blocos não textuais no painel
  • O conteúdo programado com mais frequência nos 14 dias anteriores, mostrando o número de vezes que cada item de conteúdo foi programado por dia
  • Uma lista de consultas que foram transferidas por download ou programadas com a opção Todos os resultados
  • Uma lista de dashboards com mais de 25 blocos, mostrando o número de blocos do Look, Lookless, mesclagem de blocos de consulta, total de blocos, total de consultas geradas e total de blocos de consulta para cada dashboard
  • Um bloco de texto com links para páginas de práticas recomendadas e páginas de documentação sobre otimização do Looker

Painel de recomendações de desempenho

O painel Recomendações de desempenho mostra oportunidades para melhorar o desempenho na sua instância do Looker.

O painel Recomendações de desempenho inclui blocos que mostram as seguintes informações:

As seções abaixo explicam os blocos com mais detalhes.

Recomendações do painel

O bloco Recomendações do painel mostra painéis que podem causar problemas de desempenho na instância do Looker ou no banco de dados. O bloco oferece recomendações da página Práticas recomendadas ao criar painéis de alto desempenho do Looker. É possível aplicar essas recomendações no nível do painel para ajudar a melhorar o desempenho. Confira a seguir os possíveis avisos que você pode encontrar:

Aviso Recomendação
The number of queries generated by this dashboard is <X>, which is higher than recommended (<25). Reduza o número de blocos de consulta ou crie um segundo painel de controle.
The number of merge queries generated by this dashboard is <X>, which is higher than recommended (<=4). Reduza o número de blocos de resultados da mesclagem.
The auto-refresh interval of this dashboard is <X>, which is lower than recommended (>=15 min). Aumente ou desative a configuração do intervalo de atualização automática para evitar sobrecarregar o banco de dados.

Conheça as recomendações

O bloco Explorar recomendações mostra Análises que podem causar problemas de desempenho na instância do Looker ou no banco de dados.

O bloco compara os valores médios das métricas de desempenho da consulta de cada Análise com comparativos de mercado para proporcionar um desempenho íntegro da instância. A gravidade listada ao lado de cada Análise indica até onde as métricas dela excedem esses comparativos de mercado.

Com base em quais métricas excedem os comparativos de mercado, o bloco fornece estratégias segmentadas de solução de problemas para ajudar a melhorar o desempenho. Confira a seguir os avisos e recomendações que você pode encontrar.

Etapa de consulta Aviso Recomendações
Model Init: Computed The average model init: computed time is <X>, which is above the recommended benchmark. Remova as visualizações desnecessárias do parâmetro include do modelo LookML. Verifique se o código de produção do LookML é alterado com pouca frequência, de preferência nos momentos em que os usuários não estão executando muitas consultas.
Explore Init: From Cache The average explore init: from cache (marshalled cache load) time is <X>, which is above the recommended benchmark. Mova campos personalizados e cálculos de tabelas para o LookML sempre que possível.
Explore Init: Computed The average explore init: computed time is <X>, which is above the recommended benchmark. Remova joins desnecessárias do arquivo explore do LookML. Use o parâmetro fields do LookML para excluir campos desnecessários do Explore. Verifique se o código de produção do LookML é alterado com pouca frequência, de preferência nos momentos em que os usuários não estão executando muitas consultas.
Prepare The average prepare time is <X>, which is above the recommended benchmark. Ative o recurso Novo ambiente de execução do LookML para diminuir o tempo de preparação. Mova campos personalizados e cálculos de tabelas para o LookML sempre que possível.
Acquire Connection The average connection acquisition time is <X>, which is above the recommended benchmark. Configure o limite máximo de conexão no painel de configurações de conexão. Defina um limite não inferior ao número máximo de consultas necessárias para serem executadas simultaneamente no tráfego de pico.
Execute Main Query The average main query execution time is <X>, which is above the recommended benchmark. Evite lógica SQL complexa, como funções de janela, CTEs, condições de mesclagem em campos de data ou grandes cadeias de mesclagem. Coloque a lógica SQL complexa em tabelas derivadas persistentes (TDPs) para reduzir o tempo de consulta. Use o reconhecimento agregado quando possível.
Postprocessing The average postprocessing time is <X>, which is above the recommended benchmark. Simplifique os cálculos de tabelas e mova-os para o LookML quando possível. Remova tabelas dinâmicas, classificações ou formatação de valores complexas.
Stream to Cache The average stream to cache time is <X>, which is above the recommended benchmark. Simplifique os cálculos de tabelas e mova-os para o LookML quando possível. Remova tabelas dinâmicas, classificações ou formatação de valores complexas.

Painel de erros e conteúdo corrompido

O painel Erros e conteúdo corrompido mostra os dashboards, os Looks, as programações e as TDPs que produzem erros de consulta, além do número de erros de cada origem da consulta.

Este painel exibe apenas erros que ocorrem no ambiente de execução da consulta. Por exemplo, se você remover um campo LookML de uma visualização, todos os Looks e dashboards que usarem esse campo vão mostrar avisos, mas o dashboard Erros e conteúdo corrompido não vai mostrar esses avisos. Use o Content Validator para verificar se há problemas de referência do LookML nos Looks e dashboards.

O painel Erros e conteúdo corrompido inclui blocos que mostram os seguintes dados:

  • Uma lista dos painéis que estão gerando erros, incluindo os erros informados, o emissor de cada consulta do painel e o número de usuários que executaram consultas usando cada painel
  • Uma lista de jobs programados que estão produzindo erros, incluindo os erros informados e o criador de cada programação
  • Uma lista de Looks que estão produzindo erros, incluindo os erros fornecidos e o emissor de cada consulta do Look
  • Uma lista de TDPs que estão produzindo erros, incluindo as ações de TDP que criaram a entrada de registro de erros, todos os dados relacionados à ação da TDP, o número de vezes que a TDP produziu uma ação "Criar erro cancelado" e o número de vezes que a TDP produziu um "erro no valor do acionador"
  • O número de erros de cada origem de consulta nos últimos 10 dias

Diagnóstico do painel

O painel Diagnóstico mostra oportunidades para melhorar o desempenho em um painel individual.

Acesse o painel Diagnóstico do painel em qualquer painel clicando no menu de três pontos Ações do painel e selecionando Resumo de desempenho do painel.

Alguns blocos, como Ambiente de execução de consulta por hora e Ambiente de execução de consulta por bloco, detalham o ambiente de execução da consulta por estágio. Estes são os estágios da consulta:

  • Na fila:o tempo, em segundos, que a consulta passou na fila do lado do Looker. O Looker enfileira consultas quando o limite máximo de conexões por nó da conexão é atingido ou quando o limite por usuário (que tem um valor padrão de 15 consultas simultâneas) é atingido.
  • Inicialização de consulta:o tempo, em segundos, que o Looker gastou para criar a consulta usando o LookML de origem e se conectar ao banco de dados. Se essa fase estiver demorando muito, isso pode indicar que a complexidade do modelo LookML ou a conectividade do banco de dados está afetando o ambiente de execução da consulta.
  • Executar consulta:o tempo, em segundos, que o Looker gastou aguardando os resultados da consulta enquanto ela era executada no banco de dados. Isso inclui a consulta principal e todas as consultas adicionais necessárias, incluindo o cálculo dos totais e a criação de TDPs. Essa é a causa mais comum de um tempo de execução longo do painel e pode ser melhorada com a otimização do desempenho da consulta.
  • Processamento de resultados:o tempo, em segundos, que o Looker gastou formatando, calculando os cálculos da tabela e armazenando o conjunto de resultados em cache.

O painel Diagnóstico do painel inclui blocos que mostram as seguintes informações:

  • O título do painel
  • O número de usuários que executaram este painel no período selecionado
  • O número de vezes que este painel foi executado no período selecionado
  • A porcentagem de consultas deste painel que foram executadas no cache
  • O tempo médio de consulta por bloco
  • Os usuários que executaram este painel com mais frequência
  • O tempo médio de consulta por hora
    • Se houver picos neste bloco, confira se não há vários planos programados sendo enviados ao mesmo tempo.
  • O número de blocos com pelo menos uma consulta de resultados mesclados
  • O número de consultas de resultados mesclados no painel
  • Recomendações do painel: uma lista de possíveis problemas de desempenho e recomendações para melhorar o desempenho do painel.