Monitorar o uso do painel de controle

Importante

Esse recurso está em Visualização Pública.

Esta página tem consultas de exemplo que os administradores podem usar para monitorar a atividade associada aos painéis. Todas as consultas acessam a tabela de logs de auditoria, que é uma tabela do sistema que armazena registros para todos os eventos de auditoria de workspaces na sua região.

Os administradores da conta têm acesso às tabelas do sistema por padrão. Para conceder acesso a outros usuários, confira Conceder acesso às tabelas do sistema.

Consulte Monitorar a atividade da conta com tabelas do sistema. Para obter uma referência abrangente dos serviços e eventos de log de auditoria disponíveis, consulte a Referência de log de diagnóstico.

Monitorar rascunhos e painéis publicados

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

Quantos painéis foram criados na semana passada?

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

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 exemplos de resultados de consulta:

Quais são as IDs do painel associadas 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 específicas do painel. A consulta a seguir recupera painéis com a maioria dos modos de exibição contando as ações de getDashboard e getPublishedDashboard associadas às IDs.

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 exemplos de resultados de consulta:

Quantas vezes este painel foi visualizado na semana passada?

A consulta a seguir usa um específico dashboard_id para mostrar o número de vezes que o painel foi exibido na semana passada. A action_name coluna mostra se o rascunho ou o painel publicado foi acessado. getPublishedDashboard refere-se às exibições do painel publicado. getDashboard refere-se às exibições do painel de rascunho.

Para essa consulta, a ID do painel é fornecida como um parâmetro. Para saber mais sobre como usar parâmetros de painel, consulte Trabalhar com parâmetros de painel. Para obter o dashboard_id de um painel específico, consulte a URL e a ID do Painel.

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 exemplos de resultados de consulta:

Qual é o número de exibições por usuário no último dia?

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

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 exemplos de resultados de consulta:

Quem foram os principais espectadores na semana passada?

A consulta a seguir identifica os usuários que exibem um painel específico com mais frequência na semana passada. Ele também mostra se essas exibições estavam nos painéis de rascunho ou publicados. Para essa consulta, a ID do painel é fornecida como um parâmetro. Para saber mais sobre como usar parâmetros de painel, consulte Trabalhar com parâmetros de painel.

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 exemplos de resultados de consulta:

Monitorar painéis incorporados

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

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

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 exemplos de resultados de consulta:

Configurar alertas

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