Get Workspace Usage (paso)

Descripción

Escribe en una tabla del proyecto cómo se usa su espacio de trabajo. Utilícelo para seguir la adopción a lo largo del tiempo, para informar el uso por departamento o equipo, para crear sus propios paneles de control o para detectar una caída de la actividad en un flujo de trabajo programado. Las cifras son las mismas que muestra Informes de uso.

Tres conjuntos de datos contienen solo totales: ninguna fila nombra a un miembro y las rutas de los notebooks se reemplazan por *. Los otros cuatro (Miembros, Diario por miembro, Contenido y Contenido por miembro) están pensados para informes. Miembros, Diario por miembro y Contenido por miembro contienen la identidad del miembro (ID de usuario, nombre de usuario, correo electrónico, nombre, apellido y grupos de seguridad), por lo que debe tratar la tabla de destino como trataría cualquier lista de miembros. Cada ejecución del paso se registra en el Registro de seguridad.

Configuración

Datos de uso

Conjunto de datos elige lo que contiene cada fila:

Conjunto de datos	Valor	Una fila por	Contiene identidad
Diario por elemento	`daily_item`	Día, área, evento y asunto	No
Mensual por elemento	`monthly_item`	Mes, área, evento y asunto	No
Totales mensuales (predeterminado)	`monthly_tenant`	Mes y área	No
Miembros	`members`	Persona del espacio de trabajo	Sí
Diario por miembro	`daily_user`	Persona, día y área	Sí
Contenido	`content`	Panel de control, aplicación o notebook	No
Contenido por miembro	`content_user`	Persona y elemento	Sí

Área limita las filas a un área. Déjela en Todas las áreas para incluirlas todas.

Área	Valor
Todas las áreas (predeterminado)	`""`
Aplicación PlaidCloud	`plaidclient`
Paneles de control	`superset`
Aplicaciones	`panel`
Visitas a apps	`panel_visit`
Servidores de notebooks	`jupyterhub`
Notebooks	`jupyter`

Los valores son los que contiene un paso cuando lo crea o edita mediante la API o un asistente de IA.

Columnas

Diario por elemento

day, source, event, subject, events.

Mensual por elemento

month, source, event, subject, users, events, unattributed_events, coverage_start, partial.

Totales mensuales

month, source, active_users, coverage_start, partial.

partial es verdadero para un mes que el historial no cubre por completo, y coverage_start es la fecha en que comenzó la recopilación. Un mes se incluye 3 días después de cerrarse, una vez que sus cifras se han estabilizado.

Columnas de miembros

Miembros, Diario por miembro y Contenido por miembro comienzan con las mismas siete columnas:

Columna	Contiene
`user_id`	El ID del miembro.
`user_name`	El nombre de usuario del miembro.
`email`	La dirección de correo electrónico del miembro, en minúsculas.
`first_name`	Nombre.
`last_name`	Apellido.
`is_active`	Verdadero cuando el miembro está activo, falso cuando está desactivado.
`groups`	Los grupos de seguridad del miembro, separados por `;` .

groups enumera solo los grupos de nivel superior. Los subgrupos no se expanden.

Miembros

Las columnas de miembros y, a continuación:

Columna	Contiene
`first_seen`	El primer día en que el miembro usó PlaidCloud, sea cual sea el intervalo de fechas. Cuando establece un Área, es el primer día en esa área.
`last_seen`	El último día de actividad del miembro dentro del intervalo.
`active_days`	Días con actividad en el intervalo.
`events`	Eventos de actividad en el intervalo.
`active_minutes`	Minutos de actividad. Los minutos superpuestos entre áreas se cuentan una sola vez.
`session_minutes`	Minutos en sesiones.
`app_open_minutes`	Minutos que el miembro tuvo abiertas aplicaciones de Panel.

Todos los miembros tienen una fila, excepto aquellos cuyo uso se borró. Las cuentas de servicio y los agentes no aparecen en la lista. Un miembro sin actividad en el intervalo tiene valores en blanco después de groups. Los totales coinciden con Informes de uso, salvo en el caso de los miembros eliminados desde entonces.

Diario por miembro

Las columnas de miembros y, a continuación, day, source (el área), events, active_minutes, session_minutes, first_at y last_at (las horas de la primera y la última actividad de ese día).

Contenido

Columna	Contiene
`type`	`dashboard`, `panel_app`, `wasm_app` o `notebook`.
`subject`	El ID del elemento. Todos los notebooks comparten una fila, con `*` aquí.
`name`	El nombre del elemento, o `*` para los notebooks.
`deleted`	Verdadero cuando el elemento se ha eliminado desde entonces.
`users`	Miembros que lo abrieron.
`opens`	Veces que se abrió.
`last_used`	Cuándo se usó por última vez.
`app_open_minutes`	Minutos que las aplicaciones de Panel estuvieron abiertas.

Contenido por miembro

Las columnas de miembros y, a continuación, type, subject, name (como en Contenido), opens (veces que este miembro abrió el elemento) y last_day (el último día de uso del miembro).

Notas sobre los conjuntos de datos de miembros

La actividad de agentes, cuentas de servicio y miembros eliminados desde entonces tiene las columnas de identidad en blanco. Un miembro eliminado conserva el user_id y nada más.
Las aperturas en Contenido pueden superar la suma de aperturas en Contenido por miembro. La diferencia son las aperturas que no se pueden atribuir a un miembro, como las vistas incrustadas o de invitados de un panel de control. Contenido las cuenta y Contenido por miembro no puede hacerlo.

Ejemplo: minutos activos por departamento

Miembros y Contenido por miembro incluyen el email del miembro, en minúsculas, de modo que puede combinarlos con una tabla propia, como una tabla maestra de RR. HH. o de la organización, e informar por departamento.

Agregue un paso Get Workspace Usage con Conjunto de datos establecido en Miembros y una tabla de destino como usage_members.
Agregue un paso Tabla: combinación interna que combine usage_members con su tabla de la organización donde coincidan las columnas email en minúsculas. Conserve el departamento de su tabla y las columnas active_minutes y events de usage_members.
En el mismo paso, agregue por departamento y sume active_minutes.

El resultado son los minutos activos por departamento. Los miembros que no están en su tabla de la organización se descartan en una combinación interna, así que use una combinación izquierda si desea verlos. Repita con un segundo paso sobre Contenido por miembro y sume opens por departamento para informar quién usa qué paneles de control y aplicaciones.

Intervalo de fechas

Rango elige los días que se leen:

Rango	Valor	Lee
Últimos N días (predeterminado 30)	`last_days`	Los días más recientes, incluido hoy.
Mes anterior	`previous_month`	El último mes natural completo.
Mes en curso	`month_to_date`	Desde el primer día de este mes hasta hoy.
Entre fechas	`dates`	Desde Fecha de inicio hasta Fecha de fin. Deje Fecha de fin vacía para leer hasta hoy.

Los días y las fechas son UTC. Días, Fecha de inicio y Fecha de fin aceptan una variable como {report_start}, además de un número o una fecha YYYY-MM-DD. El inicio no debe ser posterior al fin.

Destino del uso

Tabla de destino recibe el resultado. El paso reemplaza lo que contuviera la tabla y siempre escribe las columnas del conjunto de datos, incluso cuando no hay filas.

Advertencias

Estas no hacen que el paso falle. Este termina con una advertencia que indica lo ocurrido y aun así escribe la tabla:

La recopilación de uso aún no está configurada para el espacio de trabajo.
No hubo uso en el intervalo.
El intervalo comienza antes de lo que se conserva, por lo que se recortó para comenzar donde empieza el historial. Los datos diarios se conservan durante 180 días y los datos mensuales durante 25 meses.

Registro de seguridad

Cada ejecución escribe una entrada en el Registro de seguridad que registra el conjunto de datos, el intervalo, la tabla de destino, el flujo de trabajo, el paso y la ejecución, y el número de filas escritas.