Ediciones compatibles con esta función: Frontline Standard y Frontline Plus, Enterprise Standard y Enterprise Plus, Education Standard y Education Plus y Enterprise Essentials Plus. Comparar ediciones
Para exportar eventos de registro de actividad (acciones individuales realizadas por un usuario) e informes de uso (informes globales de una aplicación) a Google BigQuery, debes configurar BigQuery Export en la consola de administración de Google.
Acerca de los datos de BigQuery y de la API Reports
Los datos disponibles en el conjunto de datos de BigQuery son diferentes de los datos obtenidos con la API Reports. Los datos de BigQuery solo incluyen el conjunto de datos sin filtrar. Aunque puedes filtrar los datos mediante SQL, este método no admite todos los parámetros que se pueden utilizar en la API Reports.
Puedes filtrar los datos que obtienes con la API Reports si incluyes parámetros en la solicitud a la API.
Ejemplo: hay dos unidades organizativas en un mismo dominio, A y B. Usando la API Reports y BigQuery, puedes acceder a todos los eventos del dominio completo (incluidas las UOs A y B).
- Con la API Reports puedes obtener los eventos de la UO A si añades el parámetro orgUnitID en la solicitud a la API.
- Con SQL y BigQuery no puedes filtrar eventos por unidad organizativa porque no hay ninguna columna correspondiente al parámetro orgUnitID.
Importante:
- Los datos de BigQuery incluyen el historial de datos (180 días para los datos de actividad y 450 días para los datos de uso). También puedes obtener el historial de datos con la API Reports.
- Si desactivas la exportación de datos de Google Workspace a BigQuery, no se añadirán datos nuevos en BigQuery Export. No obstante, los datos existentes seguirán disponibles en otras fuentes, como la API Reports.
-
Las tablas de BigQuery tienen particiones a nivel de día en la pseudocolumna (_PARTITIONTIME). Estas particiones se derivan de la columna time_usec de las tablas de actividad y de la columna date de las tablas de uso. En concreto, Workspace anula los límites predeterminados de UTC de BigQuery para alinear las particiones con la hora del Pacífico. Para optimizar el coste de las consultas de BigQuery, Google recomienda filtrar por _PARTITIONTIME junto con time_usec o date.
-
En BigQuery Export no hay datos sobre todos los servicios. En la sección ¿Qué servicios se contemplan en BigQuery Export? de esta página puedes consultar la lista completa.
- Puedes encontrar ejemplos de consultas en el artículo Ejemplos de consultas de registros de informes en BigQuery.
Cómo se propagan y conservan los datos
- Las políticas pueden tardar una hora en propagarse. Una vez propagadas, se crean tablas diarias en tu conjunto de datos (zona horaria del Pacífico).
- Los datos se guardan siguiendo las directrices de otros registros e informes. Consulta más información en el artículo Plazos de conservación y periodos de retraso de los datos.
- Las tablas de datos no se eliminan automáticamente. Para eliminar un proyecto activo, consulta el artículo Eliminar una configuración de BigQuery Export.
-
Los eventos de 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, lo habitual es que se retrasen entre 1 y 3 días.
Antes de empezar
Importante: Si usas la política de organización Compartir con dominio restringido en Google Cloud, asegúrate de añadir el ID de cliente de Google C02h8e9nw a la lista de permitidos.
Primero debes configurar un proyecto de BigQuery en la consola de Google Cloud. Cuando crees el proyecto, haz lo siguiente:
- Añade una cuenta de administrador de Google Workspace como:
- Administrador de BigQuery (roles/bigquery.admin) o un rol de gestión de identidades y accesos equivalente
- Administrador de gestión de identidades y accesos de proyectos (roles/resourcemanager.projectIamAdmin)
- Añade la cuenta de servicio gapps-reports@system.gserviceaccount.com como editor del proyecto (o con un rol de editor de gestión de identidades y accesos equivalente). Lo necesitarás para poder escribir registros, actualizar el esquema y completar el paso 6 más adelante.
Consulta cómo hacerlo en el artículo Configurar un proyecto de BigQuery para registros de informes.
Paso 1: Definir una configuración de BigQuery Export
-
Inicia sesión con una cuenta de super administrador en Consola de administración de Google.
Si no usas una cuenta de superadministrador, no podrás completar estos pasos.
-
Los administradores de Education deben ir a Menú
Informes
Exportación a BigQuery para abrir la página Integraciones de datos.
- Coloca el cursor sobre la tarjeta BigQuery Export y haz clic en Editar
.
- Para activar los registros de BigQuery, marca la casilla Permite habilitar la exportación de datos de Google Workspace a Google BigQuery.
-
(Opcional) Para exportar parámetros sensibles de reglas de DLP, marca la casilla Permitir la exportación de contenido sensible de los registros de reglas de DLP . Para obtener más información, consulta el artículo Ver contenido que activa reglas de DLP.
- En ID de proyecto de BigQuery, selecciona el proyecto en el que quieres almacenar los registros. Elige un proyecto en el que gapps-reports@system.gserviceaccount.com tenga el rol Editor o un rol de editor de gestión de identidades y accesos equivalente. Si no ves el proyecto que te interesa, debes configurarlo en BigQuery. Para obtener más información, consulta la guía de inicio rápido para usar la consola de Google Cloud.
- En Nuevo conjunto de datos en el proyecto, introduce el nombre del conjunto de datos que quieres usar para almacenar los registros en el proyecto. Los nombres de los conjuntos de datos deben ser únicos en cada proyecto. Para obtener más información, consulta la guía sobre cómo crear conjuntos de datos.
- (Opcional) Marca la casilla Restringir el conjunto de datos a una ubicación geográfica específica
Para obtener más información, consulta Multirregión. - Haz clic en Guardar.
Nota: Si no puedes guardar el proyecto, abre la consola de Google Cloud, elimina el nuevo conjunto de datos y vuelve a guardarlo en la consola de administración.
El conjunto de datos se crea el día siguiente de activarse la exportación. Además de los propietarios del proyecto y los usuarios con permiso de edición o de lectura, se añade como editor la cuenta de servicio gapps-reports@system.gserviceaccount.com , que es necesaria para escribir registros y actualizar el esquema.
Paso 2: Cambiar el conjunto de datos de BigQuery Export y reponer el nuevo conjunto de datos (opcional)
Puedes cambiar la configuración de BigQuery Export para empezar a exportar datos a un conjunto de datos diferente al actual. También puedes transferir los datos del conjunto de datos anterior al que acabas de seleccionar (180 días para la auditoría y 450 días para el uso). Por ejemplo, puedes cambiar la ubicación de EE. UU. a la UE para el conjunto de datos de BigQuery Export. La reposición 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 la reposición, BigQuery creará un conjunto de datos en la ubicación especificada.
Cuestiones importantes
- Los datos existentes se exportan a un nuevo conjunto de datos si seleccionas una nueva ubicación, cambias el ID del proyecto o el ID del conjunto de datos.
- Los datos exportados también se conservan en el conjunto de datos anterior.
- Todos los datos nuevos, junto con los datos repuestos, se almacenan en el nuevo conjunto de datos.
- Los datos (180 días para la auditoría y 450 días para el uso) se exportan al nuevo conjunto de datos, pero no se eliminan de la ubicación actual, por lo que tendrás conjuntos de datos de BigQuery Export en dos ubicaciones.
Para reponer los datos en la nueva ubicación:
-
Inicia sesión con una cuenta de super administrador en Consola de administración de Google.
Si no usas una cuenta de superadministrador, no podrás completar estos pasos.
-
Los administradores de Education deben ir a Menú
- Introduce el nuevo nombre del conjunto de datos.
- Si quieres reponer los datos en la nueva ubicación, marca la casilla Reponer los datos de BigQuery de los últimos 180 días en el nuevo conjunto de datos.
- Haz clic en Confirmar
Requisitos de exportación de datos de registro
Los datos de los registros se exportan mediante la API insertAll, para lo que debes tener habilitada la facturación en tu proyecto de BigQuery Export. Si la facturación no está habilitada, el proyecto estará en el modo de entorno aislado y los datos de registro no se exportarán a tu conjunto de datos. Consulta más información en la sección Limitaciones.
Nota: Las exportaciones de los informes de uso siguen habilitadas en los proyectos en modo de entorno aislado.
Periodos de retraso
En la mayoría de los casos, después de activar la exportación de datos a BigQuery, los eventos de 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, lo habitual es que se retrasen entre 1 y 3 días. Consulta más información en el artículo Plazos de conservación y periodos de retraso de los datos.
Preguntas frecuentes
¿Cómo configuro el vencimiento de los datos de mis exportaciones?
¿Puedo cambiar un ID de proyecto de BigQuery?
¿Qué servicios admite BigQuery Export?
- Cuentas
- Admin
- Google Calendar
- Chrome
- Classroom
- Migración de datos
- Dispositivos
- Google Drive
- Gemini para Workspace
- Gmail
- Google Chat
- Google Meet
- Hardware de Google Meet
- Grupos de Google
- Inicio de sesión
- Looker Studio
- Reglas
- SAML
- OAuth
- Cuentas
- Google Apps Script
- Google AppSheet
- Calendar
- ChromeOS
- Classroom
- Dispositivos
- Documentos de Google
- Drive
- Gmail
- Búsqueda de Google
- Meet
- Google Sites
- Google Voice
Nota: Tenemos previsto incluir más eventos de registro en el futuro, incluidos registros de la Búsqueda.
¿Hay que pagar por exportar eventos de registro a BigQuery?
No tienes que pagar por exportar informes de uso, como los de dispositivos o los de Meet.
