Es posible que parte de la información de esta página (o toda) no se aplique a Cloud de Confiance de S3NS. Consulta Diferencias con Google Cloud para obtener más información.

Google utiliza tecnología de IA para traducir contenido a tu idioma preferido. Las traducciones realizadas con IA pueden contener errores.

Cloud Logging para operaciones por lotes de almacenamiento

Puedes configurar y ver los registros de las operaciones por lotes de almacenamiento en Cloud Logging para supervisar el progreso de los trabajos, filtrar los eventos de transformación y solucionar problemas de operaciones de objetos con errores. Cuando se habilita, este registro genera una entrada para cada objeto que un trabajo por lotes intenta transformar.

Aunque las operaciones por lotes de almacenamiento también envían registros a los Registros de auditoría de Cloud, te recomendamos que uses Cloud Logging para el análisis de registros centralizado y la supervisión en tiempo real.

Antes de comenzar

Verifica que tengas acceso a Cloud Logging. Para usar Cloud Logging, te recomendamos que otorgues el rol de Identity and Access Management de Logs Viewer (roles/logging.viewer). El rol de Identity and Access Management de Logs Viewer (roles/logging.viewer) proporciona los permisos de Identity and Access Management necesarios para ver tus datos de Cloud Logging. Para obtener más información sobre los permisos de acceso de Logging, consulta Control de acceso con IAM.

Para verificar y otorgar los permisos de IAM, completa los siguientes pasos:

Visualiza el acceso actual para verificar el acceso que tiene cada principal.
Otorga una función a los principales relevantes de tu proyecto.

Comprende los detalles del registro

Cuando el registro está habilitado, las operaciones por lotes de almacenamiento capturan los siguientes detalles:

Acción registrable: El valor de la acción registrable siempre es transform.
Estados registrables: Para cada acción, puedes elegir registrar uno o ambos de los siguientes estados:
- SUCCEEDED: La acción se realizó correctamente.
- FAILED: No se pudo realizar la acción.

Habilitar registro

Para habilitar el registro, especifica las acciones y los estados que se registrarán.

Línea de comandos

Cuando crees un trabajo de operaciones por lotes de almacenamiento con gcloud storage batch-operations jobs create, usa las marcas --log-actions y --log-action-states para habilitar el registro.

gcloud storage batch-operations jobs create JOB_NAME \
  --manifest-location=MANIFEST_LOCATION \
  --delete-object \
  --log-actions=transform \
  --log-action-states=LOG_ACTION_STATES

Aquí:

JOB_NAME es el nombre que quieres asignar a tu trabajo. Por ejemplo, my-job
MANIFEST_LOCATION es la ubicación de tu manifiesto. Por ejemplo, gs://my-bucket/manifest.csv
LOG_ACTION_STATES es una lista separada por comas de los estados que se registrarán. Por ejemplo, succeeded,failed

API de REST

Crea un trabajo de operaciones por lotes de almacenamiento con un LoggingConfig.

{
   "loggingConfig": {
      "logActions": ["TRANSFORM"],
      "logActionStates": ["LOG_ACTION_STATES"],
        }
}

Aquí:

LOG_ACTION_STATES es una lista separada por comas de los estados que se registrarán. Por ejemplo, "SUCCEEDED","FAILED"

Ver registros

Para ver los registros de las operaciones por lotes en objetos almacenados, haz lo siguiente:

Console

Ve al menú de navegación de Cloud de Confiance y selecciona Logging > Explorador de registros :<br\></br\>

Ir al Explorador de registros.
Selecciona un Cloud de Confiance proyecto.
En el menú Actualizar (Upgrade), cambia del Visor de registros heredados a Explorador de registros.
Para filtrar tus registros de modo que solo muestren las entradas de operaciones por lote en objetos almacenados, escribe storage_batch_operations_job en el campo de consulta y haz clic en Ejecutar consulta.
En el panel Resultados de la consulta, haz clic en Editar hora para cambiar el período de los resultados mostrados.

Para obtener más información sobre el uso del Explorador de registros, consulta Usa el Explorador de registros.

Línea de comandos

Para usar gcloud CLI y buscar registros de operaciones por lotes de almacenamiento, usa el comando gcloud logging read.

Especifica un filtro para limitar tus resultados a los registros de operaciones por lotes de almacenamiento.

gcloud logging read "resource.type=storage_batch_operations_job"

API de REST

Usa el método de la API de Cloud Logging entries.list.

Para filtrar tus resultados y que solo se incluyan las entradas relacionadas con las operaciones por lotes en objetos almacenados, usa el campo filter. A continuación, se muestra un objeto de solicitud JSON de ejemplo:

