Configura buckets de registros

Puedes crear, ver y administrar buckets de Cloud Logging para almacenar y centralizar tus datos de registro con la consola de Google Cloud , Google Cloud CLI o la API de Logging. También puedes configurar períodos de retención personalizados para controlar los costos de almacenamiento y el cumplimiento.

Para obtener información conceptual, consulta Almacena entradas de registro.

Antes de comenzar

Configura tu proyecto, tus roles de IAM y selecciona la interfaz que planeas usar.

Configura tu proyecto y tus roles

Para comenzar a usar buckets, haz lo siguiente:

Selecciona la interfaz que planeas usar

Consola de Google Cloud

Cuando usas la consola de Google Cloud para acceder a los servicios y las APIs de Google Cloud , no necesitas configurar la autenticación.

gcloud

Instala Google Cloud CLI y, luego, accede a gcloud CLI con tu identidad federada. Después de acceder, inicializa Google Cloud CLI con el siguiente comando: 

gcloud init

REST

Para usar las muestras de la API de REST incluidas en esta página en un entorno de desarrollo local, debes usar las credenciales que proporciones a la gcloud CLI.

    Instala Google Cloud CLI y, luego, accede a gcloud CLI con tu identidad federada.

Para obtener más información, consulta Autentícate para usar REST en la documentación de autenticación de Google Cloud .

Crea un bucket

En estas instrucciones, se supone que usas la encriptación administrada por Google. Si prefieres usar claves de encriptación administradas por el cliente (CMEK), consulta Configura CMEK para el almacenamiento de registros.

Puedes crear un máximo de 100 buckets por proyecto deGoogle Cloud . No puedes crear buckets de registros en carpetas ni organizaciones.

Para crear un bucket de registros definido por el usuario para tu proyecto de Google Cloud , haz lo siguiente:

Consola de Google Cloud

Para crear un bucket de registros en tu proyecto de Google Cloud , haz lo siguiente:

  1. En la consola de Google Cloud , ve a la página Explorador de registros:

    Ir al Almacenamiento de registros

    Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Logging.

  2. Haz clic en Crear un bucket de registros.

  3. Ingresa un Nombre y una Descripción para tu bucket.

  4. Para seleccionar la región de almacenamiento de tus registros, haz clic en el menú Seleccionar región del bucket de registros y elige una región.

  5. Opcional: Para establecer un período de retención personalizado para los registros del bucket, haz clic en Siguiente.

    En el campo Período de retención, ingresa la cantidad de días, entre 1 día y , que deseas que Cloud Logging conserve tus registros. Si no personalizas el período de retención, el valor predeterminado es 30 days.

    También puedes actualizar el período de retención de tu bucket de registros después de crearlo.

  6. Haz clic en Crear bucket.

    Es posible que estos pasos tarden un momento en completarse.

gcloud

Para crear un bucket de registros, ejecuta el comando gcloud logging buckets create:

gcloud logging buckets create BUCKET_ID --location=LOCATION

Por ejemplo, si deseas crear un bucket con el my-bucket BUCKET_ID en la región global, tu comando se vería de la siguiente manera:

gcloud logging buckets create my-bucket --location global --description "My first bucket"

REST

Para crear un bucket, usa el método projects.locations.buckets.create. Prepara los argumentos del método de la siguiente manera:

  1. Establece el parámetro parent como el recurso en el que se creará el bucket: projects/PROJECT_ID/locations/LOCATION

    La variable LOCATION hace referencia a la región en la que deseas que se almacenen tus registros.

    Por ejemplo, si deseas crear un bucket para el proyecto my-project en la región global, el parámetro parent se vería así: projects/my-project/locations/global

  2. Establece el parámetro bucketId; por ejemplo, my-bucket.

  3. Llama al método síncrono projects.locations.buckets.create para crear el bucket.

Después de crear un bucket, crea un receptor para enrutar las entradas de registro a tu bucket y configura vistas de registro para controlar quién puede acceder a los registros de tu bucket y qué registros pueden ver. También puedes actualizar el bucket para configurar la retención personalizada.

Enumera y visualiza los detalles de los buckets de registros

En esta sección, se describe cómo enumerar y ver los detalles de los buckets de registros en un proyecto, una carpeta o una organización.

Enumerar buckets

