Informes de uso

Informes de uso muestra quién usa qué en su espacio de trabajo: qué pantallas, paneles de control, aplicaciones y cuadernos abren los usuarios, cuántas personas regresan y adónde van después. Úselo para ver qué adoptan sus miembros, qué paneles de control y aplicaciones justifican su existencia y en qué punto de un proceso abandonan las personas.

Ábralo desde la pestaña Identidad, junto al Registro de seguridad.

Quién puede verlo

Informes de uso requiere el mismo permiso que el Registro de seguridad: identity.security_log.read. Sin él, el botón no se ofrece, y un miembro que abra el informe de todos modos verá un aviso de que no tiene acceso.

Los informes muestran el uso por miembro en dos lugares: la pestaña Usuarios y las exportaciones Actividad diaria por miembro y Primer uso, que incluyen los identificadores de miembro. Todo lo demás se cuenta de forma agregada entre los miembros. Conceda el permiso solo a las personas que deban ver la actividad individual.

Qué se contabiliza

Informes de uso combina cinco orígenes. Elija uno en Origen o déjelo en Todos los orígenes.

Origen	Qué se registra
Aplicación PlaidCloud	Las pantallas que abren los miembros y las acciones que realizan en la aplicación.
Superset	Vistas de paneles de control y gráficos.
Aplicaciones de Panel	Visitas a las aplicaciones y el tiempo que los miembros pasan en cada una.
JupyterHub	El tiempo que los miembros pasan en las sesiones de JupyterHub.
Cuadernos de Jupyter	Los cuadernos que los miembros abren y guardan.

Las sesiones de JupyterHub y los cuadernos de Jupyter son orígenes independientes, por lo que puede elegir cualquiera de los dos. Las aplicaciones de Panel son un único origen. Los eventos de cuadernos solo se registran para los cuadernos que se ejecutan en la imagen de cuaderno predeterminada. Una imagen personalizada no los informa.

Leer los informes

Elija un origen y un Intervalo de fechas en la parte superior de la ventana y luego seleccione Actualizar. Los intervalos son los últimos 7, 30, 90 o 180 días. Cada pestaña se carga al abrirla por primera vez y de nuevo cuando cambia el origen o el intervalo.

Resumen

Las cifras principales del intervalo:

Cifra	Significado
Usuarios activos	Miembros con cualquier actividad.
Usuarios nuevos	Miembros vistos por primera vez en el intervalo.
Usuarios recurrentes	Miembros activos que se vieron por primera vez antes del intervalo.
Minutos activos	Aproximado: cinco minutos por cada período con actividad.
Eventos	Todo lo registrado.
Eventos sin atribuir	Eventos para los que no se pudo identificar a ningún miembro. Cuentan como eventos, no como usuarios.
Minutos de sesión	Tiempo de sesión de Panel y JupyterHub, contabilizado aparte de los minutos activos.

Adopción enumera cada pantalla, panel de control, gráfico o elemento con su origen, evento, número de usuarios, proporción de usuarios activos, eventos y eventos sin atribuir. Por mes muestra los usuarios activos, el promedio de usuarios diarios y la fidelidad de uso de cada mes, con una nota cuando el mes aún está en curso, solo está cubierto en parte o es una instantánea congelada.

Actividad

Usuarios activos por período Diaria, Semanal o Mensual, además de Retención por primera semana: para cada semana en que aparecieron miembros por primera vez, cuántos regresaron en cada semana posterior. Un período marcado con asterisco no está totalmente dentro del intervalo.

Rutas

Los movimientos más frecuentes entre pantallas, como Pasó de, Pasó a y Veces recorrida, entre aplicaciones y orígenes. Las rutas abarcan como máximo los últimos 30 días.

Usuarios

Una fila por miembro: nombre, nombre de usuario, días activos, eventos, minutos activos, minutos de sesión y cuándo se vio por primera y por última vez.

Exportaciones

Descargue un resumen como CSV. Elija el Resumen y un Intervalo de fechas de hasta 25 meses y luego seleccione Descargar CSV.

Resumen	Contenido
Actividad diaria	Usuarios y eventos de cada día, origen, evento y asunto.
Actividad diaria por miembro	Lo mismo para cada miembro, con identificadores de miembro.
Adopción mensual	Usuarios y eventos de cada mes, origen, evento y asunto.
Usuarios activos mensuales	Usuarios activos de cada mes y origen.
Primer uso	Cuándo usó cada miembro cada origen por primera vez, con identificadores de miembro.

