Configura exportaciones de registros del servicio a BigQuery

Ediciones compatibles con esta función: Frontline Standard y Frontline Plus; Enterprise Standard y Enterprise Plus; Education Standard y Education Plus; Enterprise Essentials Plus. Comparar tu edición

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 configurar BigQuery Export en la Consola del administrador de Google.

Acerca de los datos de la API de BigQuery y de Reports

Los datos disponibles en el conjunto de datos de BigQuery difieren de los datos recuperados de la API de Reports. 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 Informes si incluyes parámetros en la solicitud a la API.

Ejemplo: Dos unidades organizativas están 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 organizacional porque 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 Reports.
• 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 a nivel del día en la pseudocolumna (_PARTITIONTIME). Estas particiones se derivan de la columna time_usec para las tablas de Activity y de la columna date para las tablas de Usage. En particular, Workspace anula los límites predeterminados de UTC 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 servicios 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. Luego, se crearán 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, consulta 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 una demora 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 uso compartido restringido al 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 una de las siguientes opciones:
  • Administrador de BigQuery (roles/bigquery.admin) o un rol equivalente de Identity and Access Management (IAM)
  • 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). La necesitas para escribir registros, actualizar el esquema y completar el paso 5 más adelante.

Si deseas obtener instrucciones, consulta Configura un proyecto de BigQuery para generar registros de informes.

Paso 1: Configura BigQuery Export

1. En la consola del administrador de Google, ve a Menú Informes Integraciones de datos (o Exportación a BigQuery para los administradores de instituciones educativas, que abre la página Integraciones de datos).

   Ir a Integraciones de datos

   Es necesario tener el privilegio de administrador de Informes.

2. Selecciona la tarjeta BigQuery Export y haz clic en Editar .
3. Para activar los registros de BigQuery, marca la casilla Habilita la exportación de datos de Google Workspace a Google BigQuery.
4. (Opcional) Para exportar parámetros sensibles de las reglas de DLP, marca la casilla Permitir la exportación de contenido sensible desde los registros de reglas de DLP. Para obtener más información, consulta Visualiza el contenido que activa las reglas de la DLP.
5. 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 IAM equivalente. Si no ves el proyecto, tendrás que configurarlo en BigQuery. Para obtener más información, consulta la guía de inicio rápido sobre el uso de la consola de Google Cloud.
6. 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 únicos para cada proyecto. Para obtener más información, consulta Crea conjuntos de datos.
7. (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 Multi-regions.
8. 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 los datos en 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 transferir 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 de tu 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 el reabastecimiento, BigQuery creará un conjunto de datos nuevo en la ubicación especificada.

Consideraciones

• Los datos existentes se exportan a un nuevo conjunto de datos si seleccionas una nueva ubicación, 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.
• Todos los datos nuevos, junto con los datos reabastecidos, se almacenan en el nuevo conjunto de datos.
• Los datos existentes (180 días para la auditoría y 450 días para el uso) se exportan al nuevo conjunto de datos, 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 nueva ubicación, sigue estos pasos:

1. En la consola del administrador de Google, ve a Menú Informes Integraciones de datos (o Exportación a BigQuery para los administradores de instituciones educativas, que abre la página Integraciones de datos).

   Ir a Integraciones de datos

   Es necesario tener el privilegio de administrador de Informes.

2. Ingresa el nombre del nuevo conjunto de datos.
3. Si deseas reabastecer los datos existentes en la nueva ubicación, marca la casilla Reabastece los datos existentes de BigQuery de los últimos 180 días en el conjunto de datos nuevo.
4. Haz clic en Confirmar Guardar.

Requisitos para la exportación de datos de registro

Los datos de registro se exportan a través de la API de insertAll, que requiere que tengas habilitada la facturación para tu proyecto de exportación de BigQuery. Si la facturación no está habilitada, 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 que activas 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 una demora de 48 horas en la configuración inicial, pero, después, 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

Tema relacionado

Documentación de BigQuery