{
"resourceNames":
  [
    "projects/MY_PROJECT_NAME"
  ],
  "orderBy": "timestamp desc",
  "filter": "resource.type=\"storage_batch_operations_job\""
}

Aquí:

MY_PROJECT_NAME es el nombre de tu proyecto.

Formato de registro de operaciones por lotes de almacenamiento

Todos los campos específicos de las operaciones por lotes de almacenamiento se encuentran dentro de un objeto jsonPayload. Si bien el contenido exacto de jsonPayload varía según el tipo de trabajo, existe una estructura común que se comparte en todas las entradas de TransformActivityLog. En esta sección, se describen los campos de registro comunes y, luego, se detallan los campos específicos de la operación.

Campos de registro comunes

Los siguientes campos aparecen en todos los registros:

jsonPayload: {
"@type": "type.googleapis.com/google.cloud.storagebatchoperations.logging.TransformActivityLog",
"completeTime": "YYYY-MM-DDTHH:MM:SS.SSSSSSSSSZ",
"status": {
  "errorMessage": "String indicating error",
  "errorType": "ENUM_VALUE",
  "statusCode": "ENUM_VALUE"
},
"logName": "projects/PROJECT_ID/logs/storagebatchoperations.googleapis.com%2Ftransform_activity",
"receiveTimestamp": "YYYY-MM-DDTHH:MM:SS.SSSSSSSSSZ",
"resource": {
  "labels": {
    "location":"us-central1",
    "job_id": "BATCH_JOB_ID",
    "resource_container": "RESOURCE_CONTAINER",
    // ... other labels
  },
  "type": "storagebatchoperations.googleapis.com/Job"
},
// Operation-specific details will be nested here (for example,
// "DeleteObject", "PutObjectHold", "RewriteObject", "PutMetadata")
// Each operation-specific object will also contain the following
// object: "objectMetadataBefore": {
//   "gcsObject": {
//     "bucket": "BUCKET_NAME",
//     "generation": "GENERATION_NUMBER",
//     "objectKey": "OBJECT_PATH"
//   }
// }
}

En la siguiente tabla, se describe cada uno de los campos de registro comunes:

Campos de registro comunes	Tipo	Descripción
`@type`	String	Especifica el tipo de carga útil de la entrada de registro y, además, indica que el registro representa un `TransformActivityLog` para las operaciones por lotes en objetos almacenados.
`completeTime`	Marca de tiempo	La marca de tiempo compatible con ISO 8601 en la que se completó la operación.
`status`	Objeto	Proporciona información sobre el resultado de la actividad de la operación por lotes.
`status.errorMessage`	String	Un mensaje de error si la operación falla El mensaje de error aparece solo si el valor de `status.statusCode` no es `OK`.
`status.errorType`	String	Es el tipo de error. El tipo de error solo aparece si el valor de `status.statusCode` no es `OK`.
`status.statusCode`	String	Es el código de estado de la operación. La operación se realiza correctamente si el valor es `OK`; cualquier otro valor indica un error.
`logName`	String	Es el nombre completo del recurso del registro, que indica el proyecto y la transmisión de registros.
`receiveTimestamp`	Marca de tiempo	Es la marca de tiempo en la que el sistema de registro recibió la entrada de registro.
`resource`	Objeto	Información sobre el recurso que generó la entrada de registro.
`resource.labels`	Objeto	Son pares clave-valor que proporcionan información de identificación adicional sobre el recurso.
`resource.type`	String	Es el tipo de recurso que generó el registro.
`objectMetadataBefore`	Objeto	Contiene metadatos del objeto antes de que se intentara realizar la operación por lotes.
`objectMetadataBefore.gcsObject`	Objeto	Son los detalles sobre el objeto.
`objectMetadataBefore.gcsObject.bucket`	String	Es el nombre del bucket en el que reside el objeto.
`objectMetadataBefore.gcsObject.generation`	String	Es el número de generación del objeto antes de la operación.
`objectMetadataBefore.gcsObject.objectKey`	String	Es la ruta de acceso completa del objeto dentro del bucket.

Contenido de jsonPayload específico de la operación

La diferencia entre las entradas de registro para las distintas operaciones por lotes radica en el objeto de nivel superior anidado en jsonPayload. Solo uno de los siguientes objetos está disponible en una entrada de registro determinada, que corresponde a la operación por lotes específica que se realizó:

Borrar objeto (DeleteObject)

jsonPayload:
{
"DeleteObject": {
  "objectMetadataBefore": {
    "gcsObject": {
      "bucket": "test-bucket",
      "generation": "1678912345678901",
      "objectKey": "test_object.txt"
    }
  }
  }
}