Para enumerar los buckets de registros asociados con un proyecto de Google Cloud y ver detalles como la configuración de retención, haz lo siguiente:

Consola de Google Cloud

En la consola de Google Cloud , ve a la página Explorador de registros:

Ir al Almacenamiento de registros

Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Logging.

En una tabla llamada Buckets de registros, se enumeran los buckets asociados con el proyecto de Google Cloud actual.

En la tabla, se enumeran los siguientes atributos para cada bucket de registros:

  • Nombre: Es el nombre del bucket de registros.
  • Descripción: Es la descripción del bucket.
  • Período de retención: Es la cantidad de días que Cloud Logging almacenará los datos del bucket.
  • Región: Es la ubicación geográfica en la que se almacenan los datos del bucket.
  • Estado: Indica si el bucket está bloqueado o desbloqueado.

Si un bucket está pendiente de eliminación por parte de Cloud Logging, su entrada de tabla se anotará con un símbolo de advertencia .

gcloud

Ejecuta el comando gcloud logging buckets list:

gcloud logging buckets list

Verás los siguientes atributos de los buckets de registros:

  • LOCATION: La región en la que se almacenan los datos del bucket.
  • BUCKET_ID: Es el nombre del bucket de registros.
  • RETENTION_DAYS: La cantidad de días que Cloud Logging almacenará los datos del bucket.
  • LIFECYCLE_STATE: Indica si el bucket está pendiente de borrado por parte de Cloud Logging.
  • LOCKED: Indica si el bucket está bloqueado o desbloqueado.
  • CREATE_TIME: Es una marca de tiempo que indica cuándo se creó el bucket.
  • UPDATE_TIME: Es una marca de tiempo que indica cuándo se modificó el bucket por última vez.

También puedes ver los atributos de un solo bucket. Por ejemplo, para ver los detalles del bucket de registros _Default en la región global, ejecuta el comando gcloud logging buckets describe:

gcloud logging buckets describe _Default --location=global

REST

Para enumerar los buckets de registros asociados con un proyecto de Google Cloud , usa projects.locations.buckets.list en la API de Logging.

Ver los detalles de un bucket

Los detalles de un bucket de registros incluyen el nombre, la descripción, la ubicación y el período de retención. También puedes ver información sobre cuándo se creó el bucket de registros y cuándo se actualizó por última vez.

Para ver los detalles de un solo bucket de registros, haz lo siguiente:

Consola de Google Cloud

En la consola de Google Cloud , ve a la página Explorador de registros:

Ir al Almacenamiento de registros

Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Logging.

En el bucket de registros, haz clic en Más y, luego, selecciona Ver detalles del bucket.

En el diálogo, se enumeran los siguientes atributos para el bucket de registros:

  • Nombre: Es el nombre del bucket de registros.
  • Descripción: Es la descripción del bucket de registros.
  • Período de retención: Es la cantidad de días que Cloud Logging almacenará los datos del bucket.
  • Región: Es la ubicación geográfica en la que se almacenan los datos del bucket.

gcloud

Ejecuta el comando gcloud logging buckets describe.

Por ejemplo, con el siguiente comando, se informan los detalles del bucket _Default:

gcloud logging buckets describe _Default --location=global

Verás los siguientes atributos para el bucket de registros:

  • createTime: Es una marca de tiempo que indica cuándo se creó el bucket.
  • description: Es la descripción del bucket de registros.
  • lifecycleState: Indica si el bucket está pendiente de borrado por parte de Cloud Logging.
  • name: Es el nombre del bucket de registros.
  • retentionDays: La cantidad de días que Cloud Logging almacenará los datos del bucket.
  • updateTime: Es una marca de tiempo que indica cuándo se modificó el bucket por última vez.

REST

Para ver los detalles de un solo bucket de registros, usa projects.locations.buckets.get en la API de Logging.

Administra buckets

En esta sección, se describe cómo administrar tus buckets de registros con Google Cloud CLI o la consola de Google Cloud .

Actualiza un bucket

Para actualizar las propiedades de tu bucket, como la descripción o el período de retención, haz lo siguiente:

Consola de Google Cloud

