Monitore a utilização de IA/BI com registos de auditoria e alertas

Este artigo tem exemplos de consultas que os administradores de espaço de trabalho podem usar para monitorar a atividade associada a painéis e espaços Genie. 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.

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. Ao executar a consulta, substitua <dashboard_id> pela cadeia de caracteres UUID associada a um painel em seu espaço de trabalho.

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:

Acompanhe as interações espaciais do Genie

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

Consulta de feedback

A consulta a seguir retorna as avaliações de feedback enviadas para os espaços do Genie no seu espaço de trabalho nos últimos 30 dias. As colunas na consulta incluem o space_id, o endereço de e-mail do utilizador que enviou o feedback, juntamente com todas as outras colunas da tabela do sistema.

SELECT
  user_identity.email as user_email,
  action_name,
  request_params.space_id,
  request_params.feedback_rating,
  *
FROM
  system.access.audit
WHERE
  service_name = 'aibiGenie'
  AND action_name = 'updateConversationMessageFeedback'
  AND event_date >= current_date() - interval 30 days

Pedidos de devolução para revisão

A consulta a seguir retorna a solicitação de atividade de revisão dos espaços Genie nos últimos 30 dias. Inclui o space_id, o endereço de e-mail do usuário que adicionou o comentário, o tipo de ação e todas as outras colunas da tabela de origem.

SELECT
  user_identity.email as user_email,
  action_name,
  request_params.space_id,
  *
FROM
  system.access.audit
WHERE
    service_name = 'aibiGenie'
    AND action_name = 'createConversationMessageComment'
    AND event_date >= current_date() - interval 30 days

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.