Put object hold (PutObjectHold)

jsonPayload:
{
"PutObjectHold": {
  "objectMetadataBefore": {
    "gcsObject": {
      "bucket": "test-bucket",
      "generation": "1678912345678901",
      "objectKey": "test_object.txt"
    }
  },
  "temporaryHoldAfter": True,
  "eventBasedHoldAfter": True
}
}

Reescribe un objeto (RewriteObject)

jsonPayload:
{
"RewriteObject": {
  "objectMetadataBefore": {
    "gcsObject": {
      "bucket": "test-bucket",
      "generation": "1678912345678901",
      "objectKey": "test_object.txt"
    }
  },
  "kmsKeyVersionAfter": "projects/my-gcp-project/locations/us-central1/keyRings/my-keyring-01/cryptoKeys/my-encryption-key/cryptoKeyVersions/1"
}
}

Coloca metadatos (PutMetadata)

jsonPayload:
{
"PutMetadata": {
  "objectMetadataBefore": {
    "gcsObject": {
      "bucket": "test-bucket",
      "generation": "1678912345678901",
      "objectKey": "test_object.txt"
    }
  },
  "content_disposition_after": "attachment; filename=\"report_final.pdf\"",
  "content_encoding_after": "gzip",
  "content_language_after": "en-US",
  "content_type_after": "application/pdf",
  "cache_control_after": "public, max-age=3600",
  "custom_time_after": "2025-06-27T10:00:00Z",
  "custom_metadata_after": {
    "project": "marketing",
    "version": "2.0",
    "approvedBy": "Admin"
  }
}
}

En la siguiente tabla, se describen los campos de registro específicos de la operación:

Campos de registro específicos de la operación	Tipo	Descripción
`PutObjectHold`	Objeto	Indica una operación de conservación en un objeto.
`PutObjectHold.temporaryHoldAfter`	Booleano	Si el valor es `True`, indica que se aplicó una conservación temporal al objeto después de que se completó el trabajo de operaciones por lote en objetos almacenados. Los valores válidos son `True` o `False`.
`PutObjectHold.eventBasedHoldAfter`	Booleano	Si el valor es `True`, indica que se aplicó una conservación basada en eventos al objeto después de que se completó el trabajo de operaciones por lotes en objetos almacenados. Los valores válidos son `True` o `False`.
`RewriteObject`	Objeto	Indica una operación de reescritura en un objeto.
`RewriteObject.kmsKeyVersionAfter`	String	Es la versión de la clave de Cloud Key Management Service que se usa después del trabajo de reescritura. El campo `kmsKeyVersionAfter` se completa si la clave de encriptación del objeto cambió como resultado de la reescritura. Es un campo opcional, lo que significa que podría no estar presente si la versión de la clave de Cloud KMS no cambió después de la reescritura.
`PutMetadata`	Objeto	Indica una operación de actualización de metadatos en un objeto.
`PutMetadata.content_disposition_after`	String	Especifica el valor del encabezado `Content-Disposition` después de que se completa el trabajo `PutMetadata`. Es un campo opcional y solo se propaga si se estableció o modificó la disposición del contenido.
`PutMetadata.content_encoding_after`	String	Especifica el valor del encabezado `Content-Encoding` después de que se completa el trabajo `PutMetadata`. Es un campo opcional y solo se completa si se configuró o modificó la codificación del contenido.
`PutMetadata.content_language_after`	String	Especifica el valor del encabezado `Content-Language` después de que se completa el trabajo `PutMetadata`. Es un campo opcional y solo se completa si se estableció o modificó el idioma del contenido.
`PutMetadata.content_type_after`	String	Especifica el valor del encabezado `Content-Type` después de que se completa el trabajo `PutMetadata`. Es un campo opcional y solo se propaga si se estableció o modificó el tipo de contenido.
`PutMetadata.cache_control_after`	String	Especifica el valor del encabezado `Cache-Control` después de que se completa el trabajo `PutMetadata`. Es un campo opcional y solo se completa si se estableció o modificó el control de caché.
`PutMetadata.custom_time_after`	String	Especifica el valor del encabezado `Custom-Time` después de que se completa el trabajo `PutMetadata`. Es un campo opcional y solo se propaga si se estableció o modificó la hora personalizada.
`PutMetadata.custom_metadata_after`	Map (key: string, value: string)	Contiene un mapa de pares clave-valor de `Custom- Metadata` después de la transformación. Este campo incluye los metadatos definidos por el usuario que se configuraron o modificaron en el objeto. Permite el almacenamiento flexible de metadatos adicionales.