Configura y administra buckets de registro

En esta página, se describe cómo crear y administrar buckets de Cloud Logging con Cloud Console y la herramienta de línea de comandos de gcloud. También puedes crear y administrar buckets con la API de Logging.

Para obtener una descripción general conceptual de los buckets, consulta Descripción general del enrutamiento y el almacenamiento: buckets de registros.

Antes de comenzar

Para comenzar a usar buckets, haz lo siguiente:

  • Asegúrate de que habilitaste la facturación para el proyecto de Google Cloud.

  • Verifica que tengas los permisos para crear y administrar tus buckets de proyectos de Cloud. Para obtener la lista de permisos y funciones que necesitas para acceder a los datos almacenados en los buckets, consulta la Guía de control de acceso.

  • Obtén información sobre los requisitos de formato LogBucket, incluidas las regiones compatibles en las que puedes almacenar tus registros.

Cree un bucket

Puedes crear un máximo de 100 buckets por proyecto de Cloud.

A fin de crear un bucket de registros definido por el usuario para tu proyecto de Cloud, sigue estos pasos:

Console

Para crear un bucket de registros en tu proyecto de Cloud, sigue estos pasos:

  1. En el menú de Logging, selecciona Almacenamiento de registros.

    Ir a Almacenamiento de registros

  2. Haz clic en Crear bucket de registros.

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

  4. Para configurar la región en la que deseas que se almacenen los registros, haz clic en el menú desplegable Seleccionar la región del bucket de registros (opcional). y selecciona una región. Si no seleccionas una región, se usa la región global, lo que significa que los registros pueden estar ubicados físicamente en cualquiera de las regiones.

  5. A fin de establecer un período de retención personalizado para los registros en el bucket, haz clic en Siguiente (opcional).

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

    También puedes actualizar tu bucket con una retención personalizada después de crearlo.

  6. Haga clic en Crear bucket. Tu bucket nuevo aparece en la lista Logs bucket.

gcloud

Para crear un bucket de registro en tu proyecto de Cloud, ejecuta el comando gcloud buckets create:

gcloud logging buckets create BUCKET_ID --location=LOCATION OPTIONAL_FLAGS

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

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

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

Después de crear un bucket, puedes configurar las vistas de registro a fin de controlar quiénes pueden acceder a los registros en tu bucket nuevo y a qué registros son accesibles.

Realiza un seguimiento de la transferencia de registros

En la página Almacenamiento de registros de Cloud Console, se realiza un seguimiento del volumen de datos de registros que transfieren los buckets de registro.

Para hacer un seguimiento de la transferencia de datos de registros de tu proyecto de Cloud, ve a la página Almacenamiento de registros en la consola:

Ir a Almacenamiento de registros

En la página Almacenamiento de registros, se muestra un resumen de las estadísticas de tu proyecto de Cloud:

El informe de estadísticas de resumen registra los importes de transferencia de datos para el proyecto seleccionado actualmente.

Se informan las siguientes estadísticas:

  • Volumen total actual: La cantidad de datos de registros que transfirió tu proyecto de Cloud desde el primer día del mes calendario actual.

  • Volumen mensual anterior: La cantidad de datos de registro que transfirió tu proyecto de Cloud en el último mes calendario.

  • Proyección de volumen por EOM: La cantidad estimada de datos de registro que tu proyecto de Cloud transferirá al final del mes calendario actual, en función del uso actual.

Las estadísticas de volumen de transferencia de registros no incluyen el bucket _Required. Los registros en ese bucket no se pueden excluir ni inhabilitar.

La página de Enrutador de registros en Cloud Console te brinda herramientas que puedes usar para minimizar los cargos por transferencia o almacenamiento de registros que excedan tu asignación mensual. Puedes realizar lo siguiente:

  • Inhabilita la transferencia de registros a nivel de bucket.
  • Excluye ciertas entradas de registro de la transferencia a Logging.

A fin de obtener más información, consulta Administra receptores.

Administra buckets

En esta sección, se describe cómo administrar tus buckets de registros con la herramienta de línea de comandos de gcloud o Google Cloud Console.

Actualizar un bucket

Para actualizar los atributos de tu bucket, completa los siguientes pasos.

Console

Para actualizar los atributos de tu depósito, completa los siguientes pasos:

  1. En el menú de Logging, selecciona Almacenamiento de registros.

    Ir a Almacenamiento de registros

  2. En el depósito 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 los atributos 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"