Para actualizar las propiedades de tu bucket, haz lo siguiente:

  1. En la consola de Google Cloud , ve a la página Explorador de registros:

    Ir al Almacenamiento de registros

    Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Logging.

  2. En el bucket que deseas actualizar, haz clic en Más.

  3. Selecciona Editar bucket.

  4. Edita tu bucket según sea necesario.

  5. Haz clic en Actualizar bucket.

gcloud

Para actualizar las propiedades de tu bucket, ejecuta el comando gcloud logging buckets update:

gcloud logging buckets update BUCKET_ID --location=LOCATION UPDATED_ATTRIBUTES

Por ejemplo:

gcloud logging buckets update my-bucket --location=global --description "Updated description"

REST

Para actualizar las propiedades de tu bucket, usa projects.locations.buckets.patch en la API de Logging.

Configura la retención personalizada

Cuando creas un bucket de registros, puedes personalizar el período en el que Cloud Logging almacena los registros en el bucket. También puedes configurar el período de retención para el bucket de registros _Default cuando ese bucket de registros se encuentra en un proyecto.

No puedes cambiar el período de retención del bucket de registros _Required. Tampoco puedes extender el período de retención de un bucket de registros que se encuentra en una carpeta o en una organización. Sin embargo, puedes crear un receptor de registros para enrutar las entradas de registro a nivel de carpeta o de organización a un bucket de registros que se encuentre en un proyecto y, luego, configurar el período de retención de ese bucket de registros.

Si acortas el período de retención de un bucket de registros, hay un período de gracia de 7 días en el que no se borran los registros vencidos. No puedes consultar ni ver los registros vencidos. Sin embargo, durante este período de 7 días, puedes restablecer el acceso completo extendiendo el período de retención del bucket. Los registros almacenados durante el período de gracia se tienen en cuenta para los costos de retención.

La aplicación de la retención es un proceso de coherencia eventual. Si escribes entradas de registro en un bucket de registros cuando las entradas de registro son más antiguas que el período de retención del bucket, es posible que puedas ver estas entradas de registro brevemente. Por ejemplo, si envías entradas de registro que tienen 10 días de antigüedad a un bucket de registros con un período de retención de 7 días, esas entradas de registro se almacenan y, luego, se borran definitivamente. Estas entradas de registro no contribuyen a tus costos de retención. Sí contribuyen a tus costos de almacenamiento. Para minimizar los costos de almacenamiento, no escribas entradas de registro que sean más antiguas que el período de retención de tu bucket.

Para actualizar el período de retención de un bucket de registros personalizado o del bucket de registros _Default que se encuentra en un proyecto, haz lo siguiente:

Consola de Google Cloud

Para actualizar el período de retención de un bucket de registros, haz lo siguiente:

  1. En la consola de Google Cloud , ve a la página Explorador de registros:

    Ir al Almacenamiento de registros

    Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Logging.

  2. En el bucket que deseas actualizar, haz clic en Más y, luego, selecciona Editar bucket.

  3. En el campo Retención, ingresa la cantidad de días, entre 1 día y , que deseas que Cloud Logging conserve tus registros.

  4. Haz clic en Actualizar depósito. Tu nuevo período de retención aparece en la lista Bucket de registros.

gcloud

Para actualizar el período de retención de un bucket de registros definido por el usuario o del bucket de registros _Default que se encuentra en un proyecto, ejecuta el comando gcloud logging buckets update, después de establecer un valor para RETENTION_DAYS:

gcloud logging buckets update BUCKET_ID  --location=LOCATION --retention-days=RETENTION_DAYS

Por ejemplo, para conservar los registros en el bucket _Default en la ubicación global durante un año, tu comando se vería de la siguiente manera:

gcloud logging buckets update _Default --location=global --retention-days=365

Si extiendes el período de retención de un bucket, las reglas de retención se aplican en el futuro y no de manera retroactiva. Los registros no se pueden recuperar después de que finaliza el período de retención aplicable.

Bloquea un bucket

Cuando bloqueas un bucket para que no se actualice, también bloqueas la política de retención del bucket. Después de bloquear una política de retención, no puedes borrar el bucket hasta que todas las entrada de registro que contiene hayan cumplido con el período de retención del bucket. Si deseas evitar la eliminación accidental de un proyecto que contiene un bucket de registros bloqueado, agrega una retención al proyecto. Para obtener más información, consulta Protege proyectos con retenciones.

Para evitar que alguien actualice o borre un bucket de registros, bloquéalo. Para bloquear el bucket, haz lo siguiente:

