Configurações de administrador - Painéis de atividade do sistema

A seção Atividade do sistema do menu Administrador exibe painéis integrados que mostram informações de uso e desempenho sobre sua instância do Looker. Você pode fazer o download, agendar, definir alertas e detalhar métricas e elementos como em qualquer outro painel. Os dados nos painéis de atividades 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, é necessário 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 enviar conteúdo para destinos de e-mail é específica do modelo, para enviar ou agendar painéis de atividade do sistema para destinos de e-mail, os usuários devem ter Todos os modelos selecionados no conjunto de modelos especificado para a função deles.

Os painéis de atividade do sistema se conectam ao banco de dados de aplicativos subjacente da sua instância do Looker. Eles mostram informações sobre sua instância, incluindo Looks e dashboards, informações do usuário, informações do histórico de consultas e estatísticas de desempenho. Tanto a granularidade quanto a retenção dos dados de Atividade do sistema estão sujeitas a restrições do sistema. A Atividade do sistema foi criada para coletar dados de alto volume e agregá-los para complementar os registros da sua empresa.

Esses dados podem ser úteis para complementar as atividades de monitoramento e auditoria, mas não têm a intenção de substituir sua estratégia de compliance atual.

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

O texto nos filtros executados pelos usuários fica acessível na 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 visualização ao modelo de atividade do sistema. Os administradores têm acesso a esse modelo por padrão. Usuários que não são administradores poderão receber acesso ao modelo de atividade do sistema se tiverem a permissão see_system_activity.

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

Dica para a equipe do Chat: os dados baseados em tempo na Atividade do sistema são armazenados usando o fuso horário do sistema. 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 atividades do sistema:

Painel de atividades do usuário

O painel Atividade do usuário mostra informações sobre os usuários e como eles utilizam 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 de cada tipo na sua instância do Looker, incluindo:
  • A porcentagem de usuários que fizeram pelo menos uma consulta na sua instância do Looker nos últimos sete dias
  • Um resumo da atividade de login dos usuários nos últimos 90 dias
  • A média de minutos de atividade e o número médio de consultas por usuário a cada semana nas últimas seis semanas
  • O número de usuários que emitiram pelo menos uma consulta nos últimos sete dias, agrupados por origem da consulta
  • Uma lista dos usuários que passaram mais tempo usando sua instância do Looker nos últimos sete dias
  • Uma lista de usuários que criaram mais painéis novos na sua instância do Looker nos últimos sete dias
  • Uma lista de usuários que acionaram mais eventos do Git na sua instância do Looker ao longo do tempo
  • Uma lista de usuários que não se conectaram à sua instância do Looker nos últimos 90 dias
  • Um bloco de texto com links para recursos de educação e treinamento do Looker

Painel de atividades de conteúdo

O painel Content Activity mostra informações sobre quais dashboards, Looks e Explores estão sendo visualizados e programados na 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
  • O número de Looks que não foram excluídos
  • O número de planos programados
  • É a porcentagem de painéis que foram consultados nos últimos 30 dias
  • É 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 da Análise que foram feitas nos últimos 30 dias
  • Uma lista de todos os dashboards e Looks que foram acessados nos últimos 30 dias, podendo ser classificados pelo número de visualizações na interface do Looker, de visualizações em uma incorporação, de visualizações pela API, de quantas vezes o conteúdo se tornou favorito e quantas vezes o conteúdo foi entregue em um job programado.
  • Uma lista de Análises criadas nos últimos 30 dias, mostrando o número de vezes que a Análise foi executada e a quantidade de usuários executando-a
  • 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 pela API. Nos últimos 90 dias, o número de vezes que o conteúdo foi definido como favorito e o número de vezes que o conteúdo foi entregue por meio de um job programado.
  • Uma lista de Análises criadas nos últimos 90 dias que não foram consultadas nos últimos 30 dias, mostrando o tempo desde a última execução, o número de vezes que a Análise foi executada nos últimos 90 dias, a data em que ela foi executada pela última vez e pela primeira vez.

Painel de desempenho do banco de dados

O painel Desempenho do banco de dados mostra informações sobre o desempenho do conteúdo e das PDTs na instância do Looker, incluindo os ambientes de execução totais e médios de consultas e PDTs, e lista o número de erros de consulta e falhas de build da TDP.

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

  • A porcentagem de consultas que foram retornadas do cache
  • Todas as consultas feitas nos últimos 30 dias, agrupadas por origem, com ambientes 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 com os 15 principais usuários que mostra o número de consultas feitas nos últimos 7 dias
  • Uma tabela com as 10 principais origens de consulta que mostra o número de consultas executadas nos últimos 7 dias
  • O número de consultas 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 agendados para cada hora do dia.
  • O número de builds de TDP de 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 tempo de execução médio de cada Look nos últimos sete dias, classificado pelo tempo de execução mais longo
  • 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 PDT criada nos últimos sete dias, mostrando o número de falhas de gatilho, falhas criadas e builds bem-sucedidos
  • O tempo médio de build de cada PDT nos últimos sete dias, 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 muito desempenho.