Bloquea un bucket

Cuando bloqueas un bucket en función de las actualizaciones, se incluye el bloqueo de la política de retención del bucket. Una vez que se bloquea una política de retención, no puedes borrar el bucket hasta que todos sus registros cumplan con el período de retención.

Para evitar que cualquier persona actualice o borre un bucket de registro, bloquea el bucket. Para bloquear el bucket, haz lo siguiente:

Console

Cloud Console no admite el bloqueo de un bucket de registros.

gcloud

Para bloquear el bucket, ejecuta el comando gcloud alpha 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

Enumerar buckets

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

Console

Ve a la página Almacenamiento de registros:

Ir a Almacenamiento de registros

Verás una tabla en buckets de registros (Logs buckets) que enumera los buckets asociados con el proyecto actual de Cloud.

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

  • Nombre: El nombre que se le asignó al bucket cuando se creó.
  • Descripción: La descripción que se le asignó al bucket cuando se creó.
  • Período de retención: Es la cantidad de días en los 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 bloqueado.

Si un bucket está pendiente de eliminación por Cloud Logging, su entrada de tabla se anota con una 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 que se le dio al bucket cuando se creó.
  • RETENTION_DAYS: La cantidad de días que Cloud Logging almacenará los datos del bucket.
  • LIFECYCLE_STATE: Indica si Cloud Logging está pendiente la eliminación del bucket.
  • LOCKED: indica si el bucket está bloqueado o bloqueado.
  • CREATE_TIME: 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 registro _Default en la región “global”, ejecuta el comando gcloud buckets describe:

gcloud logging buckets describe _Default --location=global

Ver los detalles de un bucket

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

Console

Ve a la página Almacenamiento de registros:

Ir a Almacenamiento de registros

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

El cuadro de diálogo enumera los siguientes atributos del bucket de registros:

  • Nombre: El nombre que se le asignó al bucket cuando se creó.
  • Descripción: La descripción que se le asignó al bucket cuando se creó.
  • Período de retención: Es la cantidad de días en los 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:

gcloud logging buckets describe _Default --location=global

Verás los siguientes atributos del bucket de registros:

  • createTime: Una marca de tiempo que indica cuándo se creó el bucket.
  • description: Es la descripción que se le dio al bucket cuando se creó.
  • lifecycleState: Indica si Cloud Logging está pendiente la eliminación del bucket.
  • name: Es el nombre que se le dio al bucket cuando se creó.
  • 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.

Borrar un bucket

Para borrar un bucket de registros, haz lo siguiente:

Console

Para borrar un bucket de registros, completa los siguientes pasos.

  1. En el menú de Logging, selecciona Almacenamiento de registros.

    Ir a Almacenamiento de registros

  2. En el depósito que deseas borrar, haz clic en Más .

  3. Selecciona Borrar depósito.

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

  5. En la página Almacenamiento de registros, tu depósito tiene un indicador que denota que está en estado de eliminación pendiente. El bucket, que incluye todos los registros, se borra después de 7 días.

gcloud

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

gcloud logging buckets delete BUCKET_ID --location=LOCATION

Un bucket que se borró permanece en este estado pendiente durante 7 días, y Logging continúa enrutando registros al bucket durante ese tiempo. Para detener el enrutamiento de registros a un bucket borrado, puedes borrar los receptores de registros que tienen ese bucket como destino o puedes modificar el filtro a fin de que los receptores dejen de enrutar los registros al bucket borrado.

Restablecer un bucket borrado

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

Console

Para restablecer un bucket de registros que esté en estado de eliminación pendiente, completa los siguientes pasos:

  1. En el menú de Logging, selecciona Almacenamiento de registros.

    Ir a Almacenamiento de registros

  2. En el depósito que deseas restablecer, haz clic en Más .

  3. Selecciona Restablecer el depósito borrado.

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

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

gcloud

Para restablecer un bucket de registro que esté en estado de eliminación pendiente, ejecuta el comando gcloud logging buckets undelete:

gcloud logging buckets undelete BUCKET_ID --location=LOCATION

Escribe en un bucket