La exportación usa el origen que eligió sobre las pestañas. Un resumen grande se descarga en lotes de hasta 50,000 filas, y la ventana los combina en un solo archivo. Si el archivo fuera mayor de lo que la ventana puede generar, guarda lo que tiene y le avisa de que el archivo está incompleto: elija un intervalo más corto para obtener el resto.

Cada exportación escribe una entrada en el Registro de seguridad que indica quién exportó qué resumen, el intervalo y el número de filas. Un resumen que abarca varios lotes escribe una entrada por cada lote.

Embudo

Vea cuántos miembros recorren una secuencia de pasos. Un paso es un evento de uno de los orígenes, para un asunto concreto, o Cualquier asunto.

Seleccione Agregar paso y elija el origen, el evento y el asunto de cada paso. Un embudo tiene de 2 a 6 pasos.
Elija Tiempo permitido entre pasos: 1, 6, 24, 72 o 168 horas.
Elija un Intervalo de fechas de 7, 30 o 90 días.
Seleccione Ejecutar embudo.

El resultado muestra, para cada paso, cuántos miembros lo alcanzaron, la proporción de quienes comenzaron, cuántos se detuvieron allí y el tiempo mediano desde el paso anterior. Los pasos pueden combinar orígenes, de modo que puede seguir a un miembro desde una pantalla de PlaidCloud hasta un panel de control de Superset. Embudos recientes reabre un embudo que ejecutó antes. Una lista de pasos solo ofrece los eventos registrados en el intervalo.

Uso sin atribuir

Algunos eventos no se pueden vincular a un miembro de PlaidCloud. Cuentan en Eventos y en Eventos sin atribuir, pero nunca en los recuentos de usuarios. Los casos principales:

Una cuenta de Superset creada dentro de Superset en lugar de a través de PlaidCloud.
Una vista de un panel de control incrustado, que no tiene usuario de Superset.
Actividad de Panel y JupyterHub que los registros de la plataforma no pueden vincular a un miembro. Su atribución proviene de esos registros, por lo que debe considerarla una estimación.

Una proporción grande de eventos sin atribuir en un origen significa que sus recuentos de usuarios están subestimados.

Cuándo empieza el historial

El historial comienza cuando se activa la recopilación de uso en su espacio de trabajo, y un día o mes anterior no muestra actividad. El primer mes con datos aparece marcado como parcial.

Panel y JupyterHub se leen de los registros de la plataforma, que se conservan durante unos 90 días. Cuando comienza la recopilación, esos dos orígenes se completan con, como máximo, esa cantidad de historial anterior. Superset se completa a partir de sus propios registros, hasta 180 días. Solo la aplicación PlaidCloud empieza desde cero cuando comienza la recopilación.

Informes de uso conserva los eventos sin procesar durante 180 días, por lo que el intervalo más largo es de 180 días, y conserva los resúmenes mensuales durante 25 meses. Cuando se elimina a un miembro fuera de PlaidCloud, por ejemplo mediante SCIM o Keycloak, su uso sin procesar caduca a los 180 días y su registro de primer uso a los 25 meses.

Borrar el uso de un miembro

Un administrador del espacio de trabajo (o superusuario) con el permiso identity.security_log.read puede borrar el uso de un miembro y dejar de recopilarlo, y levantar el borrado más adelante. Tanto borrar como restaurar requieren ese permiso y ese rol. Estas dos acciones están disponibles solo a través de la API REST.

Acción	Solicitud
Borrar	`DELETE /rest/v1/identity/usage/users/{user_id}`
Restaurar	`DELETE /rest/v1/identity/usage/users/{user_id}/erasure`

Al borrar se eliminan los eventos y el registro de primer uso del miembro, y desde ese momento los informes y las exportaciones lo excluyen. Su uso no se vuelve a recopilar, y el historial que se lea más adelante de los registros de Panel y JupyterHub también se descarta. Si la eliminación no puede completarse de inmediato, la respuesta lo indica y la siguiente ejecución horaria de mantenimiento la completa.

Al restaurar se levanta el borrado para que la nueva actividad se vuelva a recopilar. No recupera lo que se borró.

Ambas acciones escriben una entrada en el Registro de seguridad.