En esta página, se describe cómo configurar y ver Cloud Logging para los registros del Servicio de transferencia de almacenamiento.
Cloud Logging para el Servicio de transferencia de almacenamiento es compatible con todas las transferencias. Las operaciones FIND no se registran para las transferencias basadas en agentes.
Las transferencias del sistema de archivos también pueden configurar registros de transferencia del sistema de archivos.
Antes de comenzar
Antes de comenzar, verifica que tengas acceso a Cloud Logging. Recomendamos el rol Visualizador de registros (roles/logging.viewer) de Identity and Access Management. Para obtener más información sobre el acceso de Logging, consulta Control de acceso con IAM.
A continuación, se describe cómo verificar y otorgar el acceso a IAM:
- Visualiza el acceso actual para verificar el acceso que tiene cada principal.
- Otorga una función a los principales relevantes de tu proyecto.
Acciones que se pueden registrar
Se pueden registrar las siguientes acciones:
FIND: Buscar trabajo para hacer, como enumerar archivos en un directorio, enumerar objetos en un bucket o enumerar carpetas administradas en un bucket. No admitido para transferencias basadas en agentes.COPY: Copiar archivos o objetos a Cloud Storage.DELETE: Borrar archivos o objetos en la fuente o el destino. Para las transferencias entre dos sistemas de archivos, también se registra el borrado de archivos del bucket de Cloud Storage intermedio.
Estados que se pueden registrar
Para cada acción, puedes elegir registrar uno o más de los siguientes estados:
SUCCEEDED: La acción se realizó correctamente.FAILED: No se pudo realizar la acción.SKIPPED: Solo se aplica a la acción COPY y solo se admite para trabajos de transferencia basados en agentes. Se debe configurar congcloudo la API de REST. Este estado significa que se omitió la copia. Esto ocurre cuando el archivo ya existe en el receptor y tu trabajo de transferencia está configurado para ignorar los archivos existentes.
Habilitar registro
Para habilitar el registro, especifica las acciones y los estados que se registrarán.
gcloud CLI
Cuando crees un trabajo de transferencia con gcloud transfer jobs create, usa las siguientes marcas para habilitar el registro:
gcloud transfer jobs create SOURCE DESTINATION \
--log-actions=copy,delete,find \
--log-action-states=succeeded,failed,skipped
Debes especificar al menos un valor para cada marca.
REST
Para crear una configuración de registro, usa
transferJobs.create con un
LoggingConfig:
{
"name":"transferJobs/myFirstTransfer",
"status": "ENABLED",
"projectId": "test-id-001",
"loggingConfig": {
"logActions": ["FIND", "DELETE", "COPY"],
"logActionStates": ["SUCCEEDED", "FAILED", "SKIPPED"], #SKIPPED is only supported for agent-based transfers
},
"transferSpec": {
"awsS3DataSource": {
"bucketName": "AWS_SOURCE_NAME",
"awsAccessKey": {
"accessKeyId": "AWS_ACCESS_KEY_ID",