Configurações de administrador: painéis de atividades 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. É possível fazer o download, programar, ativar alertas e acessar métricas e elementos, assim 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 programar 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, dados históricos de consultas e estatísticas de desempenho. A granularidade e 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 é acessível na atividade do sistema e pode ser visualizado por qualquer usuário que tenha permissão para acessar o modelo de atividade do sistema.

Tomar medidas: modifique quem tem acesso de leitura 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.

Os painéis de atividade do sistema e as análises detalhadas são restritos no número de consultas simultâneas que podem ser executadas. Essa restrição pode aumentar os tempos de carregamento dos painéis de atividade do sistema.

Dica da equipe de 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 seus usuários e o uso deles da 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:

  • É o número total de usuários na sua instância do Looker ao longo do tempo.

  • 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

  • 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 fizeram login na 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 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 painéis e visualizações acessados nos últimos 30 dias, que pode ser classificada pelo número de visualizações na interface do Looker, o número de visualizações em uma incorporação, o número de visualizações pela API, o número de vezes que o conteúdo foi marcado como favorito e o número de vezes que o conteúdo foi entregue por um job programado
  • Uma lista de análises detalhadas criadas nos últimos 30 dias, mostrando o número de vezes que a análise detalhada foi executada e o número de usuários que a executaram
  • Uma lista de painéis 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, além do número de vezes que o conteúdo foi marcado como favorito e entregue por um job programado
  • Uma lista de análises detalhadas criadas nos últimos 90 dias que não foram consultadas nos últimos 30 dias, mostrando o tempo decorrido desde a última execução, o número de vezes que a análise detalhada foi executada nos últimos 90 dias, a data da última execução e a data da primeira execução

Painel de desempenho do banco de dados

O painel Performance do banco de dados mostra informações sobre o desempenho do conteúdo e dos PDTs na sua instância do Looker, incluindo o tempo de execução total e médio das consultas e dos PDTs, além de listar o número de erros de consulta e falhas de build do PDT.

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 executadas nos últimos 30 dias, agrupadas por origem, com os tempos de execução agregados em níveis e cada nível 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 executadas nos últimos sete dias
  • Uma tabela com as 10 principais origens de consulta que mostra o número de consultas executadas nos últimos sete 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 da 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 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 Performance 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 a execução média de consultas para dias em que a execução média excede 1,5 vez a variação padrão para todos os dias, mostrando quais dias têm um impacto excepcionalmente grande no programador
  • O número de jobs programados para cada Análise detalhada
  • Uma lista de todos os painéis com a atualização automática ativada e 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 de 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.
  • Bloco de texto com links para páginas de práticas recomendadas e 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 performance inclui blocos que mostram as seguintes informações:

  • Recomendações de painel: uma lista de painéis que talvez não estejam funcionando e recomendações para melhorar a performance.
  • 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 em 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 apresenta recomendações da página de práticas recomendadas Considerações ao criar painéis de Looker com bom desempenho. É 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.

Explorar recomendações

O bloco Recomendações de análise detalhada mostra as análises detalhadas que podem causar problemas de desempenho na sua instância do Looker ou no seu banco de dados.

O bloco compara os valores médios das métricas de performance da consulta de cada Análise com os comparativos de mercado para a performance 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 os avisos e as recomendações que você pode receber.

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 do LookML. Verifique se o código de produção do LookML é alterado com pouca frequência, de preferência quando 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 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 junções desnecessárias do arquivo explore do LookML. Use o parâmetro LookML fields para excluir campos desnecessários da Análise. Verifique se o código de produção do LookML é alterado com pouca frequência, de preferência quando 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 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 a lógica SQL complexa em tabelas derivadas persistentes (PDTs, na sigla em inglês) para reduzir o tempo 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 os mova para o LookML quando possível. Remova pivots, classificações ou formatações de valores complexos.
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 pivots, classificações ou formatações de valores complexos.

Painel "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.

Esse painel mostra apenas os erros que ocorrem no momento da execução da consulta. Por exemplo, se você remover um campo do LookML de uma visualização, todos os Looks e painéis que usam esse campo vão mostrar avisos, mas o painel 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 de painéis que estão produzindo erros, incluindo os erros informados, o emissor de cada consulta de 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 informados e o emissor de cada consulta de 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 gerou um erro "criar erro cancelado" e o número de vezes que a TDP gerou um "erro de valor de acionamento"
  • O número de erros de cada origem de consulta nos últimos 10 dias

Diagnósticos do dashboard

O painel Diagnóstico do painel mostra oportunidades para melhorar a performance 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 Tempo de execução da consulta por hora e Tempo de execução da consulta por bloco, detalham o tempo de execução da consulta por fase. 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 da consulta: é o tempo, em segundos, que o Looker gastou para criar a consulta a partir do LookML de origem e se conectar ao banco de dados. Se essa etapa estiver demorando muito, isso pode indicar que a complexidade do modelo do LookML ou a conectividade do banco de dados está afetando o tempo 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 esse painel foi executado no período selecionado
  • A porcentagem de consultas deste painel que foram executadas a partir do cache
  • O tempo médio de consulta por bloco
  • Os usuários que mais usam esse painel
  • O tempo médio de consulta por hora
    • Se houver picos nesse bloco, verifique 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 combinados no painel
  • Recomendações do painel: uma lista de possíveis problemas de desempenho e recomendações para melhorar o desempenho do painel.