No escribes registros de forma directa en un bucket de registros. En su lugar, escribes registros en el recurso de Google Cloud: un proyecto, una carpeta o una organización de Cloud. Luego, los receptores del recurso superior enrutan los registros a los destinos, incluidos los buckets de registro. Un receptor enruta los registros a un destino de bucket de registros cuando los registros coinciden con el filtro del receptor y el receptor tiene permiso para enrutar los registros al bucket de registros.

Lee desde un bucket

Cada bucket de registro tiene un conjunto de vistas de registro. A fin de leer los registros de un bucket de registros, necesitas acceso a una vista de registros en él. Para obtener más información sobre las vistas de registro, consulta Administra vistas de registro.

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

Console

Puedes definir mejor el alcance de los registros que se muestran en el visor de registros a través del panel Define mejor el permiso. Solo puedes buscar registros en el proyecto actual de Cloud o registros de búsqueda en una o más vistas de almacenamiento. Para definir mejor el alcance del explorador de registros, haz lo siguiente:

  1. En el menú de Logging, selecciona explorador de registros.

    Ir al Explorador de registros

  2. Selecciona Define mejor el permiso.

  3. En el panel Definir mejor el permiso, selecciona la opción Permiso por.

  4. Selecciona Limitar permisos por almacenamiento y elige uno o más buckets que desees ver.

    El cuadro de diálogo muestra vistas de almacenamiento que cumplen las siguientes condiciones:

    • Tienes acceso a la vista de almacenamiento.
    • Los buckets de registro pertenecen al proyecto de Cloud seleccionado o el proyecto de Cloud seleccionado ya enruta registros a los buckets de almacenamiento.

gcloud

Para leer registros de un bucket de registros, ejecuta el comando gcloud logging read:

gcloud logging read --bucket=BUCKET_ID --location=LOCATION --view=VIEW_ID

Configura la retención personalizada

Cuando creas un bucket de registros, tienes la opción de personalizar el período por el que Cloud Logging almacena los registros del bucket. Puedes configurar el período de retención para cualquier bucket de registro definido por el usuario y, también, para el bucket de registro _Default.

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

Console

Para actualizar el período de retención de un bucket de registros, completa los siguientes pasos:

  1. En el menú de Logging, selecciona Almacenamiento de registros.

    Ir a Almacenamiento de registros

  2. En el depósito que deseas actualizar, haz clic en Más .

  3. Selecciona Editar bucket.

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

  5. Haz clic en Actualizar bucket. Tu nueva duración de retención aparece en la lista bucket de registros.

gcloud

A fin de actualizar el período de retención de un bucket de registros, ejecuta el comando gcloud buckets update después de configurar un valor para RETENTION_DAYS:

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

Por ejemplo, para retener los registros en el bucket _Default en la ubicación “global” durante un año, el comando se verá 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 de ahora en adelante y no de forma retroactiva. Los registros no se pueden recuperar después de que finaliza el período de retención aplicable.

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:

  • Asegúrate de tener los permisos correctos para borrar el bucket. Para obtener la lista de los permisos que necesitas, consulta la guía de control de acceso.

  • Determina si el bucket está bloqueado mediante la enumeración de los atributos del bucket. 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 en el bucket cumplan con el período de retención del bucket.

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

Es posible que veas registros en un bucket de registros en un proyecto de Cloud centralizado, que agrega registros de toda tu organización.

Si accedes a los registros en un proyecto de Cloud centralizado y ves registros que excluiste del receptor _Default, es posible que veas los registros en una de las siguientes condiciones:

  • Visualiza los registros con el visor de registros heredado, que no admite la visualización de registros centralizados

    Para solucionar este problema, cambia al explorador de registros.

  • Visualiza los registros mediante el Explorador de registros con la opción Alcance por proyecto seleccionada en el panel Define mejor el alcance, que muestra los registros generados por el proyecto de Cloud sin importar del lugar en el que se almacenan.

    Para solucionar este problema, selecciona Limitar permisos por almacenamiento en el panel Definir mejor el permiso del Explorador de registros y, luego, selecciona el bucket _Default en tu Proyecto de Cloud. Ya no deberías ver los registros excluidos.

¿Por qué no puedo crear métricas basadas en registros para un bucket?

Las métricas basadas en registros se aplican solo a un proyecto de Google Cloud. No puedes crearlos para buckets de registros ni para otros recursos de Google Cloud, como organizaciones o carpetas.

¿Qué sigue?

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

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