Supervisión del uso de IA/BI con registros de auditoría y alertas

Importante

Esta característica está en versión preliminar pública.

Este artículo tiene consultas de ejemplo que los administradores del área de trabajo pueden usar para supervisar la actividad asociada a paneles y espacios de Genie. Todas las consultas acceden a la tabla de registros de auditoría, que es una tabla del sistema que almacena registros para todos los eventos de auditoría de las áreas de trabajo de su región.

Consulte Supervisión de la actividad de la cuenta con tablas del sistema. Para obtener una referencia completa de los eventos y servicios de registro de auditoría disponibles, consulte Referencia del registro de diagnóstico.

Supervisar paneles de borrador y publicados

Los ejemplos de esta sección muestran cómo recuperar registros de auditoría para preguntas frecuentes sobre la actividad del panel de control.

¿Cuántos paneles se crearon en la semana pasada?

La consulta siguiente devuelve el número de paneles que se crearon en el área de trabajo durante la semana pasada.

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

En la imagen siguiente se muestran los resultados de la consulta de ejemplo:

¿Cuáles son los identificadores de panel asociados a los paneles más populares?

La mayoría de los ejemplos de este artículo se centran en la actividad de auditoría en un panel específico. Puede usar registros de auditoría para recuperar identificadores de panel específicos. La siguiente consulta recupera los paneles con el mayor número de vistas contando las acciones getDashboard y getPublishedDashboard asociadas a los identificadores.

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

En la imagen siguiente se muestran los resultados de la consulta de ejemplo:

¿Cuántas veces se ha visto este panel en la semana pasada?

La consulta siguiente usa un específico dashboard_id para mostrar el número de veces que se vio el panel en la semana pasada. La columna action_name muestra si se ha accedido al panel en estado borrador o publicado. getPublishedDashboard hace referencia a las vistas del panel publicado. getDashboard hace referencia a las vistas del panel de borrador. Al ejecutar la consulta, sustituya <dashboard_id> por la cadena UUID asociada a un panel del área de trabajo.

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

En la imagen siguiente se muestran los resultados de la consulta de ejemplo:

¿Cuál es el número de vistas por parte del usuario en el pasado día?

La consulta siguiente identifica el número de veces que un visor ha accedido a un panel en el pasado día. Los resultados incluyen si el usuario ha accedido al panel publicado (getPublishedDashboard) o al panel de borrador (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

En la imagen siguiente se muestran los resultados de la consulta de ejemplo:

¿Quiénes fueron los principales espectadores de la semana pasada?

La consulta siguiente identifica a los usuarios que ven un panel específico con más frecuencia en la semana pasada. También muestra si esas vistas estaban en paneles de borrador o publicados. Para esta consulta, el identificador del panel se proporciona como parámetro. Para más información sobre el uso de parámetros de panel, consulte Trabajar con parámetros de panel.

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

En la imagen siguiente se muestran los resultados de la consulta de ejemplo:

Supervisión de paneles incrustados

Puede supervisar la actividad en los paneles de control integrados mediante los registros de auditoría de los eventos del espacio de trabajo. Para obtener información sobre otros eventos del área de trabajo que aparecen en el registro de auditoría, consulte Eventos del área de trabajo.

La consulta siguiente recupera los detalles de los paneles que se han incrustado en sitios web o aplicaciones 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%"

En la imagen siguiente se muestran los resultados de la consulta de ejemplo:

Seguimiento de interacciones con espacios de Genie

Los ejemplos de esta sección muestran cómo recuperar registros de auditoría para preguntas comunes sobre la actividad espacial de Genie.

Consulta de comentarios

La consulta siguiente devuelve clasificaciones de comentarios enviadas para los espacios de Genie en el área de trabajo de los últimos 30 días. Las columnas de la consulta incluyen space_id y la dirección de correo electrónico del usuario que envió los comentarios, junto con todas las demás columnas de la tabla del 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

Devolución de solicitudes de revisión

La consulta siguiente devuelve la solicitud de actividad de revisión de espacios de Genie en los últimos 30 días. Incluye , la space_iddirección de correo electrónico del usuario que agregó el comentario, el tipo de acción y todas las demás columnas de la tabla de origen.

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

Configuración de alertas

Puede establecer alertas para automatizar este tipo de supervisión. Consulte Creación de una alerta para obtener información sobre cómo establecer una alerta en un umbral específico.