Configurar exportaciones de registros de servicios a BigQuery

Ediciones compatibles con esta función: Frontline Standard, 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 (UOs) 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, que también se puede obtener 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.
  • En BigQuery Export no hay datos sobre todos los servicios. En la sección ¿Qué servicios se contemplan en BigQuery Export? que aparece más abajo 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.
  • BigQuery Export recoge los datos de Google Workspace correspondientes a los eventos del día anterior. En el resultado se muestran los datos del día anterior a la fecha de exportación.

Definir una configuración de BigQuery Export

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 editor del proyecto.
  • Añade la cuenta gapps-reports@system.gserviceaccount.com como editor. Lo necesitarás para poder escribir registros, actualizar el esquema y completar el paso 5 más adelante.

Consulta cómo hacerlo en el artículo Configurar un proyecto de BigQuery para registros de informes.

  1. Inicia sesión en la consola de administración de Google.

    Inicia sesión con una cuenta que tenga privilegios de superadministrador (y que no termine en @gmail.com).

  2. En la consola de administración, ve a Menú y luego Informesy luegoIntegraciones de datos.
  3. Coloca el cursor sobre la tarjeta BigQuery Export y haz clic en Editar .
  4. Para activar los registros de BigQuery, marca la casilla Permite habilitar la exportación de datos de Google Workspace a Google BigQuery.
  5. (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.

  6. En ID de proyecto de BigQuery, selecciona el proyecto en el que quieres almacenar los registros. Elige un proyecto en el que tengas permisos de escritura. 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.
  7. 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.
  8. 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.

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 Google 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?

De forma predeterminada, las exportaciones de los datos vencen a los 60 días. Por lo tanto, cualquier exportación de datos de BigQuery que lleves a cabo se eliminará de Google Cloud tras 60 días.
Consulta cómo actualizar el vencimiento predeterminado de las tablas para saber cómo cambiar este comportamiento.

¿Puedo cambiar un ID de proyecto de BigQuery? 

Sí, puedes cambiar el ID de proyecto de una configuración de BigQuery Export en cualquier momento. Los cambios se aplican al día siguiente, cuando los datos se copian en el nuevo proyecto de BigQuery.
Importante: No debes cambiar el proyecto de BigQuery, porque los datos anteriores no se copian en la tabla nueva. Para acceder a los datos anteriores, tienes que acceder al proyecto anterior. 

¿Qué servicios admite BigQuery Export?

Se admiten los datos de eventos de registro de los siguientes servicios:
  • Cuentas
  • Admin
  • Google Calendar
  • Chrome
  • Classroom
  • Data Studio
  • Dispositivos
  • Google Drive
  • Gmail
  • Google Chat
  • Google Meet
  • Grupos de Google
  • Inicio de sesión
  • Reglas
  • SAML
  • OAuth
Se incluyen los siguientes informes de uso:
  • Cuentas
  • App Maker
  • Google Apps Script
  • Calendario
  • Chrome OS
  • 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?  

Sí. debido a que Google utiliza la API insertAll para ver los registros en tiempo real. Consulta más información en la sección Precios de ingestión de datos.
 
No tienes que pagar por exportar informes de uso, como los de dispositivos o los de Meet.

Tema relacionado

¿Te ha resultado útil esta información?

¿Cómo podemos mejorar esta página?
Búsqueda
Borrar búsqueda
Cerrar búsqueda
Aplicaciones de Google
Menú principal