Configura y administra depósitos de registro

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

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

Antes de comenzar

Para comenzar a usar buckets, haz lo siguiente:

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

• Verifica si tienes los permisos para crear y administrar los depósitos de proyectos de Cloud. Para ver la lista de los permisos y las funciones que necesitas para acceder a los datos almacenados en depósitos, consulta la Guía de control de acceso.

• Comprende los requisitos de formato de 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 registro definido por el usuario para tu proyecto de Cloud, completa los siguientes pasos:

Console

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

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 ubicarse físicamente en cualquiera de las regiones.

   Nota: Después de crear tu bucket de registro, no puedes cambiar la región del bucket. Si necesitas un bucket en una región diferente, debes crear un bucket nuevo en esa región, redireccionar los receptores adecuados al bucket nuevo y, luego, borrar el bucket anterior.

5. Si deseas 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 registros en tu proyecto de Cloud, ejecuta el comando gcloud buckets create:

gcloud logging buckets create BUCKET_ID --location=LOCATION OPTIONAL_FLAGS

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 con el BUCKET_ID my-bucket en la región asia-east2, el comando debería ser similar al siguiente:

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

Nota: Después de crear tu bucket de registro, no puedes cambiar la región del bucket. Si necesitas un bucket en una región diferente, debes crear un bucket nuevo en esa región, redireccionar los receptores adecuados al bucket nuevo y, luego, borrar el bucket anterior.

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 realizar un seguimiento de la transferencia de datos de registro 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:

Se informan las siguientes estadísticas:

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

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

• Volumen proyectado 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 Enrutador de registros en Cloud Console te brinda herramientas que puedes usar para minimizar los cargos por la transferencia o el 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.

Para obtener más información, consulta Manage sinks.

Administra buckets

En esta sección, se describe cómo administrar tus depósitos de registros mediante 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 depósito.

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

Advertencia: El bloqueo de un bucket de registros es irreversible.

Cuando bloqueas un bucket en contra de actualizaciones, 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 cada registro en el bucket cumpla el período de retención.

Para evitar que alguien 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 da al bucket cuando se creó.
• Descripción: La descripción que se le dio 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: Si el bucket está bloqueado o no 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: El nombre que se le dio al depósito cuando se creó.
• RETENTION_DAYS: La cantidad de días que Cloud Logging almacenará los datos del bucket.
• LIFECYCLE_STATE: Indica si Cloud Logging tiene pendiente la eliminación del bucket.
• LOCKED: Si el bucket está bloqueado o desbloqueado.
• CREATE_TIME: Una marca de tiempo que indica cuándo se creó el bucket.
• UPDATE_TIME: 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 buckets describe:

gcloud logging buckets describe _Default --location=global

Ver los detalles de un bucket

Para ver los detalles de un solo bucket de registros, 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 para el bucket de registros:

• Nombre: El nombre que se le da al bucket cuando se creó.
• Descripción: La descripción que se le dio 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 buckets describe:

gcloud logging buckets describe _Default --location=global

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

• createTime: Una marca de tiempo que indica cuándo se creó el bucket.
• description: Es la descripción que se proporcionó al bucket cuando se creó.
• lifecycleState: Indica si Cloud Logging tiene pendiente la eliminación del bucket.
• name: El nombre que se le dio al depósito cuando se creó.
• retentionDays: La cantidad de días que Cloud Logging almacenará los datos del bucket.
• updateTime: 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.

Nota: Los buckets que están pendientes de eliminación se tienen en cuenta en la cuota de buckets por proyecto de Cloud hasta que se borren por completo.

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:

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 registros que esté en estado de eliminación pendiente, ejecuta el comando gcloud logging buckets undelete:

gcloud logging buckets undelete BUCKET_ID --location=LOCATION

Escribir en un bucket

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

Leer desde un bucket

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

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

Console

Puedes definir mejor el alcance de los registros que se muestran en el Explorador de registros mediante la opción Define mejor el permiso. Solo puedes buscar registros dentro del proyecto de Cloud actual 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 los registros desde 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

Nota: A partir del 1 de abril de 2022, los costos de almacenamiento se aplicarán a los datos de registros retenidos durante más de 30 días. Para obtener más información, consulta el resumen de precios de Cloud Logging. Actualmente, no se aplican cargos por retener registros durante más de 30 días.

Cuando creas un depósito de registro, tienes la opción de personalizar el período durante el cual Cloud Logging almacena los registros del depósito. Puedes configurar el período de retención de 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 registros, 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 registro, 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 conservar los registros en el bucket _Default en la ubicación “global” durante un año, tu comando debería verse de la siguiente manera:

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

Si extiendes el período de retención de un depósito, las reglas de retención se aplican en el futuro 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 que tienes 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 su período de retención. No puedes borrar un bucket bloqueado hasta que todos los registros del bucket cumplan con el período de retención.

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

Puede que veas registros en un bucket de registros en un proyecto centralizado de Cloud, que agrega registros de toda la 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 uso del 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 en la nube. 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 depósitos 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:

• Agregar los registros de tu organización a un bucket de registros central

• Configura el registro de multiusuario para clústeres de Google Kubernetes Engine (GKE).

• Regionalizar los registros de tu proyecto con buckets de registros