Pular para o conteúdo principal

Monitorar o uso do AI/BI com auditoria logs e alerta

info

Visualização

Esse recurso está em Public Preview.

Este artigo contém exemplos de consultas que os administradores do workspace podem usar para monitorar a atividade associada aos painéis e ao Genie spaces. Todas as consultas acessam a tabela audit logs, que é uma tabela do sistema que armazena registros de todos os eventos de auditoria do espaço de trabalho na sua região.

Consulte Monitorar a atividade do account com as tabelas do sistema. Para obter uma referência abrangente dos serviços e eventos de auditoria disponíveis em log, consulte Referência de auditoria log.

Monitore os rascunhos e os painéis publicados

Os exemplos desta seção demonstram como recuperar logs 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 site workspace na última semana.

SQL

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 de consultas mostrando o número de painéis criados na semana anterior.

Quais são os IDs de painel associados aos painéis mais populares?

A maioria dos exemplos deste artigo se concentra na atividade de auditoria em um painel específico. O senhor pode usar os logs de auditoria para recuperar IDs de dashboard 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.

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

Exemplo de resultados de consulta mostrando IDs de painel e uma contagem em view.

Quantas vezes esse painel foi visualizado na semana passada?

A consulta a seguir usa um site específico dashboard_id para mostrar o número de vezes que o painel foi visualizado na semana passada. A coluna action_name mostra se o rascunho ou o painel publicado foram acessados. getPublishedDashboard refere-se à visualização do painel publicado. getDashboard refere-se à visualização do painel preliminar. Quando o senhor executar a consulta, substitua <dashboard_id> pelas cadeias de caracteres UUID associadas a um painel em seu site workspace.

SQL

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:

Exemplo de resultados de consulta mostrando a visualização do painel por nome de ação.

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 espectador acessou um painel no último dia. Os resultados incluem se o usuário acessou o painel publicado (getPublishedDashboard) ou o rascunho do painel (getDashboard).

SQL

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:

Exemplo de resultados de consulta mostrando a visualização do painel por usuário e nome da ação.

Quem foram os principais espectadores na semana passada?

A consulta a seguir identifica os usuários que view um dashboard 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 os parâmetros do painel, consulte Trabalhar com parâmetros do painel.

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

Exemplo de resultados de consulta mostrando a visualização do painel por usuário e nome da ação.

Monitore painéis incorporados

O senhor pode monitorar a atividade em painéis incorporados usando a auditoria logs para eventos workspace. Para saber mais sobre outros eventos do workspace que aparecem na auditoria log, consulte eventos do espaço de trabalho.

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

SQL

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:

Exemplos de resultados de consultas mostrando detalhes de painéis incorporados.

Rastreie as interações espaciais do Genie

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

Consulta para obter feedback

A consulta a seguir retorna as classificações de feedback enviadas para o site Genie spaces em seu workspace nos últimos 30 dias. As colunas da consulta incluem o endereço space_id e o endereço email do usuário que enviou o feedback, juntamente com todas as outras colunas da tabela do sistema.

SQL

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

Solicitações de devolução para análise

A consulta a seguir retorna a atividade de solicitação de revisão do site Genie spaces nos últimos 30 dias. Ele inclui o endereço space_id, o endereço email do usuário que adicionou o comentário, o tipo de ação e todas as outras colunas da tabela de origem.

SQL
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 alerta

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