Monitorizar a utilização do painel

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

Os administradores de contas têm acesso a tabelas de sistema por defeito. Para conceder acesso a outros utilizadores, veja Conceder acesso às tabelas do sistema.

Consulte Monitorização da 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 Referência de log de diagnóstico.

Monitorizar painéis de rascunho e publicados

Os exemplos nesta secção demonstram como obter registos de auditoria para perguntas comuns sobre a atividade do dashboard.

Quantos painéis foram criados na semana passada?

A consulta a seguir retorna o número de painéis que foram criados em seu espaço de trabalho na semana passada.

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 os IDs de painel 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 registos de auditoria para recuperar IDs de painel específicos. A consulta a seguir recupera painéis com o maior número de visualizações, contando as ações getDashboard e getPublishedDashboard associadas aos 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 visualizações do painel de controlo publicado. getDashboard refere-se a visualizações do painel de rascunho.

Para essa consulta, o ID do painel é fornecido 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, veja URL e ID do Dashboard.

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 visualizações por usuário no último dia?

A consulta a seguir identifica o número de vezes que um visualizador acessou um painel no dia anterior. 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 melhores telespectadores na semana passada?

A consulta a seguir identifica os usuários que visualizam um painel específico com mais frequência na semana passada. Ele também mostra se essas visualizações estavam em painéis de rascunho ou publicados. Para essa consulta, o ID do painel é fornecido 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:

Monitorizar painéis incorporados

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

A consulta a seguir recupera detalhes de painéis que foram incorporados 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.