Consola de Google Cloud

La consola de Google Cloud no admite el bloqueo de un bucket de registros.

gcloud

Para bloquear el bucket, ejecuta el comando gcloud logging buckets update con la marca --locked:

gcloud logging buckets update BUCKET_ID --location=LOCATION --locked

Por ejemplo:

gcloud logging buckets update my-bucket --location=global --locked

REST

Para bloquear los atributos de tu bucket, usa projects.locations.buckets.patch en la API de Logging. Establece el parámetro locked en true.

Borrar un bucket

Puedes borrar los buckets de registros que cumplan con una de las siguientes condiciones:

  • El bucket de registros está desbloqueado.
  • El bucket de registros está bloqueado y todas las entradas de registro en el bucket de registros cumplieron con el período de retención del bucket.

No puedes borrar un bucket de registros en ninguna de las siguientes situaciones:

  • El bucket de registros está bloqueado para evitar actualizaciones y almacena entradas de registro que no cumplieron con el período de retención del bucket.

Después de emitir el comando de eliminación, el bucket de registros pasa al estado DELETE_REQUESTED y permanece en ese estado durante 7 días. Durante este período, Logging sigue enrutando los registros al bucket de registros. Puedes dejar de enrutar registros al bucket de registros borrando o modificando los receptores de registros que enrutan las entradas de registro al bucket.

No puedes crear un bucket de registros nuevo que use el mismo nombre que un bucket de registros que se encuentra en el estado DELETE_REQUESTED.

Para borrar un bucket de registros, haz lo siguiente:

Consola de Google Cloud