O painel Instance Performance 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 da consulta 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 um impacto excepcionalmente maior no programador
  • O número de jobs programados para cada Análise
  • Uma lista de todos os painéis com a atualização automática ativada com o número de blocos sem texto no painel
  • O conteúdo programado com mais frequência nos últimos 14 dias, mostrando o número de vezes que cada item foi programado a cada dia
  • Uma lista das consultas que foram baixadas ou programadas com a opção Todos os resultados
  • Uma lista de dashboards com mais de 25 blocos, mostrando o número de blocos Lookless, blocos de consulta de mesclagem, 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 como otimizar o Looker

Painel de recomendações de desempenho

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

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

  • Recomendações do painel: uma lista de painéis e recomendações que podem ter um desempenho insatisfatório para melhorar os resultados
  • Confira as recomendações: uma lista de análises e recomendações que podem ter um bom desempenho para melhorar a performance.

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

Recomendações do painel

O bloco Recomendações do painel mostra painéis que podem afetar o desempenho na instância do Looker ou no banco de dados. O bloco fornece recomendações da página de práticas recomendadas Considerações ao criar painéis de alta performance no Looker. É possível aplicar essas recomendações no nível do painel para melhorar o desempenho. Confira a seguir alguns possíveis avisos:

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 dashboard.
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 combinados.
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.

Confira as recomendações

O bloco Análises recomendadas mostra Análises que podem afetar o 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 um desempenho íntegro da instância. A gravidade listada ao lado de cada Análise indica até que ponto as métricas dela excedem os comparativos de mercado.

Com base nas métricas que excedem os comparativos de mercado, o bloco oferece estratégias direcionadas de solução de problemas para ajudar a melhorar o desempenho. Confira a seguir alguns avisos e recomendações.

Etapa da consulta Aviso Recomendações
Model Init: Computed The average model init: computed time is <X>, which is above the recommended benchmark. Remova visualizações desnecessárias do parâmetro include do modelo LookML. Garanta que o código de produção do LookML seja alterado com pouca frequência, idealmente quando os usuários não estiverem 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 tabela 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 mesclagens desnecessárias do arquivo explore do LookML. Use o parâmetro LookML fields para excluir campos desnecessários da Análise. Garanta que o código de produção do LookML seja alterado com pouca frequência, idealmente quando os usuários não estiverem 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 tabela para o LookML sempre que possível.
Acquire Connection The average connection acquisition time is <X>, which is above the recommended benchmark. Defina 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 pico de tráfego.
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 junção. Coloque lógica SQL complexa em tabelas derivadas persistentes (PDTs, na sigla em inglês) para reduzir os tempos de consulta. Use reconhecimento agregado quando possível.
Postprocessing The average postprocessing time is <X>, which is above the recommended benchmark. Simplifique os cálculos de tabela e transfira-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 tabela e transfira-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 dashboard Erros e conteúdo corrompido mostra os dashboards, os Looks, as programações e as PDTs que produzem erros de consulta, além do número de erros de cada origem de consulta.

Este painel exibe apenas os erros que ocorrem no tempo de execução da consulta. Por exemplo, se você remover um campo do LookML de uma visualização, todos os Looks e dashboards que usam esse campo exibirão avisos, mas o dashboard Errors and Broken Content não exibirá 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 de painéis que estão produzindo erros, incluindo os erros fornecidos, 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 fornecidos 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 da 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 a quantidade de vezes que a TDP produziu um "erro de valor do acionador"
  • O número de erros de cada origem de consulta nos últimos 10 dias

Diagnóstico do painel

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

Para acessar o Diagnóstico do painel em qualquer painel, clique no menu de três pontos Ações do painel e selecione Resumo de desempenho do painel.

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

  • Na fila:é o tempo, em segundos, que a consulta passou na fila do Looker. O Looker enfileira as consultas quando o limite Número 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 criando a consulta no LookML de origem e se conectando ao banco de dados. Se esse estágio 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 é executada no banco de dados. Isso inclui a consulta principal e todas as consultas adicionais necessárias, incluindo o cálculo de totais e a criação de PDTs. Essa é a causa mais comum de tempos de execução longos 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 os resultados, calculando cálculos de 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, verifique se não há vários planos programados sendo enviados ao mesmo tempo.
  • 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.