Monitorar o uso de IA/BI com auditorias e alertas

Importante

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

Este artigo contém consultas de exemplo que os administradores de ambientes de trabalho podem usar para monitorar atividades relacionadas a painéis e espaços do Genie. 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.

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

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:

Acompanhar interações de espaço do Genie

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

Consultar comentários

A consulta a seguir retorna as classificações de comentários enviadas para os espaços do Genie em seu workspace dos últimos 30 dias. As colunas na consulta incluem o space_id, o endereço de e-mail do usuário 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

Retornar solicitações de revisão

A consulta a seguir retorna a solicitação de atividade de revisão dos espaços do Genie nos últimos 30 dias. Ele inclui o space_idendereço de email 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.