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

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