Compartilhar via

Monitorar o uso do painel com logs de auditoria

  • Artigo

Importante

Esse recurso está em uma versão prévia.

Este artigo fornece consultas de exemplo que os administradores do workspace podem usar para monitorar a atividade associada a painéis de IA/BI. 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 workspaces em sua região.

Veja Monitore o uso 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.

Monitorar painéis de rascunho e publicados

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

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:

Exemplos de resultados da consulta mostrando o número de painéis criados na semana anterior.

Quais são as IDs de 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 de painel específicos. A consulta a seguir recupera painéis com a maioria das exibições contando as getDashboard ações 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:

Exemplos de resultados de consulta mostrando IDs de painel e uma contagem de visualizações.

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 a exibições do painel publicado. getDashboard refere-se a exibições do painel de rascunho. Ao executar a consulta, substitua <dashboard_id> pela cadeia de caracteres UUID associada a um painel em seu workspace.


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:

Resultados de consulta de exemplo mostrando exibições de painel por nome de ação.

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 em 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:

Resultados de consulta de exemplo mostrando exibições de 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 para eventos do workspace. 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:

Resultados de consulta de exemplo mostrando detalhes para painéis inseridos.