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 y asígnale el rol Administrador de BigQuery (bigquery.admin). Para obtener más información, consulta el artículo sobre los roles y permisos de gestión de identidades y accesos de BigQuery.
• Añade la cuenta [email protected] y asígnale el rol Editor de datos de BigQuery. Para obtener más información, consulta el artículo sobre los roles y permisos de gestión de identidades y accesos de BigQuery. Lo necesitarás para poder escribir registros, actualizar el esquema y completar el paso 6.

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ú  InformesIntegraciones de datos.

   Education administrators go to Menu ReportingBigQuery export, which opens the Data integrations page.

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.

Una vez que se ha configurado la exportación, el nuevo conjunto de datos se crea la primera vez que se activa la exportación.

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

Tema relacionado