Administra depósitos de registros

Los depósitos de registros son contenedores en tus proyectos de Google Cloud que contienen los datos de registros. Puedes crear receptores de registros para enrutar todos tus registros, o solo un subconjunto de ellos, a cualquier depósito de registros. Esta flexibilidad te permite elegir en qué proyecto de Google Cloud se almacenan tus registros y qué otros registros se almacenan con ellos.

Descripción general

Para cada proyecto de Google Cloud, Logging crea de forma automática dos depósitos de registros: _Required y _Default. Todos los registros que se generan en el proyecto se almacenan en los depósitos de registros _Required y _Default, que se encuentran en el proyecto en el que se generan los registros:

  • _Required: Este depósito contiene registros de auditoría de la actividad del administrador, registros de auditoría de los eventos del sistema y registros de Transparencia de acceso, y los conserva durante 400 días. No se te cobrará por los registros almacenados en _Required. No se puede modificar el período de retención de los registros almacenados aquí. No puedes borrar este depósito.

  • _Default: Este depósito contiene todos los demás registros transferidos en un proyecto de Google Cloud, excepto los registros almacenados en el depósito _Required. Los precios estándar de Cloud Logging se aplican a estos registros. Las entradas de registro que se guardan en el depósito _Default se conservan durante 30 días, a menos que apliques reglas de retención personalizadas. No puedes borrar este depósito, pero puedes inhabilitar el receptor de registro _Default que enruta los registros a este depósito.

En estos depósitos, Logging crea receptores de registros llamados _Required y _Default de forma automática que enrutan los registros a los depósitos correspondientes.

Los depósitos de registros solo tienen disponibilidad regional, incluidos los que se crean en la región global.

Con los depósitos personalizados y el depósito _Default, puedes configurar períodos de retención personalizados para diferentes registros.

Logging también crea algunas vistas predeterminadas que se pueden usar para acceder a los registros de un depósito:

  • La vista _AllLogs está disponible en todos los depósitos y muestra todos los registros en el depósito.

  • La vista _Default solo está disponible para el depósito _Default y muestra todos los registros, excepto los registros de auditoría de acceso a los datos.

Para obtener más información sobre cómo Cloud Logging enruta y almacena tus datos de registros, consulta Descripción general del enrutador de registros. Para obtener información sobre los métodos de la API del depósito de registros, consulta la documentación de recursos LogBucket.

Limitaciones

Si bien los depósitos de registros suelen estar disponibles, algunas funciones solo están disponibles en la etapa alfa. Ten en cuenta las siguientes limitaciones:

  • Las vistas personalizadas de un depósito se encuentran en etapa Alfa en la actualidad.

  • La regionalización del depósito está actualmente disponible para un conjunto limitado de regiones en la versión Alfa.

  • Para registrarte en la versión Alfa o recibir notificaciones cuando se lance la versión Beta, completa este formulario.

Administra depósitos

Con la herramienta de línea de comandos de gcloud y Google Cloud Console, puedes crear, actualizar y borrar tus depósitos de registros personalizados.

Crea un depósito de registros

Para crear un depósito de registros personalizado en tu proyecto, completa los siguientes pasos. Puedes crear un máximo de 10 depósitos por proyecto.

GCLOUD

Para crear un depósito en tu proyecto, ejecuta el comando gcloud alpha logging buckets create:

gcloud alpha logging buckets create bucket-id --location=location optional-flags

Por ejemplo:

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

CONSOLE

Para crear un depósito en tu proyecto, completa los siguientes pasos:

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

    Ir a Almacenamiento de registros

  2. Haz clic en Crear depósito de registros.

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

  4. De manera opcional, para configurar un período de retención personalizado o una región de depósito, selecciona Siguiente.

  5. En Retención, ingresa la cantidad de días entre 1 y 3650 días, que deseas que Cloud Logging conserve tus registros.

  6. Para seleccionar la región de tu depósito, haz clic en el menú desplegable Seleccionar depósito de registros y selecciona la región en la que deseas que esté tu depósito.

  7. Haga clic en Crear depósito. Tu depósito nuevo aparece en la lista Depósito de registros.

Actualiza un depósito de registros

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

GCLOUD

Para actualizar los atributos de tu depósito, ejecuta el comando gcloud alpha logging buckets update:

gcloud alpha logging buckets update bucket-id --location=location updated-attributes

Por ejemplo:

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

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 depósito según sea necesario.

  5. Haz clic en Actualizar depósito.

Bloquea un depósito de registros

Puedes bloquear un depósito para evitar que alguien lo actualice o lo borre de inmediato. Para bloquear un depósito, completa los siguientes pasos.

GCLOUD

Para bloquear el depósito, ejecuta el comando gcloud alpha logging buckets update con la marca --locked:

gcloud alpha logging buckets update bucket-id --location=location --locked

Por ejemplo:

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

Visualiza depósitos de registros

Para enumerar los depósitos de registros asociados con un proyecto de Google Cloud, haz lo siguiente:

GCLOUD

Para enumerar los depósitos de registros de tu proyecto, ejecuta el comando gcloud alpha logging buckets list:

gcloud alpha logging buckets list

Los depósitos de registros tienen los siguientes atributos:

  • Nombre
  • Descripción
  • Período de retención de datos de registros

Ejecuta el comando gcloud alpha logging buckets describe para ver los detalles de un depósito específico. Por ejemplo, para ver los detalles del depósito de registros _Default, ejecuta el siguiente comando:

gcloud alpha logging buckets describe _Default --location=global

CONSOLE

En la página Almacenamiento de registros, se muestran los depósitos de registros de tu proyecto.

Ir a Almacenamiento de registros

Los depósitos de registros tienen los siguientes atributos:

  • Nombre
  • Descripción
  • Retención de datos de registros

Para ver los detalles de un depósito específico, haz clic en Más  y selecciona Ver detalles del depósito.

Borra un depósito de registros

Para borrar un depósito de registros, completa los siguientes pasos.

GCLOUD

Para borrar un depósito de registros, ejecuta el comando gcloud alpha logging buckets delete:

gcloud alpha logging buckets delete bucket-id --location=location

CONSOLE

Para borrar un depósito 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 depósito, que incluye todos los registros, se borra después de 7 días.

Restablece un depósito de registros que se haya borrado

Puedes restablecer o recuperar un depósito que está en estado de eliminación pendiente.

GCLOUD

Para restablecer un depósito de registros que esté en estado de eliminación pendiente, ejecuta el comando gcloud alpha logging buckets:

gcloud alpha logging buckets undelete bucket-id --location=location

CONSOLE

Para restablecer un depósito 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 depósito.

Solución de problemas y preguntas frecuentes

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

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

Si accedes a los registros en un proyecto 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 (versión clásica), que no admite la visualización de registros centralizados

  • Visualiza los registros con el visor de registros (versión preliminar) con la opción Alcance por proyecto seleccionada en el panel Define mejor el alcance, que muestra los registros generados por el proyecto sin importar del lugar donde se almacenan.

Para verificar que excluiste correctamente los registros, puedes seleccionar Limitar permisos por almacenamiento en el panel Definir mejor el permiso del visor de registros (vista previa) y seleccionar el depósito _Default en tu proyecto. Ya no deberías ver los registros excluidos.

¿Qué sigue?

A fin de obtener información para abordar casos de uso comunes con los depósitos de registros, consulta la siguiente documentación: