Pular para o conteúdo principal
Última atualização em

Monitorar o uso do painel de controle

info

Visualização

Este recurso está em Pré-visualização Pública.

Esta página contém exemplos de consultas que os administradores podem usar para monitorar a atividade associada aos painéis de controle. Todas as consultas acessam a tabela logs de auditoria, que é uma tabela do sistema que armazena registros de todos os eventos de auditoria do espaço de trabalho em sua região.

Os administradores de contas têm acesso às tabelas do sistema por default. Para conceder acesso a outros usuários, consulte Conceder acesso a tabelas do sistema.

Consulte Monitorar a atividade account com tabelas do sistema. Para uma referência completa dos serviços e eventos log de auditoria disponíveis, consulte a Referência log auditoria.

Monitorar versões preliminares e publicadas dos painéis de controle​

Os exemplos nesta seção demonstram como recuperar logs de auditoria para perguntas comuns sobre a atividade do painel de controle.

Quantos dashboards foram criados na última semana?​

A consulta a seguir retorna o número de dashboards que foram criados em seu workspace na última semana.

SQL

SELECT
  action_name,
  COUNT(action_name) as num_dashboards
FROM
  system.access.audit
WHERE
  action_name = "createDashboard"
  AND event_date >= current_date() - interval 7 days
GROUP BY
  action_name

A imagem a seguir mostra um exemplo de resultados de consulta:

Exemplo de resultado da consulta mostrando o número de dashboards criados na semana anterior.

Quais são os IDs dos painéis associados aos painéis mais populares?​

A maioria dos exemplos neste artigo se concentra na atividade de auditoria em um painel específico. Você pode usar logs de auditoria para recuperar IDs de painel específicos. A consulta a seguir recupera os dashboards com mais visualizações, contando as ações getDashboard e getPublishedDashboard associadas aos IDs.

SQL
SELECT
  request_params.dashboard_id as dashboard_id,
  COUNT(*) AS view_count
FROM
  system.access.audit
WHERE
  action_name in ("getDashboard", "getPublishedDashboard")
GROUP BY
  dashboard_id
ORDER BY
  view_count DESC

A imagem a seguir mostra um exemplo de resultados de consulta:

Exemplo de resultados de consulta mostrando os IDs dos painéis e a contagem view .

Quantas vezes este painel foi visualizado na última semana?​

A consulta a seguir usa um dashboard_id específico para mostrar o número de vezes que o painel foi visualizado na última semana. A coluna action_name mostra se o painel de controle foi acessado em versão preliminar ou publicada. getPublishedDashboard refere-se à visualização do painel publicado. getDashboard refere-se à visualização do painel de controle em versão preliminar.

Para esta consulta, o ID do painel de controle é fornecido como parâmetro. Para saber mais sobre como usar parâmetros do painel de controle, consulte Trabalhar com parâmetros do painel de controle. Para obter o dashboard_id para um painel específico, consulte URL e ID do painel.

SQL

SELECT
  action_name,
  COUNT(action_name) as view_count
FROM
  system.access.audit
WHERE
  request_params.dashboard_id = :dashboard_id
  AND event_date >= current_date() - interval 7 days
  AND action_name in ("getDashboard", "getPublishedDashboard")
GROUP BY action_name

A imagem a seguir mostra um exemplo de resultados de consulta:

Exemplo de resultados de consulta mostrando a visualização do painel por nome da ação.

Qual foi o número de visualizações por usuário no último dia?​

A consulta a seguir identifica o número de vezes que um visualizador acessou um painel de controle no último dia. Os resultados incluem se o usuário acessou o painel publicado (getPublishedDashboard) ou o painel de rascunho (getDashboard).

SQL

SELECT
  user_identity.email as username,
  COUNT(user_identity.email) as num_views,
  action_name
FROM
  system.access.audit
WHERE
  service_name = 'dashboards'
AND action_name in ('getDashboard', 'getPublishedDashboard')
AND event_time > now() - interval '1 day'
GROUP BY username, action_name

A imagem a seguir mostra um exemplo de resultados de consulta:

Exemplo de resultados de consulta mostrando a visualização do painel por usuário e nome da ação.

Quem foram os maiores telespectadores da última semana?​

A consulta a seguir identifica os usuários que view um painel específico com mais frequência na última semana. Também mostra se essas visualizações estavam em painéis de controle em rascunho ou publicados. Para esta consulta, o ID do painel de controle é fornecido como parâmetro. Para saber mais sobre como usar parâmetros do painel de controle, consulte Trabalhar com parâmetros do painel de controle.

SQL
SELECT
  user_identity.email as user_email,
  action_name,
  COUNT(action_name) as view_count
FROM
  system.access.audit
WHERE
  request_params.dashboard_id = :dashboard_id
  AND event_date >= current_date() - interval 7 days
  AND action_name in ("getDashboard", "getPublishedDashboard")
GROUP BY action_name, user_email

A imagem a seguir mostra um exemplo de resultados de consulta:

Exemplo de resultados de consulta mostrando a visualização do painel por usuário e nome da ação.

Monitorar painéis incorporados​

Você pode monitorar a atividade em painéis incorporados usando os logs de auditoria de eventos workspace . Para saber mais sobre outros eventos workspace que aparecem no log de auditoria, consulte Eventos do espaço de trabalho.

A consulta a seguir recupera detalhes de painéis que foram incorporados em sites ou aplicativos externos.

SQL

SELECT
  request_params.settingTypeName,
  source_ip_address,
  user_identity.email,
  action_name,
  request_params
FROM
  system.access.audit
WHERE
  request_params.settingTypeName ilike "aibi%"

A imagem a seguir mostra um exemplo de resultados de consulta:

Exemplo de resultados de consulta mostrando detalhes de painéis incorporados.

Configurar alerta​

Você pode configurar alertas para automatizar esse tipo de monitoramento. Consulte Criar um alerta para saber como configurar um alerta com base em um limite específico.