Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés. # Supervisión de sus AWS DataSync transferencias La supervisión es importante para mantener la fiabilidad y el rendimiento de las actividades de transferencia de AWS DataSync . Recomendamos que recopile los datos de monitoreo para que le resulte más sencillo eliminar los errores que se produzcan. Sin embargo DataSync, antes de comenzar a monitorear, cree un plan de monitoreo que incluya respuestas a las siguientes preguntas: + ¿Cuáles son los objetivos de la supervisión? + ¿Qué recursos va a supervisar? + ¿Con qué frecuencia va a supervisar estos recursos? + ¿Qué herramientas de supervisión va a utilizar? + ¿Quién se encargará de realizar las tareas de supervisión? + ¿Quién debería recibir una notificación cuando surjan problemas? AWS proporciona varios servicios y herramientas para la supervisión DataSync. Puede configurar algunas de estas para que realicen la labor de monitoreo automáticamente para usted; sin embargo, otras requieren intervención manual. Le recomendamos que automatice las tareas de supervisión en la medida de lo posible. **Topics** + [Comprensión de los contadores de rendimiento de la transferencia de datos](transfer-performance-counters.md) + [Supervisión de transferencias de datos con métricas de Amazon CloudWatch](monitor-datasync.md) + [Supervisión de las transferencias de datos con informes de tareas](task-reports.md) + [Supervisión de las transferencias de datos con Amazon CloudWatch Logs](configure-logging.md) + [Registrar llamadas a la AWS DataSync API con AWS CloudTrail](logging-using-cloudtrail.md) + [Supervisión de eventos mediante Amazon EventBridge](events.md) + [Supervisión AWS DataSync con herramientas manuales](monitoring-task-manually.md) # Comprensión de los contadores de rendimiento de la transferencia de datos Al [iniciar una tarea](run-task.md), AWS DataSync proporciona contadores para ayudarle a realizar un seguimiento del rendimiento y el progreso de la transferencia de datos. Utilice la siguiente información para entender qué representa cada contador. Puedes ver estos contadores en la DataSync consola o en una [DescribeTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html)respuesta. Algunos contadores no están disponibles en todos los [modos de tarea](choosing-task-mode.md). | Consola | `DescribeTaskExecution` | Compatibilidad con modos de tarea | Description (Descripción) | | --- | --- | --- | --- | | – | `BytesWritten` | Mejorado, Básico | El número de bytes lógicos que DataSync realmente escriben en la ubicación de destino. | | **Rendimiento de datos** | – | Mejorado, Básico | La velocidad a la que se DataSync escriben los bytes lógicos en la ubicación de destino. Si lo utilizas [DescribeTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html), la forma de calcular este contador depende del modo de tarea: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/datasync/latest/userguide/transfer-performance-counters.html) | | Datos transferidos | `BytesTransferred` | Mejorado, Básico | El número de bytes que se DataSync envían a la red antes de la compresión (si la compresión es posible). Para conocer el número de bytes transferidos a través de la red, consulte el contador de **rendimiento de la red** (en la consola) o `BytesCompressed` (in [DescribeTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html)). | | **Eliminados del destino** | `FilesDeleted` | Basic | El número de archivos, objetos y directorios que DataSync realmente se eliminan en la ubicación de destino. Si no configura la tarea para [eliminar los datos del destino que no están en el origen](configure-metadata.md#task-option-file-object-handling): [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/datasync/latest/userguide/transfer-performance-counters.html) | | **Eliminados del destino** | `FilesDeleted`, `FoldersDeleted` | Mejorado | El número de archivos u objetos y directorios que DataSync realmente se eliminan en la ubicación de destino. Si no configura la tarea para [eliminar los datos del destino que no están en el origen](configure-metadata.md#task-option-file-object-handling): [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/datasync/latest/userguide/transfer-performance-counters.html) | | – | `EstimatedBytesToTransfer` | Mejorado, Básico | El número de bytes lógicos que se DataSync espera escribir en la ubicación de destino. | | – | `EstimatedFilesToDelete` | Basic | El número de archivos, objetos y directorios que se DataSync espera eliminar en la ubicación de destino. Si no [configura la tarea](configure-metadata.md#task-option-file-object-handling) para eliminar datos del destino que no estén en el origen, el valor siempre será `0`. | | – | `EstimatedFilesToDelete`, `EstimatedFoldersToDelete` | Mejorado | El número de archivos u objetos y directorios que se DataSync espera eliminar en la ubicación de destino. Si no [configura la tarea](configure-metadata.md#task-option-file-object-handling) para eliminar datos del destino que no estén en el origen, el valor siempre será `0`. | | – | `EstimatedFilesToTransfer` | Basic | La cantidad de archivos, objetos y directorios que se DataSync espera transferir a través de la red. Este valor se calcula mientras DataSync [se prepara](run-task.md#understand-task-execution-statuses) la transferencia. La forma en que se calcula depende principalmente del [modo de transferencia](configure-metadata.md#task-option-transfer-mode) utilizado: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/datasync/latest/userguide/transfer-performance-counters.html) | | – | `EstimatedFilesToTransfer`, `EstimatedFoldersToTransfer` | Mejorado | La cantidad de archivos u objetos y directorios que se DataSync espera transferir a través de la red. Este valor se calcula mientras DataSync [se prepara](run-task.md#understand-task-execution-statuses) la transferencia. La forma en que se calcula depende principalmente del [modo de transferencia](configure-metadata.md#task-option-transfer-mode) utilizado: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/datasync/latest/userguide/transfer-performance-counters.html) | | **Rendimiento de archivos** | – | Mejorado, Básico | La velocidad a la que se DataSync transfieren archivos, objetos y directorios a través de la red. Si lo estás usando [DescribeTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html), la forma de calcular este contador depende del modo de tarea que utilices: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/datasync/latest/userguide/transfer-performance-counters.html) | | – | `FilesFailed`, `FoldersFailed` | Mejorado | La cantidad de archivos u objetos y directorios que DataSync no se pueden preparar, transferir, verificar ni eliminar durante la ejecución de la tarea. Si se producen errores, puede verlos junto con los contadores de consola **Preparado**, **Transferido**, **Omitido** y **Eliminado del destino**, respectivamente. | | **Enumerados en el origen** | `FilesListed.AtSource`, `FoldersListed.AtSource` | Mejorado | El número de archivos u objetos y los directorios que DataSync se encuentran en la ubicación de origen. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/datasync/latest/userguide/transfer-performance-counters.html) | | – | `FilesListed.AtDestinationForDelete`, `FoldersListed.AtDestinationForDelete` | Mejorado | El número de archivos u objetos y los directorios que DataSync se encuentran en la ubicación de destino. Este contador solo es aplicable si la tarea se configura para [eliminar datos en el destino que no están presentes en el origen](configure-metadata.md#task-option-file-object-handling). | | **Rendimiento de la red\$1** | `BytesCompressed` | Mejorado, Básico | El número de bytes físicos que se DataSync transfieren a través de la red después de la compresión (si la compresión es posible). Este número suele ser inferior al de **los datos transferidos** (en la consola) o `BytesTransferred` (en [DescribeTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html)), a menos que los datos no se puedan comprimir. \$1 En el modo mejorado, el **rendimiento de la red** no se muestra en la consola. | | **Porcentaje comprimido** | – | Mejorado, Básico | El porcentaje de datos de transferencia que se DataSync comprimieron antes de enviarlos a través de la red. Si lo estás usando [DescribeTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html), puedes calcular este contador con`1 - BytesCompressed / BytesWritten`. | | **Preparado** | `FilesPrepared`, `FoldersPrepared` | Mejorado | La cantidad de archivos u objetos y directorios que DataSync se intentarán transferir después de comparar las ubicaciones de origen y destino. En la consola, este contador también puede mostrar el número de objetos que se DataSync omiten durante la preparación. Para obtener más información, consulte [¿Cómo DataSync se prepara la transferencia de datos](how-datasync-transfer-works.md#how-datasync-prepares). Este contador no es aplicable si la tarea se configura para [transferir todos los datos](configure-metadata.md#task-option-transfer-mode). En ese escenario, DataSync copia todo, desde el origen hasta el destino, sin comparar las diferencias entre las ubicaciones. | | **Tasa de procesamiento** | – | Mejorado, Básico | La velocidad a la que se DataSync leen los archivos, objetos y directorios en la ubicación de origen. La velocidad de procesamiento se basa en varias [CloudWatch métricas](monitor-datasync.md#accessing-metrics). Las métricas exactas dependen del modo de la tarea que utilice. **Modo mejorado**: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/datasync/latest/userguide/transfer-performance-counters.html) **Modo básico:** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/datasync/latest/userguide/transfer-performance-counters.html) | | **Restante** | – | Basic | El número restante de archivos, objetos y directorios que se DataSync espera transferir a través de la red. Si lo está utilizando [DescribeTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html), puede calcular este contador `FilesTransferred` restando de. `EstimatedFilesToTransfer` | | **Omitidos**\$1 | `FilesSkipped` | Basic | El número de archivos, objetos y directorios que se DataSync omiten durante la transferencia. | | – | `FilesSkipped`, `FoldersSkipped` | Mejorado | El número de archivos u objetos y directorios que se DataSync omiten durante la transferencia. Los elementos **omitidos** se incluyen en el contador de **preparados** cuando se [transfieren solo los datos que han cambiado](configure-metadata.md#task-option-transfer-mode) o en el contador de transferidos cuando **se transfieren** [todos los](configure-metadata.md#task-option-transfer-mode) datos. | | **Transferidos** | `FilesTransferred` | Basic | El número de archivos, objetos y directorios que se DataSync transfieren a través de la red. Este valor se actualiza periódicamente durante la ejecución de la tarea cuando se lee contenido desde el origen y se envía a través de la red. Si DataSync no se puede transferir algo, este valor puede ser inferior a `EstimatedFilesToTransfer` o`EstimatedFoldersToTransfer`. En algunos casos, este valor también puede ser superior a `EstimatedFilesToTransfer` o`EstimatedFoldersToTransfer`. Este contador depende de la implementación para algunos tipos de ubicación, por lo que no se debe utilizar como una indicación exacta de lo que se transfiere ni para supervisar la ejecución de la tarea. | | **Transferidos** | `FilesTransferred`, `FoldersTransferred` | Mejorado | El número de archivos u objetos y directorios que se DataSync transfieren a través de la red. Este valor se actualiza periódicamente durante la ejecución de la tarea cuando se lee contenido desde el origen y se envía a través de la red. Si DataSync no se puede transferir algo, este valor puede ser inferior a `EstimatedFilesToTransfer` o`EstimatedFoldersToTransfer`. En algunos casos, este valor también puede ser superior a `EstimatedFilesToTransfer` o`EstimatedFoldersToTransfer`. Este contador depende de la implementación para algunos tipos de ubicación, por lo que no se debe utilizar como una indicación exacta de lo que se transfiere ni para supervisar la ejecución de la tarea. | | **Verificado** | `FilesVerified` | Basic | El número de archivos, objetos y directorios que se DataSync verifica durante la transferencia. Al configurar la tarea para [comprobar únicamente los datos transferidos](configure-data-verification-options.md), DataSync no comprueba los directorios en algunas situaciones ni los archivos u objetos que no se transfieren. | | **Verificado** | `FilesVerified`, `FoldersVerified` | Mejorado | El número de archivos u objetos y directorios que se DataSync verifica durante la transferencia. | # Supervisión de transferencias de datos con métricas de Amazon CloudWatch Amazon CloudWatch proporciona métricas para realizar el seguimiento del rendimiento de las transferencias de DataSync y solucionar problemas relacionados con la tarea de transferencia. Puede supervisar el rendimiento de la transferencia AWS DataSync mediante métricas de Amazon CloudWatch. Las métricas de DataSync se envían automáticamente a CloudWatch en intervalos de 5 minutos (independientemente de cómo se [configure el registro](configure-logging.md)). Las métricas se retienen durante un periodo de 15 meses. Para ver las métricas de CloudWatch para DataSync, puede usar las siguientes herramientas: + Abra la consola de CloudWatch. + La CLI de CloudWatch + La API de CloudWatch + La consola de DataSync (en la página de detalles de la ejecución de la tarea) Para obtener más información, consulte la [https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html). ## Métricas de CloudWatch para DataSync Las métricas de DataSync utilizan el espacio de nombres de `aws/datasync` y proporcionan métricas para las siguientes dimensiones: + **AgentId**: el ID único del agente (si la tarea usa un agente). + **TaskID**: identificador único de la tarea. Adopta el formato `task-01234567890abcdef`. El espacio de nombres de `aws/datasync` incluye las siguientes métricas. Algunas métricas no están disponibles para todos los [modos de tarea](choosing-task-mode.md). | Métrica de CloudWatch | Compatibilidad con modos de tarea | Descripción | | --- | --- | --- | | `BytesCompressed` | Basic | El número de bytes físicos que DataSync transfiere a través de la red después de la compresión (si la compresión es posible). Este valor suele ser inferior a `BytesTransferred`, salvo que los datos no sean comprimibles. Unidades: bytes | | `BytesPreparedDestination` | Basic | El número de bytes lógicos que DataSync prepara en la ubicación de destino. Unidades: bytes | | `BytesPreparedSource` | Basic | El número de bytes lógicos que DataSync prepara en la ubicación de origen. Unidades: bytes | | `BytesTransferred` | Basic | El número de bytes que DataSync envía a la red antes de la compresión (si la compresión es posible). Para conocer el número de bytes transferidos a través de la red, consulte la métrica `BytesCompressed`. Unidades: bytes | | `BytesVerifiedDestination` | Basic | El número de bytes lógicos que DataSync verifica en la ubicación de destino. Unidades: bytes | | `BytesVerifiedSource` | Basic | El número de bytes lógicos que DataSync verifica en la ubicación de origen. Unidades: bytes | | `BytesWritten` | Mejorado, Básico | El número de bytes lógicos que DataSync escribe en la ubicación de destino. Unidades: bytes | | `FilesDeleted` | Mejorado, Básico | El número de archivos, objetos y directorios que DataSync elimina en la ubicación de destino. Si no [configura la tarea](configure-metadata.md#task-option-file-object-handling) para eliminar datos del destino que no estén en el origen, el valor siempre será `0`. Unidad: recuento | | `FilesListedSource` | Mejorado | El número de objetos que DataSync encuentra en la ubicación de origen. Unidad: recuento | | `FilesPrepared` | Mejorado | El número de objetos que DataSync intenta transferir después de comparar las ubicaciones de origen y destino. Para obtener más información, consulte [¿Cómo DataSync se prepara la transferencia de datos](how-datasync-transfer-works.md#how-datasync-prepares). Esta métrica no es aplicable si la tarea se configura para [transferir todos los datos](configure-metadata.md#task-option-transfer-mode). En ese caso, DataSync copia todo desde el origen en el destino sin comparar las diferencias entre las ubicaciones. Unidad: recuento | | `FilesPreparedDestination` | Basic | El número de archivos, objetos y directorios que DataSync prepara en la ubicación de destino. Unidad: recuento | | `FilesPreparedSource` | Basic | El número de archivos, objetos y directorios que DataSync prepara en la ubicación de origen. Unidad: recuento | | `FilesSkipped` | Basic | El número de archivos, objetos y directorios que DataSync omite durante la transferencia. Unidad: recuento | | `FilesTransferred` | Mejorado, Básico | La cantidad de archivos, objetos y directorios que DataSync transfiere a través de la red. Este valor se actualiza periódicamente durante la [ejecución de la tarea](run-task.md#understand-task-execution-statuses) cuando se lee contenido desde el origen y se envía a través de la red. Este valor puede ser inferior a `EstimatedFilesToTransfer` en una respuesta de [DescribetAskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html) si DataSync no puede transferir algo. Este valor también puede ser mayor que en algunos casos `EstimatedFilesToTransfer`. Esta métrica es específica de la implementación para algunos tipos de ubicación, por tanto, no la utilice como indicador exacto de lo que se transfirió o para monitorizar la ejecución de tareas. Unidad: recuento | | `FilesVerified` | Mejorado | El número de objetos que DataSync verifica durante la transferencia. Unidad: recuento | | `FilesVerifiedDestination` | Basic | El número de archivos, objetos y directorios que DataSync verifica en la ubicación de destino. Unidad: recuento | | `FilesVerifiedSource` | Basic | El número de archivos, objetos y directorios que DataSync verifica en la ubicación de origen. Unidad: recuento | # Supervisión de las transferencias de datos con informes de tareas Los *informes de tareas* proporcionan información detallada sobre lo que AWS DataSync intenta transferir, omitir, verificar y eliminar durante la ejecución de una tarea. Para obtener más información, consulte [Cómo DataSync transfiere los archivos, objetos y directorios](how-datasync-transfer-works.md#transferring-files). Los informes de tareas se generan en formato JSON. Puede personalizar el nivel de detalle de los informes: + [Los informes de tareas de solo resumen](#task-report-types-summary) proporcionan los detalles necesarios sobre la ejecución de la tarea, como el número de archivos transferidos y si se DataSync puede verificar la integridad de los datos de esos archivos. + Los [informes de tareas estándar](#task-report-types-standard) incluyen un resumen e informes detallados que enumeran cada archivo, objeto o carpeta que se DataSync intenta transferir, omitir, verificar o eliminar. Con un informe de tareas estándar, también puede especificar el [nivel de informe](#task-report-level) para mostrar solo los errores de la ejecución de la tarea o tanto aciertos como errores. ## Casos de uso Estas son algunas situaciones en las que los informes de tareas pueden ayudarle a supervisar y auditar sus transferencias de datos: + Al migrar millones de archivos, identifique rápidamente los archivos que DataSync tienen problemas para transferirse. + Verifica chain-of-custody los procesos de tus archivos. ## Resumen de los informes de tareas Un informe que es solo un resumen de la ejecución de una tarea incluye los siguientes detalles: + El Cuenta de AWS que ejecutó la tarea + Ubicaciones de origen y destino + El número total de archivos, objetos y carpetas que se han omitido, transferido, verificado y eliminado + El total de bytes (lógicos y físicos) que se han transferido + Si la ejecución de la tarea se ha completado, se ha cancelado o si se producido un error + Las horas de inicio y finalización (incluido el tiempo total de la transferencia) + La configuración de la tarea (como los límites de ancho de banda, la verificación de la integridad de los datos y otras opciones para la DataSync transferencia) ## Informes de tareas estándar Un informe de tareas estándar incluye un [resumen](#task-report-types-summary) de la ejecución de la tarea, además de informes detallados de lo que se DataSync intenta transferir, omitir, verificar y eliminar. **Topics** + [Nivel del informe](#task-report-level) + [Informes transferidos](#task-report-types-transferred) + [Informes de omisión](#task-report-types-skipped) + [Informes de verificación](#task-report-types-verified) + [Informes de eliminación](#task-report-types-deleted) ### Nivel del informe Con los informes de tareas estándar, puede elegir uno de los siguientes niveles de informe: + Solo errores + Éxitos y errores (básicamente una lista de todo lo que ha ocurrido durante la ejecución de la tarea) Por ejemplo, es posible que desees ver qué archivos DataSync se omitieron correctamente durante la transferencia y cuáles no. Es posible que los archivos que se DataSync omitieron correctamente sean aquellos que desee excluir DataSync a propósito porque ya existen en la ubicación de destino. Sin embargo, si se omite un error, por ejemplo, podría indicar que DataSync no tiene los permisos adecuados para leer un archivo. ### Informes transferidos Una lista de archivos, objetos y directorios que se DataSync intentaron transferir durante la ejecución de la tarea. Un informe de transferencia incluye los siguientes detalles: + Las rutas de los datos transferidos + Qué se ha transferido (contenido, metadatos o ambos) + Los metadatos, que incluyen el tipo de datos, el tamaño del contenido (solo objetos y archivos) y más + La hora en que se ha transferido un elemento + La versión del objeto (si el destino es un bucket de Amazon S3 que tiene habilitado el control de versiones) + Si se ha sobrescrito algo en el destino + Si un artículo se ha transferido correctamente **nota** Al mover datos entre depósitos de S3, el prefijo que especifique en su [ubicación de origen](create-s3-location.md) puede aparecer en su informe (o en los CloudWatch registros de Amazon), incluso si ese prefijo no existe como objeto en su ubicación de destino. (En la DataSync consola, es posible que también veas que este prefijo aparece como datos omitidos o verificados). ### Informes de omisión Una lista de archivos, objetos y directorios que DataSync se encuentran en la ubicación de origen pero que no se han intentado transferir. Los motivos por los que DataSync se omiten los datos pueden depender de varios factores, como la forma en que se configuran las tareas y los permisos del sistema de almacenamiento. Estos son algunos ejemplos: + Uno de los archivos de la ubicación de origen existe en las ubicaciones de origen y de destino. El archivo del origen no se ha modificado desde la ejecución anterior de la tarea. Como [solo transfiere datos que han cambiado](configure-metadata.md#task-option-transfer-mode), DataSync no transferirá ese archivo la próxima vez que ejecute la tarea. + Un objeto que existe en ambas ubicaciones cambia en el origen. Al ejecutar la tarea, DataSync omite este objeto en el destino porque la tarea no [sobrescribe los datos del](configure-metadata.md#task-option-file-object-handling) destino. + DataSync omite un objeto del origen que utiliza una [clase de almacenamiento de archivos y no](create-s3-location.md#using-storage-classes) se restaura. Debes restaurar un objeto archivado para DataSync poder leerlo. + DataSync omite un archivo, objeto o directorio de la ubicación de origen porque no puede leerlo. Si esto ocurre y no es lo esperado, comprueba los permisos de acceso del almacenamiento y asegúrate de que DataSync puede leer lo que se omitió. Un informe de omisión incluye los siguientes detalles: + Las rutas de los datos omitidos + La hora en que se ha omitido un elemento + La razón por la que se ha omitido + Si un elemento se ha omitido correctamente **nota** Los informes de omisión pueden ser extensos si incluyen aciertos y errores, se configura la tarea para [transferir solo los datos que han cambiado](configure-metadata.md) y los datos de origen ya existen en el destino. ### Informes de verificación Una lista de archivos, objetos y directorios de los que se DataSync intentó comprobar la integridad durante la ejecución de la tarea. Un informe de verificación incluye los siguientes detalles: + Las rutas de los datos verificados + La hora en que se ha verificado un elemento + El motivo del error en la verificación (si lo hubiera) + Las SHA256 sumas de control de origen y destino (solo archivos) + Si un elemento se ha verificado correctamente Tenga en cuenta lo siguiente sobre los informes de verificación: + Cuando configura la tarea para [verificar solo los datos transferidos](configure-data-verification-options.md), DataSync no verifica los directorios en algunas situaciones ni los archivos u objetos que no se transfieren. En cualquier caso, DataSync no incluye datos no verificados en este informe. + Si utiliza el [modo mejorado](choosing-task-mode.md), la verificación puede tardar más de lo habitual cuando se transfieren objetos de gran tamaño. ### Informes de eliminación Una lista de archivos, directorios y objetos que se eliminaron durante la ejecución de la tarea. DataSync genera este informe solo si [configura la tarea](configure-metadata.md) para eliminar datos de la ubicación de destino que no estén en la fuente. Un informe de eliminación incluye los siguientes detalles: + Las rutas de los datos eliminados + Si un elemento se ha eliminado correctamente + La hora en que se ha eliminado un elemento ## Ejemplos de informes de tareas El nivel de detalle del informe de tareas depende de usted. Estos son algunos ejemplos de informes de datos transferidos con la siguiente configuración: + **Tipo de informe**: estándar + **Nivel de informe**: éxitos y errores **nota** Los informes utilizan la norma ISO-8601 para el formato de marca de tiempo. Las horas aparecen en UTC y se miden en nanosegundos. Este comportamiento difiere de la forma en que se miden otras métricas de los informes de tareas. Por ejemplo, [los detalles de la ejecución de las tareas](https://docs.aws.amazon.com/datasync/latest/userguide/API_TaskExecutionResultDetail.html), tales como `TransferDuration` y `VerifyDuration`, se miden en milisegundos. Los informes de tareas en modo mejorado utilizan un esquema ligeramente distinto al de los informes de tareas en modo básico. Los siguientes ejemplos ayudan a entender qué puede esperar de los informes según el [modo de tarea](choosing-task-mode.md) que utilice. **Ejemplo de informes de datos transferidos con estado correcto** Los siguientes informes muestran transferencias correctas de un objeto denominado `object1.txt`. ``` { "TaskExecutionId": "exec-abcdefgh12345678", "Transferred": [{ "RelativePath": "object1.txt", "SourceMetadata": { "Type": "Object", "ContentSize": 6, "LastModified": "2024-10-04T14:40:55Z", "SystemMetadata": { "ContentType": "binary/octet-stream", "ETag": "\"9b2d7e1f8054c3a2041905d0378e6f14\"", "ServerSideEncryption": "AES256" }, "UserMetadata": {}, "Tags": [] }, "Overwrite": "False", "DstS3VersionId": "jtqRtX3jN4J2G8k0sFSGYK1f35KqpAVP", "TransferTimestamp": "2024-10-04T14:48:39.748862183Z", "TransferType": "CONTENT_AND_METADATA", "TransferStatus": "SUCCESS" }] } ``` ``` { "TaskExecutionId": "exec-abcdefgh12345678", "Transferred": [{ "RelativePath": "/object1.txt", "SrcMetadata": { "Type": "Regular", "ContentSize": 6, "Mtime": "2022-01-07T16:59:26.136114671Z", "Atime": "2022-01-07T16:59:26.136114671Z", "Uid": 0, "Gid": 0, "Mode": "0644" }, "Overwrite": "False", "DstS3VersionId": "jtqRtX3jN4J2G8k0sFSGYK1f35KqpAVP", "TransferTimestamp": "2022-01-07T16:59:45.747270957Z", "TransferType": "CONTENT_AND_METADATA", "TransferStatus": "SUCCESS" }] } ``` **Ejemplo de informes de datos transferidos con estado de error** En los siguientes informes se proporcionan ejemplos de casos en los que no se DataSync puede transferir un objeto denominado`object1.txt`. Este informe muestra que no DataSync pueden acceder a un objeto nombrado `object1.txt` debido a un problema de AWS KMS permisos. (Si aparece un error como este, consulte [Acceso a buckets de S3 mediante el cifrado del servidor](create-s3-location.md#create-s3-location-encryption)). ``` { "TaskExecutionId": "exec-abcdefgh12345678", "Transferred": [{ "RelativePath": "object1.txt", "SourceMetadata": { "Type": "Object", "ContentSize": 6, "LastModified": "2022-10-07T20:48:32Z", "SystemMetadata": { "ContentType": "binary/octet-stream", "ETag": "\"3a7c0b2f1d9e5c4a6f8b2e0d1c9f7a3b2\"", "ServerSideEncryption": "AES256" }, "UserMetadata": {}, "Tags": [] }, "Overwrite": "False", "TransferTimestamp": "2022-10-09T16:05:11.134040717Z", "TransferType": "CONTENT_AND_METADATA", "TransferStatus": "FAILED", "ErrorCode": "AccessDenied", "ErrorDetail": "User: arn:aws:sts::111222333444:assumed-role/AWSDataSyncS3Bucket/AwsSync-loc-0b3017fc4ba4a2d8d is not authorized to perform: kms:GenerateDataKey on resource: arn:aws:kms:us-east-1:111222333444:key/1111aaaa-22bb-33cc-44d-5555eeee6666 because no identity-based policy allows the kms:GenerateDataKey action" }] } ``` Este informe muestra que un objeto denominado `object1.txt` no se transfirió debido a un problema con los permisos del bucket de S3. (Si aparece un error como este, consulte [Proporcionar DataSync acceso a los depósitos de S3](create-s3-location.md#create-s3-location-access)). ``` { "TaskExecutionId": "exec-abcdefgh12345678", "Transferred": [{ "RelativePath": "/object1.txt", "SrcMetadata": { "Type": "Regular", "ContentSize": 6, "Mtime": "2022-01-07T16:59:26.136114671Z", "Atime": "2022-01-07T16:59:26.136114671Z", "Uid": 0, "Gid": 0, "Mode": "0644" }, "Overwrite": "False", "DstS3VersionId": "jtqRtX3jN4J2G8k0sFSGYK1f35KqpAVP", "TransferTimestamp": "2022-01-07T16:59:45.747270957Z", "TransferType": "CONTENT_AND_METADATA", "TransferStatus": "FAILED", "FailureReason": "S3 Get Object Failed", "FailureCode": 40974 }] } ``` ## Limitaciones + Los informes de tareas individuales no pueden superar los 5 MB. Si va a copiar una gran cantidad de archivos, es posible que el informe de tareas se divida en varios informes. + Hay situaciones en las que la creación de informes de tareas puede afectar al rendimiento de la transferencia de datos. Por ejemplo, puede que lo note cuando la conexión de red tiene una alta latencia y los archivos que está transfiriendo son pequeños o si solo está copiando los cambios en los metadatos. # Crear tus informes de DataSync tareas AWS DataSync los informes de tareas solo pueden ser un resumen de la ejecución de la tarea o un conjunto de informes detallados sobre lo que se DataSync intenta transferir, omitir, verificar y eliminar. ## Requisitos previos Antes de poder crear un informe de tarea, debe ejecutar las siguientes tareas. **Topics** + [Creación de un bucket de S3 para sus informes de tarea](#setting-up-task-report-create-bucket) + [Permite DataSync cargar informes de tareas a tu bucket de S3](#task-report-access) ### Creación de un bucket de S3 para sus informes de tarea Si aún no tiene uno, [cree un depósito de S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html) donde DataSync pueda cargar su informe de tareas. Los informes se almacenan en la clase de almacenamiento S3 Standard. Le recomendamos lo siguiente para este bucket: + Si planea transferir datos a un bucket de S3, no utilice el mismo bucket para el informe de tareas si [desactiva la opción **Conservar los archivos eliminados**](configure-metadata.md). De lo contrario, DataSync eliminará todos los informes de tareas anteriores cada vez que ejecute una tarea, ya que esos informes no existen en su ubicación de origen. + Para evitar una configuración compleja de los permisos de acceso, asegúrate de que el grupo de informes de tareas esté en la misma región Cuenta de AWS y en la misma región que la tarea de DataSync transferencia. ### Permite DataSync cargar informes de tareas a tu bucket de S3 Debe configurar un rol AWS Identity and Access Management (de IAM) que le permita DataSync cargar un informe de tareas en su bucket de S3. En la DataSync consola, puede crear un rol de IAM que, en la mayoría de los casos, incluya automáticamente los permisos para cargar un informe de tareas en su bucket. Tenga en cuenta que es posible que este rol generado automáticamente no satisfaga sus necesidades desde el punto de vista de los privilegios mínimos. Esta función tampoco funcionará si el bucket está cifrado con una clave gestionada por el cliente AWS Key Management Service (AWS KMS) (SSE-KMS). En estos casos, puede crear el rol de forma manual siempre que dicho rol haga al menos lo siguiente: + [Evita el problema del suplente confuso entre servicios](https://docs.aws.amazon.com/datasync/latest/userguide/cross-service-confused-deputy-prevention.html) en la entidad de confianza del rol. En el siguiente ejemplo completo se muestra cómo se pueden utilizar las claves de contexto de condición `aws:SourceAccount` global `aws:SourceArn` y las claves contextuales para evitar que se confunda con el problema de los adjuntos. DataSync ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "datasync.amazonaws.com" }, "Action": "sts:AssumeRole", "Condition": { "StringEquals": { "aws:SourceAccount": "123456789012" }, "ArnLike": { "aws:SourceArn": "arn:aws:datasync:us-east-1:123456789012:*" } } } ] } ``` ------ + Permite DataSync cargar un informe de tareas a su bucket de S3. El siguiente ejemplo lo hace incluyendo la acción de `s3:PutObject` solo para un prefijo específico (`reports/`) en el bucket. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [{ "Action": [ "s3:PutObject" ], "Effect": "Allow", "Resource": "arn:aws:s3:::your-task-reports-bucket/reports/*" }] } ``` ------ + Si el bucket de S3 está cifrado con una clave SSE-KMS gestionada por el cliente, la [política de la clave](https://docs.aws.amazon.com/kms/latest/developerguide/key-policy-modifying.html) debe incluir la función de IAM que se DataSync utiliza para acceder al bucket. Para obtener más información, consulte [Acceso a buckets de S3 mediante el cifrado del servidor](create-s3-location.md#create-s3-location-encryption). ## Creación de un informe de tareas de tipo solo resumen Puede configurar un informe de tareas que incluya un [resumen solo](task-reports.md#task-report-types-summary) al crear la DataSync tarea, iniciarla o actualizarla. Los siguientes pasos muestran cómo configurar un informe de tareas de tipo solo resumen al crear una tarea. ### Uso de la DataSync consola 1. Abra la AWS DataSync consola en [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/). 1. En el panel de navegación situado a la izquierda, expanda **Transferencia de datos**; luego, seleccione **Tareas** y, a continuación, seleccione **Crear tarea**. 1. Configure las ubicaciones de origen y destino de la tarea. Para obtener más información, consulte [¿Dónde puedo transferir mis datos AWS DataSync?](working-with-locations.md) 1. Desplácese hacia abajo hasta la sección **Informe de tareas**. En **Tipo de informe**, seleccione **Solo resumen**. 1. Para el **depósito de informes de S3**, elija un depósito de S3 en el que DataSync desee cargar el informe de tareas. **sugerencia** Si planea transferir datos a un bucket de S3, no utilice el mismo bucket para el informe de tareas si [desactiva la opción **Conservar los archivos eliminados**](configure-metadata.md). De lo contrario, DataSync eliminará todos los informes de tareas anteriores cada vez que ejecute una tarea, ya que esos informes no existen en su ubicación de origen. 1. En **Carpeta**, introduce un prefijo para usarlo en tu informe de tareas cuando lo DataSync cargues en tu bucket de S3 (por ejemplo,**reports/**). Asegúrese de incluir el carácter delimitador adecuado al final del prefijo. Este carácter normalmente es una barra inclinada (`/`). Para obtener más información, consulte [Organizar objetos con prefijos](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-prefixes.html) en la *Guía del usuario de Amazon S3*. 1. En **Rol de IAM**, realice una de las operaciones siguientes: + Elija **Generar automáticamente** para crear DataSync automáticamente un rol de IAM con los permisos necesarios para acceder al bucket de S3. Si DataSync anteriormente creó un rol de IAM para este bucket de S3, ese rol se elige de forma predeterminada. + Elija un rol de IAM personalizado que haya creado. En algunos casos, es posible que tenga que crear el rol por sí mismo. Para obtener más información, consulte [Permite DataSync cargar informes de tareas a tu bucket de S3](#task-report-access). **importante** Si el bucket de S3 está cifrado con una clave SSE-KMS administrada por el cliente, la política de la clave debe incluir la función de IAM que se DataSync utiliza para acceder al bucket. Para obtener más información, consulte [Acceso a buckets de S3 mediante el cifrado del servidor](create-s3-location.md#create-s3-location-encryption). 1. Termine de crear la tarea y, a continuación, [inicie la tarea](run-task.md) para empezar a transferir los datos. Cuando se complete la transferencia, podrá [ver el informe de la tarea](task-report-viewing.md). ### Uso del AWS CLI 1. Copie el siguiente comando `create-task` AWS Command Line Interface (AWS CLI): ``` aws datasync create-task \ --source-location-arn arn:aws:datasync:us-east-1:123456789012:location/loc-12345678abcdefgh \ --destination-location-arn arn:aws:datasync:us-east-1:123456789012:location/loc-abcdefgh12345678 \ --task-report-config '{ "Destination":{ "S3":{ "Subdirectory":"reports/", "S3BucketArn":"arn:aws:s3:::your-task-reports-bucket", "BucketAccessRoleArn":"arn:aws:iam::123456789012:role/bucket-iam-role" } }, "OutputType":"SUMMARY_ONLY" }' ``` 1. Para el parámetro `--source-location-arn`, especifique el nombre de recurso de Amazon (ARN) de la ubicación de origen en la transferencia. `us-east-1`Sustitúyalo por el correspondiente Región de AWS, `123456789012` sustitúyalo por el Cuenta de AWS número correspondiente y `12345678abcdefgh` sustitúyalo por el identificador de ubicación de origen correspondiente. 1. Para el parámetro `--destination-location-arn`, especifique el ARN de la ubicación de destino en la transferencia. Sustituya por `us-east-1` el correspondiente Región de AWS, `123456789012` sustitúyalo por el Cuenta de AWS número correspondiente y `abcdefgh12345678` sustitúyalo por el identificador de ubicación de destino correspondiente. 1. Para el parámetro `--task-report-config`, haga lo siguiente: + `Subdirectory`— `reports/` Sustitúyalo por el prefijo del bucket de S3 en el que desee DataSync cargar los informes de tareas. Asegúrese de incluir el carácter delimitador adecuado al final del prefijo. Este carácter normalmente es una barra inclinada (`/`). Para obtener más información, consulte [Organizar objetos con prefijos](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-prefixes.html) en la *Guía del usuario de Amazon S3*. + `S3BucketArn`: especifique el ARN del bucket de S3 donde desea cargar su informe de tareas. **sugerencia** Si planea transferir datos a un bucket de S3, no utilice el mismo bucket para el informe de tareas si [desactiva la opción **Conservar los archivos eliminados**](configure-metadata.md). De lo contrario, DataSync eliminará todos los informes de tareas anteriores cada vez que ejecute una tarea, ya que esos informes no existen en su ubicación de origen. + `BucketAccessRoleArn`— Especifique la función de IAM que permite DataSync cargar un informe de tareas en su bucket de S3. Para obtener más información, consulte [Permite DataSync cargar informes de tareas a tu bucket de S3](#task-report-access). **importante** Si su depósito de S3 está cifrado con una clave SSE-KMS gestionada por el cliente, la política de la clave debe incluir la función de IAM que se DataSync utiliza para acceder al depósito. Para obtener más información, consulte [Acceso a buckets de S3 mediante el cifrado del servidor](create-s3-location.md#create-s3-location-encryption). + `OutputType`: especifique `SUMMARY_ONLY`. Para obtener más información, consulte [Resumen de los informes de tareas](task-reports.md#task-report-types-summary). 1. Ejecute el comando `create-task` para crear la tarea. Obtendrá una respuesta como la siguiente, en la que se muestra el ARN de la tarea que ha creado. Necesitará este ARN para ejecutar el comando `start-task-execution`. ``` { "TaskArn": "arn:aws:datasync:us-east-1:123456789012:task/task-12345678abcdefgh" } ``` 1. Copie el siguiente comando `start-task-execution`. ``` aws datasync-task-report start-task-execution \ --task-arn arn:aws:datasync:us-east-1:123456789012:task/task-12345678abcdefgh ``` 1. Para el parámetro `--task-arn`, especifique el ARN de la tarea que está iniciando. Utilice el ARN que ha recibido al ejecutar el comando `create-task`. 1. Ejecute el comando `start-task-execution`. Cuando se complete la transferencia, podrá [ver el informe de la tarea](task-report-viewing.md). ## Creación de un informe de tareas estándar Puede configurar un [informe de tareas estándar](task-reports.md#task-report-types-standard) al crear su DataSync tarea, iniciarla o actualizarla. Los siguientes pasos muestran cómo configurar un informe de tareas de tipo estándar al crear una tarea. ### Uso de la DataSync consola 1. Abra la AWS DataSync consola en [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/). 1. En el panel de navegación situado a la izquierda, expanda **Transferencia de datos**; luego, seleccione **Tareas** y, a continuación, seleccione **Crear tarea**. 1. Configure las ubicaciones de origen y destino de la tarea. Para obtener más información, consulte [¿Dónde puedo transferir mis datos AWS DataSync?](working-with-locations.md) 1. Desplácese hacia abajo hasta la sección **Informe de tareas**. En **Tipo de informe**, seleccione **Informe estándar**. 1. En **Nivel de informe**, elija una de las siguientes opciones: + **Solo errores**: el informe de tareas incluye solo los problemas relacionados con lo que se DataSync intentó transferir, omitir, verificar y eliminar. + **Éxitos y errores**: el informe de tareas incluye lo que se DataSync ha transferido, omitido, verificado y eliminado correctamente y lo que no. + **Personalizado**: le permite elegir si desea ver solamente los errores o los éxitos y errores para aspectos específicos del informe de tareas. Por ejemplo, puede seleccionar **Éxitos y errores** para la lista de archivos transferidos, pero **Solo errores** para el resto del informe. 1. Si va a realizar la transferencia a un bucket de S3 que utiliza el control de versiones de objetos, deje la opción **Incluir versiones de objetos de Amazon S3** seleccionada si desea que su informe incluya la nueva versión de cada objeto transferido. 1. En el caso del **segmento de informes de S3**, elija un depósito de S3 en el que desee DataSync cargar el informe de tareas. **sugerencia** Si planea transferir datos a un bucket de S3, no utilice el mismo bucket para el informe de tareas si [desactiva la opción **Conservar los archivos eliminados**](configure-metadata.md). De lo contrario, DataSync eliminará todos los informes de tareas anteriores cada vez que ejecute una tarea, ya que esos informes no existen en su ubicación de origen. 1. En **Carpeta**, introduce un prefijo para usarlo en tu informe de tareas cuando lo DataSync cargues en tu bucket de S3 (por ejemplo,**reports/**). Asegúrese de incluir el carácter delimitador adecuado al final del prefijo. Este carácter normalmente es una barra inclinada (`/`). Para obtener más información, consulte [Organizar objetos con prefijos](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-prefixes.html) en la *Guía del usuario de Amazon S3*. 1. En **Rol de IAM**, realice una de las operaciones siguientes: + Elija **Generar automáticamente** para crear DataSync automáticamente un rol de IAM con los permisos necesarios para acceder al bucket de S3. Si DataSync anteriormente creó un rol de IAM para este bucket de S3, ese rol se elige de forma predeterminada. + Elija un rol de IAM personalizado que haya creado. En algunos casos, es posible que tenga que crear el rol por sí mismo. Para obtener más información, consulte [Permite DataSync cargar informes de tareas a tu bucket de S3](#task-report-access). **importante** Si el bucket de S3 está cifrado con una clave SSE-KMS administrada por el cliente, la política de la clave debe incluir la función de IAM que se DataSync utiliza para acceder al bucket. Para obtener más información, consulte [Acceso a buckets de S3 mediante el cifrado del servidor](create-s3-location.md#create-s3-location-encryption). 1. Termine de crear la tarea e [inicie la tarea](run-task.md) para empezar a transferir los datos. Cuando se complete la transferencia, podrá [ver el informe de la tarea](task-report-viewing.md). ### Uso del AWS CLI 1. Copie el siguiente comando `create-task`: ``` aws datasync create-task \ --source-location-arn arn:aws:datasync:us-east-1:123456789012:location/loc-12345678abcdefgh \ --destination-location-arn arn:aws:datasync:us-east-1:123456789012:location/loc-abcdefgh12345678 \ --task-report-config '{ "Destination":{ "S3":{ "Subdirectory":"reports/", "S3BucketArn":"arn:aws:s3:::your-task-reports-bucket", "BucketAccessRoleArn":"arn:aws:iam::123456789012:role/bucket-iam-role" } }, "OutputType":"STANDARD", "ReportLevel":"level-of-detail", "ObjectVersionIds":"include-or-not" }' ``` 1. Para el parámetro `--source-location-arn`, especifique el ARN de la ubicación de origen en la transferencia. Sustituya por `us-east-1` el correspondiente Región de AWS, `123456789012` sustitúyalo por el Cuenta de AWS número correspondiente y `12345678abcdefgh` sustitúyalo por el identificador de ubicación de origen correspondiente. 1. Para el parámetro `--destination-location-arn`, especifique el ARN de la ubicación de destino en la transferencia. Sustituya por `us-east-1` el correspondiente Región de AWS, `123456789012` sustitúyalo por el Cuenta de AWS número correspondiente y `abcdefgh12345678` sustitúyalo por el identificador de ubicación de destino correspondiente. 1. Para el parámetro `--task-report-config`, haga lo siguiente: + `Subdirectory`— `reports/` Sustitúyalo por el prefijo del bucket de S3 en el que desee DataSync cargar los informes de tareas. Asegúrese de incluir el carácter delimitador adecuado al final del prefijo. Este carácter normalmente es una barra inclinada (`/`). Para obtener más información, consulte [Organizar objetos con prefijos](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-prefixes.html) en la *Guía del usuario de Amazon S3*. + `S3BucketArn`: especifique el ARN del bucket de S3 donde desea cargar su informe de tareas. **sugerencia** Si planea transferir datos a un bucket de S3, no utilice el mismo bucket para el informe de tareas si [desactiva la opción **Conservar los archivos eliminados**](configure-metadata.md). De lo contrario, DataSync eliminará todos los informes de tareas anteriores cada vez que ejecute una tarea, ya que esos informes no existen en su ubicación de origen. + `BucketAccessRoleArn`— Especifique la función de IAM que permite DataSync cargar un informe de tareas en su bucket de S3. Para obtener más información, consulte [Permite DataSync cargar informes de tareas a tu bucket de S3](#task-report-access). **importante** Si su depósito de S3 está cifrado con una clave SSE-KMS gestionada por el cliente, la política de la clave debe incluir la función de IAM que se DataSync utiliza para acceder al depósito. Para obtener más información, consulte [Acceso a buckets de S3 mediante el cifrado del servidor](create-s3-location.md#create-s3-location-encryption). + `OutputType`: especifique el informe de `STANDARD`. Para obtener más información, consulte [Informes de tareas estándar](task-reports.md#task-report-types-standard)Tipos de informes de tareas. + (Opcional) `ReportLevel`: especifique si desea `ERRORS_ONLY` (opción predeterminada) o `SUCCESSES_AND_ERRORS` en su informe. + (Opcional) `ObjectVersionIds`: si va a realizar la transferencia a un bucket de S3 que utiliza el control de versiones de objetos, especifique `NONE` si no desea incluir la nueva versión para cada objeto transferido en el informe. Esta opción está configurada en `INCLUDE` de forma predeterminada. + (Opcional) `Overrides`: personalice el `ReportLevel` de un aspecto concreto del informe. Por ejemplo, es posible que desee consultar `SUCCESSES_AND_ERRORS` la lista de lo que se DataSync elimina en su ubicación de destino, pero `ERRORS_ONLY` prefiera ver todo lo demás. En este ejemplo, añadiría la siguiente opción `Overrides` al parámetro `--task-report-config`: ``` "Overrides":{ "Deleted":{ "ReportLevel":"SUCCESSES_AND_ERRORS" } } ``` Si no usa `Overrides`, todo el informe usará el `ReportLevel` que usted especifique. 1. Ejecute el comando `create-task` para crear la tarea. Obtendrá una respuesta como la siguiente, en la que se muestra el ARN de la tarea que ha creado. Necesitará este ARN para ejecutar el comando `start-task-execution`. ``` { "TaskArn": "arn:aws:datasync:us-east-1:123456789012:task/task-12345678abcdefgh" } ``` 1. Copie el siguiente comando `start-task-execution`. ``` aws datasync-task-report start-task-execution \ --task-arn arn:aws:datasync:us-east-1:123456789012:task/task-12345678abcdefgh ``` 1. Para el parámetro `--task-arn`, especifique el ARN de la tarea que está ejecutando. Utilice el ARN que ha recibido al ejecutar el comando `create-task`. 1. Ejecute el comando `start-task-execution`. Cuando se complete la transferencia, podrá [ver el informe de la tarea](task-report-viewing.md). # Ver tus informes de DataSync tareas DataSync crea informes de tareas para cada ejecución de tareas. Cuando la ejecución se complete, encontrará el informe de la tarea pertinente en su bucket de S3. Los informes de tareas se organizan con prefijos que incluyen IDs las tareas y sus ejecuciones. Para ayudar a localizar los informes de tareas en el bucket de S3, utilice estos ejemplos: + **Informe de tareas de tipo solo resumen**: `reports-prefix/Summary-Reports/task-id-folder/task-execution-id-folder` + **Informe de tareas estándar**: `reports-prefix/Detailed-Reports/task-id-folder/task-execution-id-folder` Como los informes de tareas están en formato JSON, tiene varias opciones para verlos: + Visualizar un informe con [Amazon S3 Select](https://docs.aws.amazon.com/AmazonS3/latest/userguide/selecting-content-from-objects.html). + Visualice los informes mediante AWS servicios como AWS Glue Amazon Athena y Amazon Quick. Para obtener más información sobre la visualización de los informes de tareas, consulte el [blog sobre almacenamiento de AWS](https://aws.amazon.com/blogs/storage/derive-insights-from-aws-datasync-task-reports-using-aws-glue-amazon-athena-and-amazon-quicksight/). # Supervisión de las transferencias de datos con Amazon CloudWatch Logs Puede supervisar su AWS DataSync transferencia mediante CloudWatch los registros. Recomendamos configurar la tarea para que registre, como mínimo, información básica (como errores de transferencia). ## DataSync Permitir cargar registros a un grupo de CloudWatch registros Para [configurar el registro](#configure-logging-for-task) de su DataSync tarea, necesita un grupo de CloudWatch registros que DataSync tenga permiso para enviar registros. Este acceso se configura mediante un rol AWS Identity and Access Management (IAM). El funcionamiento específico depende del [modo de la tarea](choosing-task-mode.md). ------ #### [ Enhanced mode ] Con el modo mejorado, envía DataSync automáticamente los registros de tareas a un grupo de registros denominado`/aws/datasync`. Si ese grupo de registros no existe en la suya Región de AWS, DataSync crea el grupo de registros en su nombre mediante un [rol vinculado al servicio](https://docs.aws.amazon.com/datasync/latest/userguide/using-service-linked-roles-service-action-2.html) de IAM al crear la tarea. ------ #### [ Basic mode ] Existen dos formas de configurar un grupo de CloudWatch registros para una DataSync tarea mediante el modo Básico. En la consola, puede crear automáticamente un rol de IAM que, en la mayoría de los casos, incluya los permisos DataSync necesarios para cargar registros. Tenga en cuenta que es posible que este rol generado automáticamente no satisfaga sus necesidades desde el punto de vista de los privilegios mínimos. Si desea utilizar un grupo de CloudWatch registros existente o va a crear sus tareas mediante programación, debe crear el rol de IAM usted mismo. El siguiente ejemplo muestra una política de IAM que concede estos permisos. **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "DataSyncLogsToCloudWatchLogs", "Effect": "Allow", "Action": [ "logs:PutLogEvents", "logs:CreateLogStream" ], "Principal": { "Service": "datasync.amazonaws.com" }, "Condition": { "ArnLike": { "aws:SourceArn": [ "arn:aws:datasync:us-east-1:444455556666:task/*" ] }, "StringEquals": { "aws:SourceAccount": "444455556666" } }, "Resource": "arn:aws:logs:us-east-1:444455556666:log-group:*:*" } ] } ``` La política utiliza `Condition` declaraciones para garantizar que solo DataSync las tareas de la cuenta especificada tengan acceso al grupo de registros especificado CloudWatch . Recomendamos usar las claves de contexto de condición global [https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-sourcearn](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-sourcearn) y [https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-sourceaccount](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-sourceaccount) en estas declaraciones `Condition` para protegerse frente al problema de suplantación de privilegios. Para obtener más información, consulte [Prevención de la sustitución confusa entre servicios](cross-service-confused-deputy-prevention.md). Para especificar la DataSync tarea o las tareas, *`region`* sustitúyalo por el Región de AWS código de región de la ubicación de las tareas (por ejemplo,`us-west-2`) y *`account-id`* sustitúyelo por el Cuenta de AWS identificador de la cuenta que contiene las tareas. Para especificar el grupo de CloudWatch registros, sustituya los mismos valores. También puede modificar la declaración de `Resource` para que se dirija a grupos de registro específicos. Para obtener más información sobre el uso de `SourceArn` y `SourceAccount`, consulte [Claves de condición global](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-sourceaccount) en la *Guía del usuario de IAM*. Para aplicar la política, guarde esta instrucción en un archivo del equipo local. A continuación, ejecute el siguiente AWS CLI comando para aplicar la política de recursos. Para utilizar este comando de ejemplo, sustituya `full-path-to-policy-file` por la ruta del archivo que contiene la declaración de política. ``` aws logs put-resource-policy --policy-name trust-datasync --policy-document file://full-path-to-policy-file ``` **nota** Ejecute este comando utilizando el mismo Cuenta de AWS Región de AWS lugar donde activó su DataSync agente. Para obtener más información, consulta la [https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html). ------ ## Configurar el registro para su DataSync tarea Se recomienda configurar al menos algún nivel de registro para la DataSync tarea. **Antes de empezar** DataSync necesita permiso para cargar registros en un grupo de CloudWatch registros. Para obtener más información, consulte [DataSync Permitir cargar registros a un grupo de CloudWatch registros](#cloudwatchlogs). ### Uso de la DataSync consola Las siguientes instrucciones describen cómo configurar el CloudWatch registro al crear una tarea. También puede configurar el registro al editar una tarea. 1. Abra la AWS DataSync consola en [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/). 1. En el panel de navegación situado a la izquierda, expanda **Transferencia de datos**; luego, seleccione **Tareas** y, a continuación, seleccione **Crear tarea**. 1. Configure las ubicaciones de origen y destino de la tarea. Para obtener más información, consulte [¿Dónde puedo transferir mis datos AWS DataSync?](working-with-locations.md) 1. En la página **Configurar ajustes**, seleccione un [modo de tarea](choosing-task-mode.md) y cualquier otra opción. Puede que te interesen algunas de las siguientes opciones: + Especifique qué datos desea transferir mediante un [manifiesto](transferring-with-manifest.md) o [filtros](filtering.md). + Configure cómo [gestionar los metadatos de los archivos](configure-metadata.md) y [verificar la integridad de los datos](configure-data-verification-options.md). 1. En **Registro**, elija una de las siguientes opciones: + **Registrar información básica, como los errores de transferencia**: publique registros solo con la información básica (como los errores de transferencia). + **Registrar todos los objetos y archivos transferidos**: publique los registros de todos los archivos u objetos que DataSync transfiera y compruebe la integridad de los datos. + **No generar registros** 1. Realice una de las siguientes acciones en función del modo de tarea que utilice para crear o especificar un grupo de CloudWatch registros: ------ #### [ Enhanced mode ] Al elegir **Crear tarea**, utiliza (o crea) DataSync automáticamente un grupo de registros denominado`/aws/datasync`. ------ #### [ Basic mode ] En el **CloudWatch caso de un grupo** de registros, especifique un grupo de registros en el que DataSync tenga permiso para cargar registros mediante una de las siguientes acciones: + Elija **Generar automáticamente** para crear automáticamente un grupo de registros que permita DataSync cargar registros en él. + Elija un grupo de registro ya existente en la Región de AWS actual. Si elige un grupo de registros existente, asegúrese de que [DataSync tiene permiso](#cloudwatchlogs) para cargar registros en ese grupo de registros. ------ 1. Seleccione **Crear tarea**. Ya está listo para [comenzar su tarea](run-task.md). ### Usando el AWS CLI 1. Copie el siguiente comando `create-task`: ``` aws datasync create-task \ --source-location-arn "arn:aws:datasync:us-east-1:account-id:location/location-id" \ --destination-location-arn "arn:aws:datasync:us-east-1:account-id:location/location-id" \ --task-mode "ENHANCED-or-BASIC" \ --name "task-name" \ --options '{"LogLevel": "log-level"}' \ --cloudwatch-log-group-arn "arn:aws:logs:us-east-1:account-id:log-group:log-group-name:*" ``` 1. Para `--source-location-arn`, especifique el nombre de recurso de Amazon (ARN) de la ubicación de origen. 1. Para `--destination-location-arn`, especifique el ARN de la ubicación de destino. Si realizas una transferencia entre Regiones de AWS nuestras cuentas, asegúrate de que el ARN incluya la otra región o ID de cuenta. 1. En `--task-mode`, especifique `ENHANCED` o `BASIC`. 1. (Recomendado) Para`--name`, especifique un nombre para la tarea que pueda recordar. 1. En `LogLevel`, especifique una de las siguientes opciones: + `BASIC`: publicar registros con solo información básica (como errores de transferencia). + `TRANSFER`— Publique los registros de todos los archivos u objetos que DataSync transfiera y compruebe la integridad de los datos. + `NONE`: no generar registros. 1. Para -`-cloudwatch-log-group-arn`, especifique el ARN de un grupo de CloudWatch registros. **importante** Si `--task-mode` es `ENHANCED`, no necesita especificar esta opción. Para obtener más información, consulte [DataSync Permitir cargar registros a un grupo de CloudWatch registros](#cloudwatchlogs). 1. Ejecute el comando `create-task`. Si el comando se ejecuta correctamente, recibirá una respuesta que le mostrará el ARN de la tarea que creó. Por ejemplo: ``` { "TaskArn": "arn:aws:datasync:us-east-1:111222333444:task/task-08de6e6697796f026" } ``` Ya está listo para [comenzar su tarea](run-task.md). ### Uso de la API DataSync Puede configurar el CloudWatch registro de la tarea mediante el `CloudWatchLogGroupArn` parámetro con cualquiera de las siguientes operaciones: + [https://docs.aws.amazon.com/datasync/latest/userguide/API_CreateTask.html](https://docs.aws.amazon.com/datasync/latest/userguide/API_CreateTask.html) + [https://docs.aws.amazon.com/datasync/latest/userguide/API_UpdateTask.html](https://docs.aws.amazon.com/datasync/latest/userguide/API_UpdateTask.html) ## Visualización de los registros de DataSync tareas Al [iniciar la tarea](run-task.md), puede ver los registros de ejecución de la tarea mediante la CloudWatch consola o AWS CLI (entre otras opciones). Para obtener más información, consulta la [https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html). DataSync proporciona registros estructurados en JSON para las tareas del modo mejorado. Las tareas en modo básico generan registros no estructurados. Los siguientes ejemplos muestran cómo se presentan los errores de verificación en los registros del modo mejorado en comparación con los registros del modo básico. ------ #### [ Enhanced mode log example ] ``` { "Action": "VERIFY", "Source": { "LocationId": "loc-abcdef01234567890", "RelativePath": "directory1/directory2/file1.txt" }, "Destination": { "LocationId": "loc-05ab2fdc272204a5f", "RelativePath": "directory1/directory2/file1.txt", "Metadata": { "Type": "Object", "ContentSize": 66060288, "LastModified": "2024-10-03T20:46:58Z", "S3": { "SystemMetadata": { "ContentType": "binary/octet-stream", "ETag": "\"1234abcd5678efgh9012ijkl3456mnop\"", "ServerSideEncryption": "AES256" }, "UserMetadata": { "file-mtime": "1602647222/222919600" }, "Tags": {} } } }, "ErrorCode": "FileNotAtSource", "ErrorDetail": "Verification failed due to file being present at the destination but not at the source" } ``` ------ #### [ Basic mode log example ] ``` [NOTICE] Verification failed > /directory1/directory2/file1.txt [NOTICE] /directory1/directory2/file1.txt dstMeta: type=R mode=0755 uid=65534 gid=65534 size=8972938 atime=1728657659/0 mtime=1728657659/0 extAttrsHash=0 [NOTICE] dstHash: f9c2cca900301d38b0930367d8d587153154af467da0fdcf1bebc0848ec72c0d ``` ------ # Registrar llamadas a la AWS DataSync API con AWS CloudTrail AWS DataSync está integrado con AWS CloudTrail un servicio que proporciona un registro de las acciones realizadas por un usuario, un rol o una persona Servicio de AWS . DataSync CloudTrail captura todas las llamadas a la API DataSync como eventos. Las llamadas que se capturan incluyen las llamadas desde la DataSync consola y las llamadas en código a las operaciones de la DataSync API. Si crea una ruta, puede habilitar la entrega continua de CloudTrail eventos a un bucket de Amazon S3, incluidos los eventos para AWS DataSync. Si no configura una ruta, podrá ver los eventos más recientes en la CloudTrail consola, en el **historial de eventos**. Con la información recopilada por usted CloudTrail, puede determinar a AWS DataSync qué dirección IP se realizó la solicitud, quién la realizó, cuándo se realizó y detalles adicionales. Para obtener más información CloudTrail, consulte la [Guía AWS CloudTrail del usuario](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/). ## Trabajar con DataSync información en CloudTrail CloudTrail está activado en tu cuenta Cuenta de AWS al crear la cuenta. Cuando se produce una actividad en AWS DataSync, esa actividad se registra en un CloudTrail evento junto con otros Servicio de AWS eventos del **historial de eventos**. Puedes ver, buscar y descargar eventos recientes en tu Cuenta de AWS. Para obtener más información, consulte [Visualización de eventos con el historial de CloudTrail eventos](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html). Para mantener un registro continuo de eventos en la Cuenta de AWS, incluidos los eventos de AWS DataSync, cree un registro de seguimiento. Un *rastro* permite CloudTrail entregar archivos de registro a un bucket de Amazon S3. De forma predeterminada, cuando se crea un registro de seguimiento en la consola, el registro de seguimiento se aplica a todas las Regiones de AWS. La ruta registra todos los eventos Regiones de AWS de la misma AWS partición y entrega los archivos de registro al bucket de Amazon S3 que especifique. Además, puede configurar otros Servicios de AWS para que analicen más a fondo los datos de eventos recopilados en los CloudTrail registros y actúen en función de ellos. Para más información, consulte los siguientes temas: + [Introducción a la creación de registros de seguimiento](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html) + [CloudTrail servicios e integraciones compatibles](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations) + [Configuración de las notificaciones de Amazon SNS para CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/configure-sns-notifications-for-cloudtrail.html) + [Recibir archivos de CloudTrail registro de varias regiones](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html) y [recibir archivos de CloudTrail registro de varias cuentas](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html) Todas DataSync las acciones son registradas por CloudTrail. (Para obtener más información, consulta la [referencia DataSync de la API](https://docs.aws.amazon.com/datasync/latest/userguide/API_Operations.html)). Por ejemplo, las llamadas a las `ListLocations` operaciones `CreateAgent``CreateTask`, y generan entradas en los archivos de CloudTrail registro. Cada entrada de registro o evento contiene información sobre quién generó la solicitud. La información de identidad del usuario le ayuda a determinar lo siguiente: + Si la solicitud se realizó con credenciales raíz o AWS Identity and Access Management (IAM). + Si la solicitud se realizó con credenciales de seguridad temporales de un rol o fue un usuario federado. + Si la solicitud la realizó otro Servicio de AWS. Para obtener más información, consulte el [CloudTrailuserIdentityelemento](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html) de la *Guía del AWS CloudTrail usuario*. ## Descripción de las entradas de los archivos de DataSync registro Un rastro es una configuración que permite la entrega de eventos como archivos de registro a un bucket de Amazon S3 que usted especifique. CloudTrail Los archivos de registro contienen una o más entradas de registro. Un evento representa una solicitud única de cualquier fuente e incluye información sobre la acción solicitada, la fecha y la hora de la acción, los parámetros de la solicitud, etc. CloudTrail Los archivos de registro no son un registro ordenado de las llamadas a la API pública, por lo que no aparecen en ningún orden específico. En el siguiente ejemplo, se muestra una entrada de CloudTrail registro que demuestra la `CreateTask` operación. ``` { "eventVersion": "1.05", "userIdentity": { "type": "IAMUser", "principalId": "1234567890abcdef0", "arn": "arn:aws:iam::123456789012:user/user1", "accountId": "123456789012", "accessKeyId": "access key", "userName": "user1", "sessionContext": { "attributes": { "mfaAuthenticated": "false", "creationDate": "2018-12-13T14:56:46Z" } }, "invokedBy": "signin.amazonaws.com" }, "eventTime": "2018-12-13T14:57:02Z", "eventSource": "datasync.amazonaws.com", "eventName": "CreateTask", "awsRegion": "ap-southeast-1", "sourceIPAddress": "192.0.2.1", "userAgent": "signin.amazonaws.com", "requestParameters": { "cloudWatchLogGroupArn": "arn:aws:logs:ap-southeast-1:123456789012:log-group:MyLogGroup", "name": "MyTask-NTIzMzY1", "tags": [], "destinationLocationArn": "arn:aws:datasync:ap-southeast-1:123456789012:location/loc-abcdef01234567890", "options": { "bytesPerSecond": -1, "verifyMode": "POINT_IN_TIME_CONSISTENT", "uid": "INT_VALUE", "posixPermissions": "PRESERVE", "mtime": "PRESERVE", "gid": "INT_VALUE", "preserveDevices": "NONE", "preserveDeletedFiles": "REMOVE", "atime": "BEST_EFFORT" }, "sourceLocationArn": "arn:aws:datasync:ap-southeast-1:123456789012:location/loc-021345abcdef6789" }, "responseElements": { "taskArn": "arn:aws:datasync:ap-southeast-1:123456789012:task/task-1234567890abcdef0" }, "requestID": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "eventID": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "eventType": "AwsApiCall", "recipientAccountId": "123456789012" } ``` # Supervisión de eventos mediante Amazon EventBridge EventBridge Los eventos de Amazon describen los cambios en DataSync los recursos. Puede configurar reglas para asignar estos eventos y dirigirlos a una o más secuencias o funciones de destino. Los eventos se emiten en la medida de lo posible. ## DataSync eventos de transferencia Los siguientes EventBridge eventos están disponibles para DataSync transferencias. | **Agent state changes** | | --- | | Evento | Descripción | | Online | El agente está configurado correctamente y listo para su uso. Este es el estado de ejecución normal de un agente. | | Sin conexión | El agente ha estado fuera de contacto con el DataSync servicio durante cinco minutos o más. Esto puede suceder por varias razones. Para obtener más información, consulte [¿Qué hago si mi agente está desconectado?](troubleshooting-datasync-agents.md#troubleshoot-agent-offline) | | **Location state changes** | | --- | | Evento | Descripción | | ¿Agregando | DataSync es añadir una ubicación. | | Disponible | La ubicación se ha creado y se encuentra disponible para su uso. | | **Task state changes** | | --- | | Evento | Descripción | | Disponible | La tarea se creó y está lista para empezar. | | Ejecutar | La tarea está en curso y funciona correctamente. | | No disponible | La tarea no está configurada correctamente y no se puede utilizar. Es posible que vea este evento cuando un agente asociado a la tarea se desconecte. | | En cola | Otra tarea consiste en ejecutar y utilizar el mismo agente. DataSync ejecuta las tareas en serie (primero en entrar, primero en salir). | | **Task execution state changes** | | --- | | Evento | Descripción | | En cola | La ejecución de otra tarea consiste en ejecutar y utilizar el mismo DataSync agente. Para obtener más información, consulte [Saber cuándo la tarea está en cola](run-task.md#queue-task-execution). | | Launching (inicio o lanzamiento) | DataSync está inicializando la ejecución de la tarea. Este estado por lo general se realiza rápidamente, pero puede tardar hasta varios minutos. | | Preparación | DataSync está determinando qué datos se van a transferir. Este paso puede tardar desde unos minutos hasta varias horas, según el número de archivos, objetos o directorios en ambas ubicaciones y la forma en que configure la tarea. Es posible que la preparación no sea aplicable a la tarea. Para obtener más información, consulte [¿Cómo DataSync se prepara la transferencia de datos](how-datasync-transfer-works.md#how-datasync-prepares). | | Transferencia | DataSync está realizando la transferencia de datos real. | | Verificando | DataSync está realizando una comprobación de la integridad de los datos al final de la transferencia. | | Success | La ejecución de la tarea se realizó correctamente. | | Cancelling | La ejecución de la tarea está en proceso de ser cancelada. | | Error | Falló la ejecución de la tarea. | # Supervisión AWS DataSync con herramientas manuales Puedes realizar un seguimiento de tus AWS DataSync transferencias desde la consola o la línea de comandos. ## Supervise su transferencia mediante la DataSync consola Puedes monitorear tu DataSync transferencia mediante la consola, que proporciona métricas en tiempo real, como los datos transferidos, el rendimiento de datos y archivos y la compresión de datos. **Para supervisar la transferencia mediante la consola DataSync** 1. Tras [iniciar la DataSync tarea](run-task.md#starting-task), selecciona **Ver detalles de la ejecución**. 1. Consulte las métricas de su transferencia. ## Supervise su transferencia mediante el AWS CLI Puede supervisar su DataSync transferencia mediante el AWS Command Line Interface (AWS CLI). Copie el siguiente comando `describe-task-execution`. Para utilizar este comando de ejemplo, sustituya `user input placeholders` por su propia información. ``` aws datasync describe-task-execution \ --task-execution-arn 'arn:aws:datasync:region:account-id:task/task-id/execution/task-execution-id' ``` Este comando devuelve información acerca de la ejecución de una tarea similar a la que se muestra a continuación. ``` { "BytesCompressed": 3500, "BytesTransferred": 5000, "BytesWritten": 5000, "EstimatedBytesToTransfer": 5000, "EstimatedFilesToDelete": 10, "EstimatedFilesToTransfer": 100, "FilesDeleted": 10, "FilesSkipped": 0, "FilesTransferred": 100, "FilesVerified": 100, "Result": { "ErrorCode": "??????", "ErrorDetail": "??????", "PrepareDuration": 100, "PrepareStatus": "SUCCESS", "TransferDuration": 60, "TransferStatus": "AVAILABLE", "VerifyDuration": 30, "VerifyStatus": "SUCCESS" }, "StartTime": 1532660733.39, "Status": "SUCCESS", "OverrideOptions": { "Atime": "BEST_EFFORT", "BytesPerSecond": "1000", "Gid": "NONE", "Mtime": "PRESERVE", "PosixPermissions": "PRESERVE", "PreserveDevices": "NONE", "PreserveDeletedFiles": "PRESERVE", "Uid": "NONE", "VerifyMode": "POINT_IN_TIME_CONSISTENT" }, "TaskExecutionArn": "arn:aws:datasync:us-east-1:111222333444:task/task-aaaabbbbccccddddf/execution/exec-1234abcd1234abcd1", "TaskReportConfig": { "Destination": { "S3": { "BucketAccessRoleArn": "arn:aws:iam::111222333444:role/my-datasync-role", "S3BucketArn": "arn:aws:s3:::amzn-s3-demo-bucket/*", "Subdirectory": "reports" } }, "ObjectVersionIds": "INCLUDE", "OutputType": "STANDARD", "Overrides": { "Deleted": { "ReportLevel": "ERRORS_ONLY" }, "Skipped": { "ReportLevel": "SUCCESSES_AND_ERRORS" }, "Transferred": { "ReportLevel": "ERRORS_ONLY" }, "Verified": { "ReportLevel": "ERRORS_ONLY" } }, "ReportLevel": "ERRORS_ONLY" } } ``` + Si la ejecución de la tarea se realiza correctamente, el valor de **Status (Estado)** cambia a **SUCCESS (CORRECTO)**. Para obtener información sobre el significado de los elementos de respuesta, consulte [DescribeTaskExecution](API_DescribeTaskExecution.md). + Si se produce un error en la ejecución, el resultado envía códigos de error que pueden ayudarle a solucionar problemas. Para obtener información sobre los códigos de error, consulte [TaskExecutionResultDetail](API_TaskExecutionResultDetail.md). ## Monitoreo de transferencias mediante la utilidad `watch` Para monitorizar el progreso de su tarea en tiempo real desde la línea de comandos, puede utilizar la utilidad Unix `watch` estándar. Los valores de duración de la ejecución de la tarea se miden en milisegundos. La `watch` utilidad no reconoce el DataSync alias. En el siguiente ejemplo, se muestra cómo invocar la CLI directamente. Para utilizar este comando de ejemplo, sustituya `user input placeholders` por su propia información. ``` # pass '-n 1' to update every second and '-d' to highlight differences $ watch -n 1 -d \ "aws datasync describe-task-execution --task-execution-arn 'arn:aws:datasync:region:account-id:task/task-id/execution/task execution-id'" ```