

# 在 CloudWatch 中监控 S3 Storage Lens 存储统计管理工具指标
<a name="storage_lens_view_metrics_cloudwatch"></a>

您可以将 S3 Storage Lens 存储统计管理工具指标发布到 Amazon CloudWatch，以便在 [CloudWatch 控制面板](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html)中创建运营状况的统一视图。您还可以使用 CloudWatch 功能（如告警和触发操作、指标数学和异常检测）来监控 S3 Storage Lens 存储统计管理工具指标并采取措施。此外，CloudWatch API 操作使应用程序（包括第三方提供商）能够访问 S3 Storage Lens 存储统计管理工具指标。有关 CloudWatch 功能的更多信息，请参阅 [Amazon CloudWatch 用户指南](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html)。

您可以使用 Amazon S3 控制台、Amazon S3 REST API、AWS CLI 和 AWS SDK 针对新的或当前控制面板配置启用 CloudWatch 发布选项。升级到 S3 Storage Lens 存储统计管理工具 advanced metrics and recommendations（高级指标和建议）的控制面板可以使用 CloudWatch 发布选项。有关 S3 Storage Lens 存储统计管理工具高级指标和建议定价，请参阅 [Amazon S3 定价](https://aws.amazon.com/s3/pricing/)。不会收取其他 CloudWatch 指标发布费用；但是，其他 CloudWatch 费用（例如控制面板、告警和 API 调用）确实适用。有关更多信息，请参阅 [Amazon CloudWatch 定价](https://aws.amazon.com/cloudwatch/pricing/)。

S3 Storage Lens 指标在拥有 S3 Storage Lens 配置的账户中发布到 CloudWatch。在高级指标中启用 CloudWatch 发布选项后，您可以在 CloudWatch 中按配置 ID、账户、存储桶（仅适用于存储桶级指标）、区域和存储类别，访问账户级别和存储桶级别的指标。前缀级别的指标在 CloudWatch 中不可用。

**注意**  
S3 Storage Lens 存储统计管理工具指标是每日指标，每天发布到 CloudWatch 一次。当您在 CloudWatch 中查询 S3 Storage Lens 存储统计管理工具指标时，查询的期限必须为 1 天（86400 秒）。在您的每日 S3 Storage Lens 指标显示在 Amazon S3 控制台的 S3 Storage Lens 存储统计管理工具控制面板中后，这些指标可能需要几个小时才能显示在 CloudWatch 中。当您首次为 S3 Storage Lens 存储统计管理工具指标启用 CloudWatch 发布选项时，您的指标最多可能需要 24 小时才能将指标发布到 CloudWatch。

启用 CloudWatch 发布选项后，您可以使用以下 CloudWatch 功能监控和分析 S3 Storage lens 存储统计管理工具数据：
+ [Dashboards](storage-lens-cloudwatch-monitoring-cloudwatch.md#storage-lens-cloudwatch-monitoring-cloudwatch-dashboards)（控制面板）— 使用 CloudWatch 控制面板创建定制 S3 Storage Lens 存储统计管理工具控制面板。将您的 CloudWatch 控制面板与团队间无法直接访问您的 AWS 账户的人员、利益攸关方和组织外部的人员共享。
+ [Alarms and triggered actions](storage-lens-cloudwatch-monitoring-cloudwatch.md#storage-lens-cloudwatch-monitoring-cloudwatch-alarms)（告警和触发操作）— 配置监视指标的警报，并在超出阈值时采取行动。例如，您可以配置告警，当 **Incomplete Multipart Upload Bytes**（未完成分段上传字节）指标连续三天超过 1GB 时发送 Amazon SNS 通知。
+ [Anomaly detection](storage-lens-cloudwatch-monitoring-cloudwatch.md#storage-lens-cloudwatch-monitoring-cloudwatch-alarms)（异常检测）— 启用异常检测以持续分析指标、确定正常基线和表面异常。您可以根据指标的预期值创建异常检测告警。例如，您可以监视 **Object Lock Enabled Bytes**（启用对象锁定的字节）指标的异常情况，以检测未经授权移除对象锁定设置的情况。
+ [Metric math](storage-lens-cloudwatch-monitoring-cloudwatch.md#storage-lens-cloudwatch-monitoring-cloudwatch-metric-math)（指标数学）– 您还可以使用指标数学查询多个 S3 Storage Lens 存储统计管理工具指标，并使用数学表达式基于这些度量创建新的时间序列。例如，您可以通过将 `StorageBytes` 除以 `ObjectCount` 创建一个新指标来获得平均对象大小。

有关 S3 Storage Lens 存储统计管理工具指标的 CloudWatch 发布选项的更多信息，请参阅以下主题。

**Topics**
+ [S3 Storage Lens 存储统计管理工具指标和维度](storage-lens-cloudwatch-metrics-dimensions.md)
+ [为 S3 Storage Lens 存储统计管理工具启用 CloudWatch 发布](storage-lens-cloudwatch-enable-publish-option.md)
+ [在 CloudWatch 中结合使用 S3 Storage Lens 存储统计管理工具指标](storage-lens-cloudwatch-monitoring-cloudwatch.md)

# S3 Storage Lens 存储统计管理工具指标和维度
<a name="storage-lens-cloudwatch-metrics-dimensions"></a>

要将 S3 Storage Lens 存储统计管理工具指标发送到 CloudWatch，您必须在 S3 Storage Lens 存储统计管理工具高级指标中启用 CloudWatch 发布选项。启用高级指标后，您可以使用 [CloudWatch 控制面板](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html)与其他应用程序指标一起监控 S3 Storage Lens 存储统计管理工具指标，并创建运营状况的统一视图。您可以使用维度在 CloudWatch 中按企业、账户、桶、存储类别、区域和指标配置 ID 筛选 CloudWatch 中的 S3 Storage Lens 存储统计管理工具指标。

S3 Storage Lens 存储统计管理工具指标在拥有 S3 Storage Lens 存储统计管理工具配置的账户中发布到 CloudWatch。在高级指标中启用 CloudWatch 发布选项后，您可以在 CloudWatch 中按配置 ID、账户、存储桶（仅适用于存储桶级指标）、区域和存储类别，访问账户级别和存储桶级别的指标。前缀级别的指标在 CloudWatch 中不可用。

**注意**  
S3 Storage Lens 存储统计管理工具指标是每日指标，每天发布到 CloudWatch 一次。当您在 CloudWatch 中查询 S3 Storage Lens 存储统计管理工具指标时，查询的期限必须为 1 天（86400 秒）。在您的每日 S3 Storage Lens 指标显示在 Amazon S3 控制台的 S3 Storage Lens 存储统计管理工具控制面板中后，这些指标可能需要几个小时才能显示在 CloudWatch 中。当您首次为 S3 Storage Lens 存储统计管理工具指标启用 CloudWatch 发布选项时，您的指标最多可能需要 24 小时才能将指标发布到 CloudWatch。

有关 CloudWatch 中 S3 Storage Lens 存储统计管理工具指标和维度的更多信息，请参阅以下主题。

**Topics**
+ [指标](#storage-lens-cloudwatch-metrics)
+ [维度](#storage-lens-cloudwatch-dimensions)

## 指标
<a name="storage-lens-cloudwatch-metrics"></a>

S3 Storage Lens 存储统计管理工具指标在 CloudWatch 中作为指标提供。S3 Storage Lens 存储统计管理工具指标已发布到 `AWS/S3/Storage-Lens` 命名空间。此命名空间仅适用于 S3 Storage Lens 存储统计管理工具指标。Amazon S3 桶、请求和复制指标已发布到 `AWS/S3` 命名空间。

S3 Storage Lens 存储统计管理工具指标在拥有 S3 Storage Lens 存储统计管理工具配置的账户中发布到 CloudWatch。在高级指标中启用 CloudWatch 发布选项后，您可以在 CloudWatch 中按配置 ID、账户、存储桶（仅适用于存储桶级指标）、区域和存储类别，访问账户级别和存储桶级别的指标。前缀级别的指标在 CloudWatch 中不可用。

在 S3 Storage Lens 存储统计管理工具中，指标会聚合并仅存储在指定的主区域中。S3 Storage Lens 存储统计管理工具指标也发布到您在 S3 Storage Lens 存储统计管理工具配置中指定的主页区域中的 CloudWatch。

有关 S3 Storage Lens 存储统计管理工具指标的完整列表，包括 CloudWatch 中可用的指标列表，请参阅 [Amazon S3 Storage Lens 存储统计管理工具指标词汇表](storage_lens_metrics_glossary.md)。

**注意**  
CloudWatch 中 S3 Storage Lens 存储统计管理工具指标的有效统计数据是平均值。有关 CloudWatch 中统计信息的更多信息，请参阅 *Amazon CloudWatch 用户指南*中的 [CloudWatch 统计数据定义](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Statistics-definitions.html)。

### CloudWatch 中 S3 Storage Lens 存储统计管理工具指标的粒度
<a name="storage-lens-cloudwatch-metrics-granularity"></a>

S3 Storage Lens 存储统计管理工具提供企业、账户、桶和前缀粒度的指标。S3 Storage Lens 存储统计管理工具将企业、账户和桶级 S3 Storage Lens 存储统计管理工具指标发布到 CloudWatch。前缀级别的 S3 Storage Lens 存储统计管理工具指标在 CloudWatch 中不可用。

有关 CloudWatch 中可用 S3 Storage Lens 存储统计管理工具指标的粒度的更多信息，请参阅以下列表：
+ **Organization**（企业）— 在企业中的成员账户中聚合的指标。S3 Storage Lens 存储统计管理工具将成员账户的指标发布到管理账户中的 CloudWatch。
  + **Organization and account**（企业和账户）— 在企业中的成员账户指标。
  + **Organization and bucket**（企业和桶）— 在企业的成员账户中的 Amazon S3 桶指标。
+ **账户**（非企业级别）— 您账户中桶之间汇总的指标。
+ **桶**（非企业级别）— 特定桶的指标。在 CloudWatch 中，S3 Storage Lens 存储统计管理工具将这些指标发布至创建 S3 Storage Lens 存储统计管理工具配置的 AWS 账户。S3 Storage Lens 存储统计管理工具仅针对非企业配置发布这些指标。

## 维度
<a name="storage-lens-cloudwatch-dimensions"></a>

当 S3 Storage Lens 存储统计管理工具向 CloudWatch 发送数据时，维度附加到每个指标。维度是描述指标特征的类别。您可使用维度筛选 CloudWatch 返回的结果。

例如，CloudWatch 中的所有 S3 Storage Lens 存储统计管理工具指标都具有 `configuration_id` 维度。您可以使用此维度来区分与特定 S3 Storage Lens 存储统计管理工具配置关联的指标。`organization_id` 识别企业级指标。有关维度的更多信息，请参阅 *CloudWatch User Guide*（CloudWatch 用户指南）中的 [Dimensions](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#Dimension)（维度）。

S3 Storage Lens 存储统计管理工具指标有不同的维度，具体取决于指标的粒度。例如，您可以使用 `organization_id` 维度按照 AWS Organizations ID 筛选企业级的指标。但是，您不能将此维度用于桶和账户级指标。有关更多信息，请参阅 [使用维度筛选指标](storage-lens-cloudwatch-monitoring-cloudwatch.md#storage-lens-cloudwatch-monitoring-cloudwatch-dimensions)。

要查看哪些维度可用于 S3 Storage Lens 存储统计管理工具配置，请参阅下表。


|  **维度**  |  **说明**  |  **桶**  | ** 账户** |  **组织**  |  **组织和桶**  |  **组织和账户**  | 
| --- | --- | --- | --- | --- | --- | --- | 
| configuration\$1id |  指标中报告的 S3 Storage Lens 存储统计管理工具配置的控制面板名称  | ![\[Yes\]](http://docs.aws.amazon.com/zh_cn/AmazonS3/latest/userguide/images/icon-yes.png)  | ![\[Yes\]](http://docs.aws.amazon.com/zh_cn/AmazonS3/latest/userguide/images/icon-yes.png)  | ![\[Yes\]](http://docs.aws.amazon.com/zh_cn/AmazonS3/latest/userguide/images/icon-yes.png)  | ![\[Yes\]](http://docs.aws.amazon.com/zh_cn/AmazonS3/latest/userguide/images/icon-yes.png)  | ![\[Yes\]](http://docs.aws.amazon.com/zh_cn/AmazonS3/latest/userguide/images/icon-yes.png)  | 
| metrics\$1version |  S3 Storage Lens 存储统计管理工具指标的版本。指标版本的固定值为 `1.0`。  | ![\[Yes\]](http://docs.aws.amazon.com/zh_cn/AmazonS3/latest/userguide/images/icon-yes.png)  | ![\[Yes\]](http://docs.aws.amazon.com/zh_cn/AmazonS3/latest/userguide/images/icon-yes.png)  | ![\[Yes\]](http://docs.aws.amazon.com/zh_cn/AmazonS3/latest/userguide/images/icon-yes.png)  | ![\[Yes\]](http://docs.aws.amazon.com/zh_cn/AmazonS3/latest/userguide/images/icon-yes.png)  | ![\[Yes\]](http://docs.aws.amazon.com/zh_cn/AmazonS3/latest/userguide/images/icon-yes.png)  | 
| organization\$1id |  指标的 AWS Organizations ID  | ![\[No\]](http://docs.aws.amazon.com/zh_cn/AmazonS3/latest/userguide/images/icon-no.png)  | ![\[No\]](http://docs.aws.amazon.com/zh_cn/AmazonS3/latest/userguide/images/icon-no.png)  | ![\[Yes\]](http://docs.aws.amazon.com/zh_cn/AmazonS3/latest/userguide/images/icon-yes.png)  | ![\[Yes\]](http://docs.aws.amazon.com/zh_cn/AmazonS3/latest/userguide/images/icon-yes.png)  | ![\[Yes\]](http://docs.aws.amazon.com/zh_cn/AmazonS3/latest/userguide/images/icon-yes.png)  | 
| aws\$1account\$1number | 与指标关联的 AWS 账户 | ![\[Yes\]](http://docs.aws.amazon.com/zh_cn/AmazonS3/latest/userguide/images/icon-yes.png)  | ![\[Yes\]](http://docs.aws.amazon.com/zh_cn/AmazonS3/latest/userguide/images/icon-yes.png)  | ![\[No\]](http://docs.aws.amazon.com/zh_cn/AmazonS3/latest/userguide/images/icon-no.png)  | ![\[Yes\]](http://docs.aws.amazon.com/zh_cn/AmazonS3/latest/userguide/images/icon-yes.png)  | ![\[Yes\]](http://docs.aws.amazon.com/zh_cn/AmazonS3/latest/userguide/images/icon-yes.png)  | 
| aws\$1region | 指标的 AWS 区域 | ![\[Yes\]](http://docs.aws.amazon.com/zh_cn/AmazonS3/latest/userguide/images/icon-yes.png)  | ![\[Yes\]](http://docs.aws.amazon.com/zh_cn/AmazonS3/latest/userguide/images/icon-yes.png)  | ![\[Yes\]](http://docs.aws.amazon.com/zh_cn/AmazonS3/latest/userguide/images/icon-yes.png)  | ![\[Yes\]](http://docs.aws.amazon.com/zh_cn/AmazonS3/latest/userguide/images/icon-yes.png)  | ![\[Yes\]](http://docs.aws.amazon.com/zh_cn/AmazonS3/latest/userguide/images/icon-yes.png)  | 
| bucket\$1name |  指标中报告的 S3 桶的名称  | ![\[Yes\]](http://docs.aws.amazon.com/zh_cn/AmazonS3/latest/userguide/images/icon-yes.png)  | ![\[No\]](http://docs.aws.amazon.com/zh_cn/AmazonS3/latest/userguide/images/icon-no.png)  | ![\[No\]](http://docs.aws.amazon.com/zh_cn/AmazonS3/latest/userguide/images/icon-no.png)  | ![\[Yes\]](http://docs.aws.amazon.com/zh_cn/AmazonS3/latest/userguide/images/icon-yes.png)  | ![\[No\]](http://docs.aws.amazon.com/zh_cn/AmazonS3/latest/userguide/images/icon-no.png)  | 
| storage\$1class |  指标中报告的桶的存储类  | ![\[Yes\]](http://docs.aws.amazon.com/zh_cn/AmazonS3/latest/userguide/images/icon-yes.png)  | ![\[Yes\]](http://docs.aws.amazon.com/zh_cn/AmazonS3/latest/userguide/images/icon-yes.png)  | ![\[Yes\]](http://docs.aws.amazon.com/zh_cn/AmazonS3/latest/userguide/images/icon-yes.png)  | ![\[Yes\]](http://docs.aws.amazon.com/zh_cn/AmazonS3/latest/userguide/images/icon-yes.png)  | ![\[Yes\]](http://docs.aws.amazon.com/zh_cn/AmazonS3/latest/userguide/images/icon-yes.png)  | 
| record\$1type |  指标的粒度：组织、账户、桶  | ![\[Yes\]](http://docs.aws.amazon.com/zh_cn/AmazonS3/latest/userguide/images/icon-yes.png) 桶 | ![\[Yes\]](http://docs.aws.amazon.com/zh_cn/AmazonS3/latest/userguide/images/icon-yes.png) 账户 | ![\[Yes\]](http://docs.aws.amazon.com/zh_cn/AmazonS3/latest/userguide/images/icon-yes.png) 桶 | ![\[Yes\]](http://docs.aws.amazon.com/zh_cn/AmazonS3/latest/userguide/images/icon-yes.png) 账户 | ![\[Yes\]](http://docs.aws.amazon.com/zh_cn/AmazonS3/latest/userguide/images/icon-yes.png) 企业 | 

# 为 S3 Storage Lens 存储统计管理工具启用 CloudWatch 发布
<a name="storage-lens-cloudwatch-enable-publish-option"></a>

您可以将 S3 Storage Lens 存储统计管理工具指标发布到 Amazon CloudWatch，以便在 [CloudWatch 控制面板](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html)中创建运营状况的统一视图。您还可以使用 CloudWatch 功能（如告警和触发操作、指标数学和异常检测）来监控 S3 Storage Lens 存储统计管理工具指标并采取措施。此外，CloudWatch API 操作使应用程序（包括第三方提供商）能够访问 S3 Storage Lens 存储统计管理工具指标。有关 CloudWatch 功能的更多信息，请参阅 [Amazon CloudWatch 用户指南](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html)。

S3 Storage Lens 存储统计管理工具指标在拥有 S3 Storage Lens 存储统计管理工具配置的账户中发布到 CloudWatch。在高级指标中启用 CloudWatch 发布选项后，您可以在 CloudWatch 中按配置 ID、账户、存储桶（仅适用于存储桶级指标）、区域和存储类别，访问账户级别和存储桶级别的指标。前缀级别的指标在 CloudWatch 中不可用。

您可以使用 Amazon S3 控制台、REST API、AWS CLI 和 AWS SDK 针对新的或当前控制面板配置启用 CloudWatch 支持。CloudWatch 发布选项可用于升级到 S3 Storage Lens 存储统计管理工具高级指标和建议。有关 S3 Storage Lens 存储统计管理工具高级指标和建议定价，请参阅 [Amazon S3 定价](https://aws.amazon.com/s3/pricing/)。不会收取其他 CloudWatch 指标发布费用；但是，其他 CloudWatch 费用（例如控制面板、告警和 API 调用）确实适用。

要启用 S3 Storage Lens 存储统计管理工具指标的 CloudWatch 发布选项，请参阅以下主题。

**注意**  
S3 Storage Lens 存储统计管理工具指标是每日指标，每天发布到 CloudWatch 一次。当您在 CloudWatch 中查询 S3 Storage Lens 存储统计管理工具指标时，查询的期限必须为 1 天（86400 秒）。在您的每日 S3 Storage Lens 指标显示在 Amazon S3 控制台的 S3 Storage Lens 存储统计管理工具控制面板中后，这些指标可能需要几个小时才能显示在 CloudWatch 中。当您首次为 S3 Storage Lens 存储统计管理工具指标启用 CloudWatch 发布选项时，您的指标最多可能需要 24 小时才能将指标发布到 CloudWatch。  
目前，S3 Storage Lens 存储统计管理工具指标无法通过 CloudWatch 流使用。

## 使用 S3 控制台
<a name="storage-lens-cloudwatch-enable-publish-console"></a>

更新 S3 Storage Lens 存储统计管理工具控制面板时，无法更改控制面板名称或主区域。您也不能更改原定设置控制面板的范围，其范围限于整个账户的存储。

**更新 S3 Storage Lens 存储统计管理工具控制面板以启用 CloudWatch 发布**

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

1. 在导航窗格中，依次选择 **S3 Storage Lens** 和 **Dashboards**（控制面板）。

1. 请选择要编辑的控制面板，然后选择 **Edit**（编辑）。

1. 在 **Metrics selection**（指标选择）下方，请选择 **Advanced metrics and recommendations**（高级指标和建议）。

   高级指标和建议可额外收费。高级指标和建议包括 15 个月的数据查询期、在前缀级别聚合的使用情况指标、按桶聚合的活动指标、CloudWatch 发布选项，以及帮助您优化存储成本和应用数据保护最佳做法的上下文建议。有关更多信息，请参阅 [Amazon S3 定价](https://aws.amazon.com/s3/pricing/)。

1. 在 **Select Advanced metrics and recommendations features**（选择高级指标和推荐功能）下方，选择 **CloudWatch publishing**（CloudWatch 发布）。
**重要**  
如果您的配置启用了使用情况指标的前缀聚合，则前缀级指标将不会发布到 CloudWatch。只有桶、账户和企业级 S3 Storage Lens 存储统计管理工具指标才会发布到 CloudWatch。

1. 选择**保存更改**。

**要创建启用 CloudWatch 支持的新 S3 Storage Lens 存储统计管理工具控制面板**

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

1. 在左侧导航窗格中，依次选择 **Storage Lens** 和 **Dashboards**（控制面板）。

1. 请选择**创建控制面板**。

1. 在 **General**（常规）下，定义以下配置选项：

   1. 对于 **Dashboard name**（控制面板名称），输入您的控制面板名称。

      控制面板名称必须少于 65 个字符，且不得包含特殊字符或空格。创建控制面板后，您无法更改此控制面板名称。

   1. 为控制面板选择 **Home Region**（主区域）。

      此控制面板范围内所有包含的所有区域的指标，都集中存储在此指定的主区域中。在 CloudWatch 中，S3 Storage Lens 存储统计管理工具指标也可在主区域提供。创建控制面板后，您无法更改主区域。

1. （可选）要添加标签，请选择 **Add tag **（添加标签），然后输入标签 **Key**（密钥）和 **Value**（值）。
**注意**  
您最多可以在控制面板配置中添加 50 个标签。

1. 定义配置的范围：

   1. 如果您正在创建组织级配置，请选择要包含在配置中的账户：**Include all accounts in your configuration**（在配置中包括所有账户）或者 **Limit the scope to your signed-in account**（将范围限制为您的登录账户）。
**注意**  
当您创建包含所有账户的组织级配置时，您只能包括或排除区域，而不能包括或排除桶。

   1. 通过执行以下操作，选择您希望 S3 Storage Lens 存储统计管理工具在控制面板配置中包括的区域和桶：
      + 要包含所有区域，请选择 **Include Regions and buckets**（包含区域和桶）。
      + 要包含特定的区域，请清除 **Include all Regions**（包含所有区域）。在 **Choose Regions to include**（选择要包含的区域）下方，请选择想要 S3 Storage Lens 存储统计管理工具包含在控制面板中的区域。
      + 要包含特定桶，请清除 **Include all buckets**（包含所有桶）。在 **Choose buckets to include**（选择要包含的桶）下方，请选择想要 S3 Storage Lens 存储统计管理工具包含在控制面板中的桶。
**注意**  
您最多可以选择 50 个桶。

1. 对于 **Metrics selection**（指标选择），请选择 **Advanced metrics and recommendations**（高级指标和建议）。

   有关高级指标和建议定价的资讯，请参阅 [Amazon S3 pricing](https://aws.amazon.com/s3/pricing/)（Amazon S3 定价）。

1. 在 **Advanced metrics and recommendations features**（高级指标和建议功能）下方，选择您要启用的选项：
   + **Advanced metrics（高级指标** 
   + **CloudWatch publishing（CloudWatch 发布**
**重要**  
如果您为 S3 Storage Lens 存储统计管理工具配置启用了前缀聚合，那么前缀级别的指标将不会发布到 CloudWatch。只有桶、账户和企业级 S3 Storage Lens 存储统计管理工具指标才会发布到 CloudWatch。
   + **Prefix aggregation（前缀聚合**
**注意**  
有关高级指标和建议功能的更多信息，请参阅[指标选择](storage_lens_basics_metrics_recommendations.md#storage_lens_basics_metrics_selection)。

1. 如果您启用了 **Advanced metrics**（高级指标），请选择要在 S3 Storage Lens 存储统计管理工具控制面板中显示的 **Advanced metrics categories**（高级指标类别）：
   + **活动指标**
   + **Detailed status code metrics（详细的状态代码指标**
   + **Advanced cost optimization metrics（高级成本优化指标**
   + **Advanced data protection metrics（高级数据保护指标**

   有关指标类别的更多信息，请参阅[指标类别](storage_lens_basics_metrics_recommendations.md#storage_lens_basics_metrics_types)。要获得指标的完整列表，请参阅 [Amazon S3 Storage Lens 存储统计管理工具指标词汇表](storage_lens_metrics_glossary.md)。

1. （可选）配置您的指标导出。

   有关如何配置指标导出的更多信息，请参阅步骤 [使用 S3 控制台](storage_lens_creating_dashboard.md#storage_lens_console_creating)。

1. 请选择**创建控制面板**。

## 使用 AWS CLI
<a name="storage-lens-cloudwatch-enable-publish-cli"></a>

以下 AWS CLI 示例将通过使用 S3 Storage Lens 存储统计管理工具组织级高级指标和建议配置启用 CloudWatch 发布选项。要使用此示例，请将 `user input placeholders` 替换为您自己的信息。

```
aws s3control put-storage-lens-configuration --account-id=555555555555 --config-id=your-configuration-id --region=us-east-1 --storage-lens-configuration=file://./config.json

config.json
{
  "Id": "SampleS3StorageLensConfiguration",
  "AwsOrg": {
    "Arn": "arn:aws:organizations::123456789012:organization/o-abcdefgh"
  },
  "AccountLevel": {
    "ActivityMetrics": {
      "IsEnabled":true
    },
    "AdvancedCostOptimizationMetrics": {
      "IsEnabled":true
    },
    "AdvancedDataProtectionMetrics": {
      "IsEnabled":true
    },
    "DetailedStatusCodesMetrics": {
      "IsEnabled":true
    },
    "BucketLevel": {
      "ActivityMetrics": {
        "IsEnabled":true
      },
      "AdvancedCostOptimizationMetrics": {
        "IsEnabled":true
      },
      "DetailedStatusCodesMetrics": {
        "IsEnabled":true
      },
      "PrefixLevel":{
        "StorageMetrics":{
          "IsEnabled":true,
          "SelectionCriteria":{
            "MaxDepth":5,
            "MinStorageBytesPercentage":1.25,
            "Delimiter":"/"
          }
        }
      }
    }
  },
  "Exclude": {
    "Regions": [
      "eu-west-1"
    ],
    "Buckets": [
      "arn:aws:s3:::amzn-s3-demo-source-bucket "
    ]
  },
  "IsEnabled": true,
  "DataExport": {
    "S3BucketDestination": {
      "OutputSchemaVersion": "V_1",
      "Format": "CSV",
      "AccountId": "111122223333",
      "Arn": "arn:aws:s3:::amzn-s3-demo-destination-bucket",
      "Prefix": "prefix-for-your-export-destination",
      "Encryption": {
        "SSES3": {}
      }
    },
    "CloudWatchMetrics": {
      "IsEnabled": true
    }
  }
}
```

## 使用适用于 Java 的 AWS 开发工具包
<a name="storage-lens-cloudwatch-enable-publish-sdk"></a>

```
package aws.example.s3control;

import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import com.amazonaws.auth.profile.ProfileCredentialsProvider;
import com.amazonaws.services.s3control.AWSS3Control;
import com.amazonaws.services.s3control.AWSS3ControlClient;
import com.amazonaws.services.s3control.model.AccountLevel;
import com.amazonaws.services.s3control.model.ActivityMetrics;
import com.amazonaws.services.s3control.model.BucketLevel;
import com.amazonaws.services.s3control.model.CloudWatchMetrics;
import com.amazonaws.services.s3control.model.Format;
import com.amazonaws.services.s3control.model.Include;
import com.amazonaws.services.s3control.model.OutputSchemaVersion;
import com.amazonaws.services.s3control.model.PrefixLevel;
import com.amazonaws.services.s3control.model.PrefixLevelStorageMetrics;
import com.amazonaws.services.s3control.model.PutStorageLensConfigurationRequest;
import com.amazonaws.services.s3control.model.S3BucketDestination;
import com.amazonaws.services.s3control.model.SSES3;
import com.amazonaws.services.s3control.model.SelectionCriteria;
import com.amazonaws.services.s3control.model.StorageLensAwsOrg;
import com.amazonaws.services.s3control.model.StorageLensConfiguration;
import com.amazonaws.services.s3control.model.StorageLensDataExport;
import com.amazonaws.services.s3control.model.StorageLensDataExportEncryption;
import com.amazonaws.services.s3control.model.StorageLensTag;

import java.util.Arrays;
import java.util.List;

import static com.amazonaws.regions.Regions.US_WEST_2;

public class CreateAndUpdateDashboard {

    public static void main(String[] args) {
        String configurationId = "ConfigurationId";
        String sourceAccountId = "Source Account ID";
        String exportAccountId = "Destination Account ID";
        String exportBucketArn = "arn:aws:s3:::amzn-s3-demo-destination-bucket"; // The destination bucket for your metrics export must be in the same Region as your S3 Storage Lens configuration.
        String awsOrgARN = "arn:aws:organizations::123456789012:organization/o-abcdefgh";
        Format exportFormat = Format.CSV;

        try {
            SelectionCriteria selectionCriteria = new SelectionCriteria()
                    .withDelimiter("/")
                    .withMaxDepth(5)
                    .withMinStorageBytesPercentage(10.0);
            PrefixLevelStorageMetrics prefixStorageMetrics = new PrefixLevelStorageMetrics()
                    .withIsEnabled(true)
                    .withSelectionCriteria(selectionCriteria);
            BucketLevel bucketLevel = new BucketLevel()
                    .withActivityMetrics(new ActivityMetrics().withIsEnabled(true))
                    .withAdvancedCostOptimizationMetrics(new AdvancedCostOptimizationMetrics().withIsEnabled(true))
                    .withAdvancedDataProtectionMetrics(new AdvancedDataProtectionMetrics().withIsEnabled(true))
                    .withDetailedStatusCodesMetrics(new DetailedStatusCodesMetrics().withIsEnabled(true))
                    .withPrefixLevel(new PrefixLevel().withStorageMetrics(prefixStorageMetrics));
            AccountLevel accountLevel = new AccountLevel()
                    .withActivityMetrics(new ActivityMetrics().withIsEnabled(true))
                    .withAdvancedCostOptimizationMetrics(new AdvancedCostOptimizationMetrics().withIsEnabled(true))
                    .withAdvancedDataProtectionMetrics(new AdvancedDataProtectionMetrics().withIsEnabled(true))
                    .withDetailedStatusCodesMetrics(new DetailedStatusCodesMetrics().withIsEnabled(true))
                    .withBucketLevel(bucketLevel);

            Include include = new Include()
                    .withBuckets(Arrays.asList("arn:aws:s3:::amzn-s3-demo-bucket"))
                    .withRegions(Arrays.asList("us-west-2"));

            StorageLensDataExportEncryption exportEncryption = new StorageLensDataExportEncryption()
                    .withSSES3(new SSES3());
            S3BucketDestination s3BucketDestination = new S3BucketDestination()
                    .withAccountId(exportAccountId)
                    .withArn(exportBucketArn)
                    .withEncryption(exportEncryption)
                    .withFormat(exportFormat)
                    .withOutputSchemaVersion(OutputSchemaVersion.V_1)
                    .withPrefix("Prefix");
            CloudWatchMetrics cloudWatchMetrics = new CloudWatchMetrics()
                    .withIsEnabled(true);
            StorageLensDataExport dataExport = new StorageLensDataExport()
                    .withCloudWatchMetrics(cloudWatchMetrics)
                    .withS3BucketDestination(s3BucketDestination);

            StorageLensAwsOrg awsOrg = new StorageLensAwsOrg()
                    .withArn(awsOrgARN);

            StorageLensConfiguration configuration = new StorageLensConfiguration()
                    .withId(configurationId)
                    .withAccountLevel(accountLevel)
                    .withInclude(include)
                    .withDataExport(dataExport)
                    .withAwsOrg(awsOrg)
                    .withIsEnabled(true);

            List<StorageLensTag> tags = Arrays.asList(
                    new StorageLensTag().withKey("key-1").withValue("value-1"),
                    new StorageLensTag().withKey("key-2").withValue("value-2")
            );

            AWSS3Control s3ControlClient = AWSS3ControlClient.builder()
                    .withCredentials(new ProfileCredentialsProvider())
                    .withRegion(US_WEST_2)
                    .build();

            s3ControlClient.putStorageLensConfiguration(new PutStorageLensConfigurationRequest()
                    .withAccountId(sourceAccountId)
                    .withConfigId(configurationId)
                    .withStorageLensConfiguration(configuration)
                    .withTags(tags)
            );
        } catch (AmazonServiceException e) {
            // The call was transmitted successfully, but Amazon S3 couldn't process
            // it and returned an error response.
            e.printStackTrace();
        } catch (SdkClientException e) {
            // Amazon S3 couldn't be contacted for a response, or the client
            // couldn't parse the response from Amazon S3.
            e.printStackTrace();
        }
    }
}
```

## 使用 REST API
<a name="storage-lens-cloudwatch-enable-publish-api"></a>

要使用 Amazon S3 REST API 启用 CloudWatch 发布选项，您可以使用 [https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_PutStorageLensConfiguration.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_PutStorageLensConfiguration.html)。

**后续步骤**  
启用 CloudWatch 发布选项后，您可以在 CloudWatch 中访问 S3 Storage Lens 存储统计管理工具指标。您还可以利用 CloudWatch 功能在 CloudWatch 中监控和分析 S3 Storage Lens 存储统计管理工具数据。有关更多信息，请参阅以下主题：
+ [S3 Storage Lens 存储统计管理工具指标和维度](storage-lens-cloudwatch-metrics-dimensions.md)
+ [在 CloudWatch 中结合使用 S3 Storage Lens 存储统计管理工具指标](storage-lens-cloudwatch-monitoring-cloudwatch.md)

# 在 CloudWatch 中结合使用 S3 Storage Lens 存储统计管理工具指标
<a name="storage-lens-cloudwatch-monitoring-cloudwatch"></a>

您可以将 S3 Storage Lens 存储统计管理工具指标发布到 Amazon CloudWatch，以便在 [CloudWatch 控制面板](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html)中创建运营状况的统一视图。您还可以使用 CloudWatch 功能（如告警和触发操作、指标数学和异常检测）来监控 S3 Storage Lens 存储统计管理工具指标并采取措施。此外，CloudWatch API 操作使应用程序（包括第三方提供商）能够访问 S3 Storage Lens 存储统计管理工具指标。有关 CloudWatch 功能的更多信息，请参阅 [Amazon CloudWatch 用户指南](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html)。

您可以使用 Amazon S3 控制台、Amazon S3 REST API、AWS CLI 和 AWS SDK 针对新的或当前控制面板配置启用 CloudWatch 发布选项。CloudWatch 发布选项可用于升级到 S3 Storage Lens 存储统计管理工具高级指标和建议。有关 S3 Storage Lens 存储统计管理工具高级指标和建议定价，请参阅 [Amazon S3 定价](https://aws.amazon.com/s3/pricing/)。不会收取其他 CloudWatch 指标发布费用；但是，其他 CloudWatch 费用（例如控制面板、告警和 API 调用）确实适用。有关更多信息，请参阅 [Amazon CloudWatch 定价](https://aws.amazon.com/cloudwatch/pricing/)。

S3 Storage Lens 指标在拥有 S3 Storage Lens 配置的账户中发布到 CloudWatch。在高级指标中启用 CloudWatch 发布选项后，您可以在 CloudWatch 中按配置 ID、账户、存储桶（仅适用于存储桶级指标）、区域和存储类别，访问账户级别和存储桶级别的指标。前缀级别的指标在 CloudWatch 中不可用。

**注意**  
S3 Storage Lens 存储统计管理工具指标是每日指标，每天发布到 CloudWatch 一次。当您在 CloudWatch 中查询 S3 Storage Lens 存储统计管理工具指标时，查询的期限必须为 1 天（86400 秒）。在您的每日 S3 Storage Lens 指标显示在 Amazon S3 控制台的 S3 Storage Lens 存储统计管理工具控制面板中后，这些指标可能需要几个小时才能显示在 CloudWatch 中。当您首次为 S3 Storage Lens 存储统计管理工具指标启用 CloudWatch 发布选项时，您的指标最多可能需要 24 小时才能将指标发布到 CloudWatch。  
目前，S3 Storage Lens 存储统计管理工具指标无法通过 CloudWatch 流使用。

有关在 CloudWatch 中使用 S3 Storage Lens 存储统计管理工具指标的更多信息，请参阅以下主题。

**Topics**
+ [结合使用 CloudWatch 控制面板](#storage-lens-cloudwatch-monitoring-cloudwatch-dashboards)
+ [设置警报、触发操作和使用异常检测](#storage-lens-cloudwatch-monitoring-cloudwatch-alarms)
+ [使用维度筛选指标](#storage-lens-cloudwatch-monitoring-cloudwatch-dimensions)
+ [使用指标数学计算新指标](#storage-lens-cloudwatch-monitoring-cloudwatch-metric-math)
+ [在图表中使用搜索表达式](#storage-lens-cloudwatch-monitoring-cloudwatch-search-expressions)

## 结合使用 CloudWatch 控制面板
<a name="storage-lens-cloudwatch-monitoring-cloudwatch-dashboards"></a>

您可以使用 CloudWatch dashboards（控制面板）与其他应用程序指标一起监控 S3 Storage Lens 存储统计管理工具指标，并创建运营状况的统一视图。控制面板是 CloudWatch 控制台中的一种自定义主页，可用于在单一视图中监视资源。

CloudWatch 具有广泛的权限控制，不支持限制对一组特定指标或维度的访问。您的账户或企业中有权访问 CloudWatch 的用户将有权访问启用了 CloudWatch 支持选项的所有 S3 Storage Lens 存储统计管理工具配置的指标。您无法像在 S3 Storage Lens 存储统计管理工具中那样管理特定控制面板的权限。有关 CloudWatch 权限的更多信息，请参阅 *Amazon CloudWatch User Guide*（Amazon CloudWatch 用户指南）中的 [Managing access permissions to your CloudWatch resources](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/iam-access-control-overview-cw.html)（管理对您的 CloudWatch 资源的访问权限）。

有关使用 CloudWatch 控制面板和配置权限的更多信息，请参阅 *Amazon CloudWatch User Guide*（Amazon CloudWatch 用户指南）中的 [Using Amazon CloudWatch dashboards](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html)（使用 Amazon CloudWatch 控制面板）和 [Sharing CloudWatch dashboards](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch-dashboard-sharing.html)（共享 CloudWatch 控制面板）。

## 设置警报、触发操作和使用异常检测
<a name="storage-lens-cloudwatch-monitoring-cloudwatch-alarms"></a>

您可以配置 CloudWatch 警报来监视 CloudWatch 中的 S3 Storage Lens 存储统计管理工具指标，并在超出阈值时采取行动。例如，您可以配置告警，当 **Incomplete Multipart Upload Bytes**（未完成分段上传字节）指标连续三天超过 1GB 时发送 Amazon SNS 通知。

您还可以启用异常检测以持续分析 S3 Storage Lens 存储统计管理工具指标、确定正常基线和表面异常。您可以根据指标的预期值创建异常检测告警。例如，您可以监视 **Object Lock Enabled Bytes**（启用对象锁定的字节）指标的异常情况，以检测未经授权移除对象锁定设置的情况。

有关更多信息以及示例，请参阅 *Amazon CloudWatch User Guide*（Amazon CloudWatch 用户指南）中的 [Using Amazon CloudWatch alarms](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html)（使用 Using Amazon CloudWatch 告警）和 [Creating an alarm from a metric on a graph](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/create_alarm_metric_graph.html)（从图表上的指标创建告警）。

## 使用维度筛选指标
<a name="storage-lens-cloudwatch-monitoring-cloudwatch-dimensions"></a>

您可以在 CloudWatch 控制台中使用维度筛选 S3 Storage Lens 存储统计管理工具指标。例如，您可以按照 `configuration_id`、`aws_account_number`、`aws_region`、`bucket_name` 等方式进行筛选。

S3 Storage Lens 存储统计管理工具支持每个账户多个控制面板配置。这意味着不同的配置可以包含同一个桶。当这些指标发布到 CloudWatch 时，桶将在 CloudWatch 中具有重复的指标。要是只需查看 CloudWatch 中特定 S3 Storage Lens 存储统计管理工具配置的指标，您可以使用 `configuration_id` 维度。当您按照 `configuration_id` 筛选时，您只能看到与您标识的配置相关联的指标。

有关按配置 ID 进行筛选的更多信息，请参阅《Amazon CloudWatch 用户指南》**中的[搜索可用指标](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/finding_metrics_with_cloudwatch.html)。

## 使用指标数学计算新指标
<a name="storage-lens-cloudwatch-monitoring-cloudwatch-metric-math"></a>

您可以使用指标数学查询多个 S3 Storage Lens 存储统计管理工具指标，并使用数学表达式基于这些度量创建新的时间序列。例如，您可以通过从对象计数中减去加密对象来为未加密对象创建一个新的指标。您还可以创建一个指标来获得平均对象大小，方法是将 `StorageBytes` 除以 `ObjectCount`，或者通过将 `BytesDownloaded` 除以 `StorageBytes` 来获得一天访问的字节数。

有关更多信息，请参阅 *Amazon CloudWatch User Guide*（Amazon CloudWatch 用户指南）中的 [Using metric math](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/using-metric-math.html)（使用指标数学）。

## 在图表中使用搜索表达式
<a name="storage-lens-cloudwatch-monitoring-cloudwatch-search-expressions"></a>

借助 S3 Storage Lens 存储统计管理工具指标，您可以创建搜索表达式。例如，您可以为所有名为 **IncompleteMultipartUploadStorageBytes** 的指标创建搜索表达式，并将 `SUM` 添加至表达式。使用此搜索表达式，您可以在单个指标中跨存储的所有维度查看未完成分段上传总字节数。

这个例子展示了用来为所有名为 **IncompleteMultipartUploadStorageBytes** 的指标创建搜索表达式的语法。

```
SUM(SEARCH('{AWS/S3/Storage-Lens,aws_account_number,aws_region,configuration_id,metrics_version,record_type,storage_class} MetricName="IncompleteMultipartUploadStorageBytes"', 'Average',86400))
```

有关此语法的更多信息，请参阅 *Amazon CloudWatch User Guide*（Amazon CloudWatch 用户指南）中的 [CloudWatch search expression syntax](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/search-expression-syntax.html)（CloudWatch 搜索表达式语法）。要使用搜索表达式创建 CloudWatch 图表，请参阅 [Amazon CloudWatch User Guide](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/create-search-expression.html)（Amazon CloudWatch 用户指南）中的 *Creating a CloudWatch graph with a search expression*（使用搜索表达式创建 CloudWatch 图表）。