Para borrar un bucket de registros, haz lo siguiente:

  1. En la consola de Google Cloud , ve a la página Explorador de registros:

    Ir al Almacenamiento de registros

    Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Logging.

  2. Ubica el bucket que deseas borrar y haz clic en Más.

    1. Selecciona Borrar depósito.

    2. En el panel de confirmación, haz clic en Borrar.

    3. En la página Almacenamiento de registros, tu bucket tiene un indicador de que está pendiente de eliminación. El bucket, incluidos todos los registros que contiene, se borra después de 7 días.

    gcloud

    Para borrar un bucket de registros, ejecuta el comando gcloud logging buckets delete:

    gcloud logging buckets delete BUCKET_ID --location=LOCATION

    REST

    Para borrar un bucket, usa projects.locations.buckets.delete en la API de Logging.

    Restablece un bucket borrado

    Puedes restablecer o recuperar un bucket de registros que esté en estado de eliminación pendiente. Para restablecer un bucket de registros, haz lo siguiente:

    Consola de Google Cloud

    Para restablecer un bucket de registros que está pendiente de borrado, haz lo siguiente:

    1. En la consola de Google Cloud , ve a la página Explorador de registros:

      Ir al Almacenamiento de registros

      Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Logging.

    2. En el bucket que deseas restablecer, haz clic en Más y, luego, selecciona Restablecer bucket borrado.

    3. En el panel de confirmación, haz clic en Restablecer.

    4. En la página Almacenamiento de registros, se quita el indicador de eliminación pendiente de tu bucket de registros.

    gcloud

    Para restablecer un bucket de registros que está pendiente de borrado, ejecuta el comando gcloud logging buckets undelete:

    gcloud logging buckets undelete BUCKET_ID --location=LOCATION

    REST

    Para restablecer un bucket que está pendiente de borrado, usa projects.locations.buckets.undelete en la API de Logging.

    Lee y escribe entradas de registro

    No escribes registros directamente en un bucket de registros. En cambio, escribes registros en un recurso deGoogle Cloud : un proyecto, una carpeta o una organización de Google Cloud . Luego, los receptores del recurso superior enrutan los registros a los destinos, incluidos los buckets de registros. Un receptor enruta los registros a un destino de bucket de registros cuando estos coinciden con el filtro del receptor y este tiene permiso para enrutar los registros al bucket de registros. Para obtener más información, consulta Entradas de registro de rutas.

    Cada bucket de registros tiene un conjunto de vistas de registros. Para leer los registros de un bucket de registros, necesitas acceso a una vista de registro en el bucket de registros. Las vistas de registro te permiten otorgar a un usuario acceso solo a un subconjunto de los registros almacenados en un bucket de registros. Para obtener más información sobre las vistas de registros, consulta Almacena entradas de registro y Configura vistas de registros en un bucket de registros.

    Para leer los registros de un bucket de registros, haz lo siguiente:

    Consola de Google Cloud

    1. En la consola de Google Cloud , ve a la página Explorador de registros del :

      Ir al Explorador de registros

      Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Logging.

    2. Para personalizar qué registros se muestran en el Explorador de registros, haz clic en Define mejor el alcance y, luego, selecciona una opción. Por ejemplo, puedes ver los registros almacenados en un proyecto o por vista de registro.

    3. Haz clic en Aplicar. El panel Resultados de la consulta se vuelve a cargar con los registros que coinciden con la opción que seleccionaste.

    Para obtener más información, consulta Descripción general del Explorador de registros: Define mejor el alcance.

    gcloud

    Para leer los registros de un bucket de registros, usa el comando gcloud logging read y agrega un LOG_FILTER para seleccionar datos:

    gcloud logging read LOG_FILTER --bucket=BUCKET_ID --location=LOCATION --view=LOG_VIEW_ID

    REST

    Para leer los registros de un bucket de registros, usa el método entries.list. Configura resourceNames para especificar el bucket y la vista de registro adecuados, y configura filter para seleccionar datos.

    Para obtener información detallada sobre la sintaxis de filtrado, consulta Lenguaje de consulta de Logging.

    Soluciona los problemas comunes.

    Si tienes problemas cuando usas buckets de registros, consulta los siguientes pasos de solución de problemas y respuestas a preguntas comunes.

    ¿Por qué no puedo borrar este bucket?

    Si intentas borrar un bucket, haz lo siguiente:

    • Verifica que tengas los permisos correctos para borrar el bucket. Para obtener la lista de los permisos que necesitas, consulta Control de acceso con IAM.

    • Determina si el bucket está bloqueado enumerando sus atributos. Si el bucket está bloqueado, verifica el período de retención del bucket. No puedes borrar un bucket bloqueado hasta que todos los registros del bucket hayan cumplido con el período de retención del bucket.

    ¿Qué cuentas de servicio enrutan registros a mi bucket?

    Para determinar si alguna cuenta de servicio tiene permisos de IAM para enrutar registros a tu bucket, haz lo siguiente:

    1. En la consola de Google Cloud , ve a la página IAM:

      Ir a IAM

      Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es IAM y administrador.

    2. En la pestaña Permisos, selecciona la vista por Roles. Verás una tabla con todos los roles y las principales de IAM asociados con tu proyecto deGoogle Cloud .

    3. En el cuadro de texto Filtro de la tabla, ingresa Escritor de buckets de registros.

      Verás las principales con el rol de Escritor de buckets de registros. Si una principal es una cuenta de servicio, su ID contiene la cadena .

    4. Opcional: Si deseas quitar una cuenta de servicio para que no pueda enrutar registros a tu proyecto de Google Cloud , selecciona la casilla de verificación de la cuenta de servicio y haz clic en Quitar.

    ¿Por qué veo registros de un proyecto de Google Cloud , aunque los excluí de mi receptor de_Default?

    Es posible que estés viendo registros en un bucket de registros en un proyecto Google Cloud centralizado, que agrega registros de toda tu organización.

    Si usas el Explorador de registros para acceder a estos registros y ves los que excluiste del receptor _Default, es posible que tu vista esté configurada en el nivel de proyecto deGoogle Cloud .

    Para solucionar este problema, selecciona Vista de registro en el menú Define mejor el alcance y, luego, selecciona la vista de registro asociada con el bucket _Default en tu proyecto deGoogle Cloud . Ya no deberías ver los registros excluidos.

    ¿Qué sigue?

    Para obtener información sobre los métodos de la API del bucket de registros, consulta la documentación de referencia LogBucket.

    Si administras una organización o una carpeta, puedes especificar la ubicación de los buckets de registros _Default y _Required de los recursos secundarios. También puedes configurar si los buckets de registros usan CMEK y el comportamiento del receptor de registros _Default. Si necesitas más información, consulta Establece la configuración predeterminada para las organizaciones y carpetas.

    A fin de obtener información para abordar casos de uso comunes con los buckets de registros, consulta los siguientes temas: