Para exportar eventos del registro de actividad (acciones individuales que realiza un usuario) y los informes de uso (informes agregados de una app) a Google BigQuery, debes establecer una configuración de BigQuery Export en la Consola del administrador de Google.
Acerca de los datos de BigQuery y la API de Reports
Los datos disponibles en el conjunto de datos de BigQuery difieren de los datos recuperados de la API de informes. Los datos de BigQuery solo incluyen el conjunto de datos sin filtrar. Aún puedes filtrar los datos con SQL, pero no se admiten todos los parámetros de la API de Reports.
Puedes filtrar los datos de la API de Reports incluyendo parámetros en la solicitud a la API.
Ejemplo: Hay dos unidades organizativas en un dominio, A y B. Con la API de Reports y BigQuery, puedes acceder a todos los eventos de todo el dominio (A y B).
- Sin embargo, con la API de Reports, puedes recuperar los eventos A usando el parámetro orgUnitID en la solicitud a la API.
- Con SQL y BigQuery, no puedes filtrar eventos por unidad organizativa, ya que no hay una columna correspondiente al parámetro orgUnitID.
Importante:
- Los datos de BigQuery incluyen datos históricos (180 días para los datos de actividad y 450 días para los datos de uso). También puedes recuperar datos históricos de la API de informes.
- Si desactivas la exportación de datos de Google Workspace a BigQuery, no se incluirán datos nuevos
en BigQuery Export. Sin embargo, los datos existentes están disponibles en
otras fuentes, como la API de
Reports.
- Las tablas de BigQuery tienen particiones diarias en la seudocolumna (_PARTITIONTIME). Estas particiones se derivan de la columna time_usec para las tablas de actividad y de la columna date para las tablas de uso. En particular, Workspace anula los límites de UTC predeterminados de BigQuery para alinear las particiones con la hora del Pacífico (PT). Para optimizar el costo de las consultas de BigQuery, Google recomienda filtrar por _PARTITIONTIME junto con time_usec o date.
- No todos los datos de los informes de servicio están disponibles en BigQuery Export. Para obtener una lista de los servicios compatibles, consulta ¿Qué servicios admite BigQuery Export? en esta página.
- Para ver ejemplos de consultas, consulta Ejemplos de consultas de registros de informes en BigQuery.
Cómo se propagan y retienen los datos
- Las políticas pueden tardar una hora en propagarse. Después de eso, se crean tablas diarias en tu conjunto de datos (hora del Pacífico).
- Los datos se guardan según los lineamientos de otros registros e informes. Para obtener más detalles, consulta Tiempos de demora y de retención de datos.
- Las tablas de datos no se borran automáticamente. Para borrar un proyecto activo, ve a Borra una configuración de BigQuery Export.
- Los eventos del registro de actividad están disponibles en un plazo de 10 minutos. Los eventos de registro de uso tienen un retraso de 48 horas en la configuración inicial, pero, después, el retraso habitual es de 1 a 3 días.
Antes de comenzar
Importante: Si usas la política de la organización de restricción de dominio en Google Cloud, asegúrate de agregar el ID de cliente de Google C02h8e9nw a la lista de entidades permitidas.
Primero, debes configurar un proyecto de BigQuery en la consola de Google Cloud. Cuando crees el proyecto, haz lo siguiente:
- Agrega una cuenta de administrador de Google Workspace como:
- Rol de administrador de BigQuery (roles/bigquery.admin) o rol de Identity and Access Management (IAM) equivalente
- Administrador de IAM de proyecto (roles/resourcemanager.projectIamAdmin)
- Agrega la cuenta de servicio gapps-reports@system.gserviceaccount.com como editor del proyecto (o un rol de editor de IAM equivalente). Necesitas esto para escribir registros, actualizar el esquema y completar el paso 5 más adelante.
Para obtener instrucciones, consulta Configura un proyecto de BigQuery para los registros de informes.
Paso 1: Establece una configuración de BigQuery Export
-
En la Consola del administrador de Google, ve a Menú
Informes
Integraciones de datos (o Exportación de BigQuery para administradores de Education, que abre la página Integraciones de datos).
Es necesario tener el privilegio de administrador de los Informes.
- Señala la tarjeta BigQuery Export y haz clic en Editar
.
- Para activar los registros de BigQuery, marca la casilla Habilita la exportación de datos de Google Workspace a Google BigQuery.
- Opcional: Para exportar parámetros sensibles de las reglas de protección de datos, marca la casilla Permitir la exportación de contenido sensible desde los registros de reglas de protección de datos. Para obtener detalles, consulta Visualiza el contenido que activa las reglas de protección de datos.
- En ID del proyecto de BigQuery, selecciona el proyecto en el que deseas almacenar los registros. Elige un proyecto para el que gapps-reports@system.gserviceaccount.com tenga un rol de editor o un rol de editor de IAM equivalente. Si no ves el proyecto, tendrás que configurarlo en BigQuery. Para obtener más detalles, consulta la Guía de inicio rápido para usar la consola de Google Cloud.
- En Nuevo conjunto de datos en el proyecto, ingresa el nombre del conjunto de datos que se usará para almacenar los registros en el proyecto. Los nombres de los conjuntos de datos deben ser completamente nuevos y únicos, y no deben existir en Google Cloud. Para obtener más información, consulta Crea conjuntos de datos.
- (Opcional) Marca la casilla Restringir el conjunto de datos a una ubicación geográfica específica
selecciona la ubicación en el menú. Para obtener más información, consulta Multirregiones.
- Haz clic en Guardar. Nota: Si no puedes guardar el proyecto, ve a la consola de Google Cloud, borra el conjunto de datos nuevo y, luego, vuelve a guardarlo en la Consola del administrador.
Cuando se activa la exportación, el conjunto de datos se crea al día siguiente. Además de los propietarios, editores y visualizadores de los proyectos, se agrega la cuenta de servicio gapps-reports@system.gserviceaccount.com como editor. La cuenta de servicio es necesaria para escribir registros y actualizar el esquema.
Paso 2: Cambia el conjunto de datos de BigQuery Export y reabastece un conjunto de datos nuevo (opcional)
Puedes cambiar la configuración de BigQuery Export para comenzar a exportar datos a un conjunto de datos diferente del actual. También puedes mover los datos existentes del conjunto de datos anterior al que seleccionaste recientemente (180 días para la auditoría y 450 días para el uso). Por ejemplo, puedes cambiar la ubicación del conjunto de datos de BigQuery Export de EE.UU. a la UE. El reabastecimiento te permite transferir datos que ya están almacenados en la región de EE.UU. a la región de la UE. Si eliges reabastecer, BigQuery crea un conjunto de datos nuevo en la ubicación especificada.
Consideraciones
- Los datos existentes se exportan a un conjunto de datos nuevo si seleccionas una ubicación nueva, cambias el ID del proyecto o cambias el ID del conjunto de datos.
- Los datos exportados también se conservan en el conjunto de datos anterior.
- Los datos nuevos, junto con los datos reabastecidos, se almacenan en el conjunto de datos nuevo.
- Los datos existentes (180 días para la auditoría y 450 días para el uso) se exportan al conjunto de datos nuevo, pero no se borran de la ubicación existente, por lo que tendrás conjuntos de datos de BigQuery Export en 2 ubicaciones.
Para reabastecer los datos existentes en la ubicación nueva, sigue estos pasos:
-
En la Consola del administrador de Google, ve a Menú
Informes
Integraciones de datos (o Exportación de BigQuery para administradores de Education, que abre la página Integraciones de datos).
Es necesario tener el privilegio de administrador de los Informes.
- Ingresa el nombre nuevo del conjunto de datos.
- Si quieres reabastecer los datos existentes en la ubicación nueva, marca la casilla Reabastecer los datos existentes de BigQuery de los últimos 180 días en el conjunto de datos nuevo.
- Haz clic en Confirmar
Guardar.
Requisitos de exportación de datos de registro
Los datos de registro se exportan a través de la API de insertAll, que requiere que habilites la facturación para tu proyecto de BigQuery Export. Si no está habilitada la facturación, tu proyecto estará en modo de zona de pruebas y los datos de registro no se exportarán a tu conjunto de datos. Para obtener más información, consulta Limitaciones.
Nota: Las exportaciones de informes de uso siguen habilitadas para los proyectos en modo de zona de pruebas.
Tiempos de retraso
En la mayoría de los casos, después de activar la exportación de datos a BigQuery, los eventos del registro de actividad están disponibles en un plazo de 10 minutos. Los eventos de registro de uso tienen un retraso de 48 horas en la configuración inicial, pero, luego, el retraso habitual es de 1 a 3 días. Para obtener más detalles, consulta Tiempos de demora y de retención de datos.
Preguntas frecuentes
¿Cómo configuro un vencimiento de datos para mis exportaciones?
De forma predeterminada, el vencimiento de las exportaciones de datos se establece en 60 días. Por lo tanto, cualquier exportación de datos de BigQuery que realices se borrará de Google Cloud después de 60 días.
Para cambiar el tiempo de vencimiento, consulta Actualiza el vencimiento predeterminado de las tablas.
¿Puedo cambiar un ID del proyecto de BigQuery?
Sí, puedes cambiar el ID del proyecto para una configuración de BigQuery Export en cualquier momento. Los cambios se aplicarán al día siguiente, cuando se copien los datos en el nuevo proyecto de BigQuery.
Importante: No debes cambiar el proyecto de BigQuery, ya que los datos anteriores no se copian en la tabla nueva. Para acceder a los datos anteriores, accede al proyecto anterior.
¿Qué servicios admite BigQuery Export?
Se admiten los siguientes datos de eventos de registro:
- Cuentas
- Administrador
- Chrome
- Classroom
- Migración de datos
- Data Studio
- Dispositivos
- Gemini para Workspace
- Gemini Notebook
- Gmail
- Calendario de Google
- Google Chat
- Google Drive
- Grupos de Google
- Google Meet
- Hardware de Google Meet
- Acceder
- OAuth
- Reglas
- SAML
Se admiten los siguientes informes de uso:
- Cuentas
- Google Apps Script
- Google AppSheet
- Calendario
- Chrome OS
- Classroom
- Dispositivos
- Documentos de Google
- Drive
- Gmail
- Búsqueda de Google
- Meet
- Google Sites
- Google Voice
Nota: Planeamos admitir más eventos de registro, incluida la búsqueda.
¿Hay algún costo por exportar eventos de registro a BigQuery?
Sí. Esto se debe a que Google usa la API de insertAll para ver los registros en tiempo real. Para obtener más información, consulta Precios por transferencia de datos.
No se aplican cargos por exportar informes de uso, como los de dispositivos o Meet.