# 使用 S3 复制指标
<a name="repl-metrics"></a>

S3 复制指标为复制配置中的复制规则提供了详细的指标。使用复制指标，您可以通过跟踪待复制的字节数、待复制的操作数、复制失败的操作数和复制延迟来逐分钟监控进度。

**注意**  
S3 复制指标的费率与 Amazon CloudWatch 自定义指标费率相同。有关更多信息，请参阅 [Amazon CloudWatch 定价](https://www.amazonaws.cn/cloudwatch/pricing/)。
如果您使用 S3 Replication Time Control，Amazon CloudWatch 在相应的复制规则上启用 S3 RTC 后 15 分钟开始报告复制指标。

启用 S3 Replication Time Control（S3 RTC）时，将自动开启 S3 复制指标。在[创建或编辑规则](replication-walkthrough1.md)时，还可以独立于 S3 RTC 启用 S3 复制指标。S3 RTC 包含其他功能，例如服务水平协议（SLA）和错过阈值的通知。有关更多信息，请参阅 [使用 S3 Replication Time Control 满足合规性要求](replication-time-control.md)。

启用 S3 复制指标后，Amazon S3 会将以下指标发布到 Amazon CloudWatch。系统将以最大努力传输 CloudWatch 指标。


| 指标名称 | 指标描述 | 该指标适用于哪些对象？ | 该指标在哪个区域发布？ | 如果删除了目标存储桶，仍会发布该指标吗？ | 如果不进行复制，仍会发布该指标吗？ | 
| --- | --- | --- | --- | --- | --- | 
| **待复制的字节数** | 给定复制规则的待复制对象的总字节数。 | 此指标仅适用于通过 S3 Cross-Region Replication（S3 CRR）或 S3 Same-Region Replication（S3 SRR）复制的新对象。 | 该指标发布在目标存储桶的区域中。 | 否 | 是 | 
| **复制延迟** | 对于给定的复制规则，复制目标存储桶落后于源存储桶的最大秒数。 | 此指标仅适用于使用 S3 CRR 或 S3 SRR 复制的新对象。 | 该指标发布在目标存储桶的区域中。 | 否 | 是 | 
| **待复制的操作** | 给定复制规则的待复制操作的数量。此指标跟踪与对象、删除标记、标签、访问控制列表（ACL）和 S3 对象锁定相关的操作。 | 此指标仅适用于使用 S3 CRR 或 S3 SRR 复制的新对象。 | 该指标发布在目标存储桶的区域中。 | 否 | 是 | 
| **复制失败的操作** | 给定复制规则的复制失败的操作数。此指标跟踪与对象、删除标记、标签、访问控制列表（ACL）和对象锁定相关的操作。<br />**复制失败的操作**跟踪以一分钟为间隔汇总的 S3 复制失败。要确定复制失败的特定对象及其失败原因，请在 Amazon S3 事件通知中订阅 `OperationFailedReplication` 事件。有关更多信息，请参阅 [使用 Amazon S3 事件通知接收复制失败事件](replication-metrics-events.md)。 | 此指标既适用于使用 S3 CRR 或 S3 SRR 复制的新对象，也适用于使用 S3 批量复制所复制的现有对象。 如果 S3 批量复制任务根本无法运行，则指标不会发送到 Amazon CloudWatch。例如，如果您没有运行 S3 批量复制任务所需的权限，或者复制配置中的标签或前缀不匹配，则您的任务将无法运行。  | 该指标发布在源存储桶的区域中。 | 是 | 否 | 

有关使用 CloudWatch 中的这些指标的信息，请参阅 [CloudWatch 中的 S3 复制指标](metrics-dimensions.md#s3-cloudwatch-replication-metrics)。

## 启用 S3 复制指标
<a name="enabling-replication-metrics"></a>

您可以开始将 S3 复制指标与新的或现有的复制规则结合使用。有关创建复制规则的完整说明，请参阅 [针对同一账户中的存储桶配置复制](replication-walkthrough1.md)。您可以选择将复制规则应用于整个 S3 存储桶，或应用于具有特定前缀或标签的 Amazon S3 对象。

本主题提供了在源和目标存储桶由相同或不同的 Amazon Web Services 账户拥有时，在复制配置中启用 S3 复制指标的说明。

要使用 Amazon Command Line Interface（Amazon CLI）启用复制指标，您必须向启用 `Metrics` 的源存储桶添加复制配置。在此示例配置中，以 `{{Tax}}` 为前缀的对象将复制到目标存储桶 `{{amzn-s3-demo-bucket}}`，并为这些对象生成指标。

```
{
    "Rules": [
        {
            "Status": "Enabled",
            "Filter": {
                "Prefix": "{{Tax}}"
            },
            "Destination": {
                "Bucket": "arn:aws:s3:::{{amzn-s3-demo-bucket}}",
                "Metrics": {
                    "Status": "Enabled"
                }
            },
            "Priority": 1
        }
    ],
    "Role": "{{IAM-Role-ARN}}"
}
```

## 查看复制指标
<a name="viewing-replication-metrics"></a>

在 Amazon S3 控制台中，可以在源通用存储桶的**指标**选项卡中查看 S3 复制指标。Amazon CloudWatch 控制台中也提供了这些 Amazon CloudWatch 指标。当您启用 S3 复制指标时，Amazon CloudWatch 会发出一些指标，您可以使用这些指标在复制规则级别跟踪待处理字节、待处理操作和复制延迟。

当您通过 Amazon S3 控制台或 Amazon S3 REST API 使用 S3 Replication Time Control（S3 RTC）启用复制时，S3 复制指标将自动开启。在[创建或编辑规则](replication-walkthrough1.md)时，还可以独立于 S3 RTC 启用 S3 复制指标。

如果您使用 S3 Replication Time Control，Amazon CloudWatch 在相应的复制规则上启用 S3 RTC 后 15 分钟开始报告复制指标。有关更多信息，请参阅 [使用 S3 复制指标](#repl-metrics)。

复制指标跟踪复制配置的规则 ID。复制规则 ID 可以特定于前缀、标签或两者的组合。

 有关 Amazon S3 的 CloudWatch 指标的更多信息，请参阅 [使用 Amazon CloudWatch 监控指标](cloudwatch-monitoring.md)。

**先决条件**  
创建启用了 S3 复制指标的复制规则。有关更多信息，请参阅 [启用 S3 复制指标](#enabling-replication-metrics)。

**通过源存储桶的**指标**选项卡查看 S3 复制指标**

1. 登录到 Amazon Web Services 管理控制台，然后通过以下网址打开 Amazon S3 控制台：[https://console.aws.amazon.com/s3/](https://console.amazonaws.cn/s3/)。

1. 在左侧导航窗格中，选择**通用存储桶**。

1. 在存储桶列表中，选择您要获取其复制指标的对象所在的源存储桶的名称。

1. 选择**指标**选项卡。

1. 在**复制指标**下，选择要查看其指标的复制规则。

1. 请选择 **Display charts (显示图表)**。

   Amazon S3 针对您选择的指标显示**复制延迟**、**待复制的字节数**、**待复制的操作**和**复制失败的操作**图表。