本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 使用 Amazon CloudWatch 指标监控数据传输
<a name="monitor-datasync"></a>

Amazon CloudWatch 提供了跟踪 DataSync 传输性能和解决传输任务问题的指标。

可使用 Amazon CloudWatch 指标监控 AWS DataSync 传输性能。DataSync 指标每隔 5 分钟自动发送至 CloudWatch（无论如何[配置日志记录](configure-logging.md)）。这些指标保留 15 个月的时间。

要查看 DataSync 的 CloudWatch 指标，您可以使用以下工具：
+ CloudWatch 控制台
+ CloudWatch CLI
+ CloudWatch API
+ DataSync 控制台（在任务执行的详细信息页面上）

有关更多信息，请参阅 [https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html)。

## DataSync 的 CloudWatch 指标
<a name="accessing-metrics"></a>

DataSync 指标使用 `aws/datasync` 命名空间并提供以下维度的指标：
+ **AgentId** — 代理的唯一 ID（如果任务使用代理）。
+ **TaskId** — 任务的唯一 ID。其格式为 `task-{{01234567890abcdef}}`。

`aws/datasync` 命名空间包括以下指标。某些指标并非适用于所有[任务模式](choosing-task-mode.md)。


| CloudWatch 指标 | 任务模式支持 | 描述 | 
| --- | --- | --- | 
| `BytesCompressed` | 基本 | DataSync 在压缩后通过网络传输的物理字节数（如果可以压缩）。除非数据不可压缩，否则该数字通常小于 `BytesTransferred`。<br />单位：字节 | 
| `BytesPreparedDestination` | 基本 | DataSync 在目标位置准备的逻辑字节数。<br />单位：字节 | 
| `BytesPreparedSource` | 基本 | DataSync 在源位置准备的逻辑字节数。<br />单位：字节 | 
| `BytesTransferred` | 基本 | DataSync 在压缩之前发送到网络的字节数（如果可以压缩）。有关通过网络传输的字节数，请参阅 `BytesCompressed` 指标。<br />单位：字节 | 
| `BytesVerifiedDestination` | 基本 | DataSync 在目标位置验证的逻辑字节数。<br />单位：字节 | 
| `BytesVerifiedSource` | 基本 | DataSync 在源位置验证的逻辑字节数。<br />单位：字节 | 
| `BytesWritten` | 增强、基本 | DataSync 写入目标位置的逻辑字节数。<br />单位：字节 | 
| `FilesDeleted` | 增强、基本 | DataSync 在目标位置删除的文件、对象和目录的数量。如果您未将[任务配置](configure-metadata.md#task-option-file-object-handling)为在目标位置中删除不存在于源位置的数据，则该值始终为 `0`。<br />单位：个 | 
| `FilesListedSource` | 增强 | DataSync 在您的源位置找到的对象的数量。<br />单位：个 | 
| `FilesPrepared` | 增强 | DataSync 在比较源位置和目标位置后将尝试传输的对象数量。有关更多信息，请参阅 [如何 DataSync 准备数据传输](how-datasync-transfer-works.md#how-datasync-prepares)。<br />如果您将任务配置为[传输所有数据](configure-metadata.md#task-option-transfer-mode)，则此指标不适用。在这种情况下，DataSync 将源中的所有内容复制到目标，而不比较位置之间的差异。<br />单位：个 | 
| `FilesPreparedDestination` | 基本 | DataSync 在目标位置准备的文件、对象和目录的数量。<br />单位：个 | 
| `FilesPreparedSource` | 基本 | DataSync 在源位置准备的文件、对象和目录的数量。<br />单位：个 | 
| `FilesSkipped` | 基本 | DataSync 在传输过程中跳过的文件、对象和目录的数量。<br />单位：个 | 
| `FilesTransferred` | 增强、基本 | DataSync 通过网络传输的文件、对象和目录的数量。在[任务执行](run-task.md#understand-task-execution-statuses)期间，当从源读取内容并通过网络发送内容时，该值会定期更新。 如果 DataSync 传输内容失败，在 [DescribeTaskExecution](https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeTaskExecution.html) 响应中，此值可以小于 `EstimatedFilesToTransfer`。在某些情况下，此值也可能大于 `EstimatedFilesToTransfer`。此指标特定于某些位置类型实施，因此请不要将其用作传输内容的准确指示，也不要用于监控任务执行情况。 <br />单位：个 | 
| `FilesVerified` | 增强 | DataSync 在传输过程中验证的对象的数量。<br />单位：个 | 
| `FilesVerifiedDestination` | 基本 | DataSync 在目标位置验证的文件、对象和目录的数量。<br />单位：个 | 
| `FilesVerifiedSource` | 基本 | DataSync 在源位置验证的文件、对象和目录的数量。<br />单位：个 |