# 创建按前缀，对象标签或接入点筛选的指标配置
<a name="metrics-configurations-filter"></a>

Amazon S3 存在三种类型的 Amazon CloudWatch 指标：存储指标、请求指标和复制指标。存储指标每天报告一次并提供给所有客户，无需额外费用。请求指标在要处理的某些延迟后每隔一分钟提供一次。请求指标按标准 CloudWatch 费率计费。您必须通过在控制台中配置请求指标或使用 Amazon S3 API 来选择使用请求指标。[S3 复制指标](https://docs.aws.amazon.com/AmazonS3/latest/userguide/viewing-replication-metrics.html)为复制配置中的复制规则提供了详细的指标。使用复制指标，您可以通过跟踪待复制的字节数、待复制的操作数、复制失败的操作数和复制延迟来逐分钟监控进度。

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

配置 CloudWatch 指标时，您可以为存储桶中的所有对象创建筛选条件，也可以将配置筛选到单个存储桶中的相关对象组中。您可以基于以下一个或多个筛选条件类型在存储桶中筛选包含在指标配置中的对象：
+ **对象键名称前缀** – 尽管 Amazon S3 数据模型是一种扁平结构，但您仍可以使用前缀推断层次结构。Amazon S3 控制台支持这些带有文件夹概念的前缀。如果您按前缀进行筛选，有相同前缀的对象将包含在指标配置中。有关前缀的更多信息，请参阅 [使用前缀组织对象](using-prefixes.md)。
+ **标签** – 您可以为对象添加标签（键值名称对）。标签可让您轻松查找和整理对象。您还可以使用标签作为指标配置的筛选条件。有关对象标签的更多信息，请参阅 [使用标签对对象进行分类](object-tagging.md)。
+ **接入点** - S3 接入点是命名为连接到存储桶的网络端点，可简化对 S3 中的共享数据集的大规模数据访问管理。创建接入点筛选条件时，Amazon S3 会包含对指标配置中指定的接入点请求。有关更多信息，请参阅 [监控和记录接入点](access-points-monitoring-logging.md)。
**注意**  
创建按接入点筛选的指标配置时，必须使用接入点 Amazon Resource Name (ARN)，而不是接入点别名。请确保您将 ARN 用于接入点本身，而不是特定对象的 ARN。有关接入点 ARN 的更多信息，请参阅 [使用通用存储桶的 Amazon S3 接入点](using-access-points.md)。

如果您指定了一项筛选条件，则仅在单个对象运行的请求可以满足筛选条件，并包含在报告的指标中。与 [https://docs.aws.amazon.com/AmazonS3/latest/API/multiobjectdeleteapi.html](https://docs.aws.amazon.com/AmazonS3/latest/API/multiobjectdeleteapi.html) 和 `ListObjects` 请求类似的请求不会使用筛选条件为配置返回任何指标。

要请求更复杂的筛选，请选择两个或更多元素。只有拥有所有这些元素的对象才会包含在指标配置中。如果未设置筛选条件，则存储桶中的所有对象都会包含在指标配置中。

## 使用 S3 控制台
<a name="configure-metrics-filter"></a>

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

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

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

1. 请选择 **Metrics (指标)** 选项卡。

1. 在 **Bucket metrics（存储桶指标）**下，请选择 **View additional charts（查看其他图表）**。

1. 请选择 **Request metrics（请求指标）**选项卡。

1. 请选择 **Create filter（创建筛选器）**。

1. 在 **Filter name（筛选器名称）**框中，输入筛选器名称。

   名称可以包含字母、数字、句点、短划线和下划线。

1. 在**筛选条件范围**中，请选择**使用前缀、对象标签和 S3 接入点（或三个全选）来限制此筛选条件的范围**。

1. 在**筛选条件类型**中，请至少选择一个筛选条件类型：**前缀**、**对象标签**，或**接入点**。

1. 要定义前缀筛选条件并将筛选范围限制为单个路径，请在**前缀**框中输入前缀。

1. 要定义对象标签筛选条件，请在**对象标签**中，请选择**添加标签**，然后输入标签**密钥**和**值**。

1. 要定义接入点筛选条件，请在 **S3 接入点**字段中，输入接入点 ARN，或选择**浏览 S3**导航到接入点。
**重要**  
您无法输入接入点别名。必须输入接入点本身的 ARN，而不是特定对象的 ARN。

1. 选择 **Save changes (保存更改)**。

   Amazon S3 会用您指定的前缀，标签或接入点创建筛选条件。

1. 在 **Request metrics（请求指标）**选项卡的 **Filters（筛选器）**下，请选择刚创建的筛选器。

   您现在已创建一个筛选条件，该筛选条件通过前缀，标签或接入点限制请求指标范围。在 CloudWatch 开始跟踪这些请求指标后大约 15 分钟，您就可以看到 Amazon S3 和 CloudWatch 控制台中的指标的图表。请求指标按标准 CloudWatch 费率计费。有关更多信息，请参阅 [Amazon CloudWatch 定价](https://aws.amazon.com/cloudwatch/pricing/)。

   还可以在存储桶级别配置请求指标。有关信息，请参阅 [为存储桶中的所有对象创建 CloudWatch 指标配置](configure-request-metrics-bucket.md)。

## 使用 AWS CLI
<a name="add-metrics-configurations"></a>

1. 安装并设置 AWS CLI。有关说明，请参阅 *AWS Command Line Interface 用户指南*中的[安装、更新和卸载 AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-install.html)。

1. 打开终端。

1. 要添加指标配置，运行以下命令。  
**Example ：按前缀筛选**  

   ```
   aws s3api put-bucket-metrics-configuration --bucket amzn-s3-demo-bucket --id metrics-config-id --metrics-configuration '{"Id":"metrics-config-id", "Filter":{"Prefix":"prefix1"}} '
   ```  
**Example ：按标签筛选**  

   ```
   aws s3api put-bucket-metrics-configuration --bucket amzn-s3-demo-bucket --id metrics-config-id --metrics-configuration '{"Id":"metrics-config-id", "Filter":{"Tag": {"Key": "string", "Value": "string"}} '
   ```  
**Example ：按接入点筛选**  

   ```
   aws s3api put-bucket-metrics-configuration --bucket amzn-s3-demo-bucket --id metrics-config-id --metrics-configuration '{"Id":"metrics-config-id", "Filter":{"AccessPointArn":"arn:aws:s3:Region:account-id:accesspoint/access-point-name"}} '
   ```  
**Example ：按前缀、标签和接入点筛选**  

   ```
   aws s3api put-bucket-metrics-configuration --endpoint https://s3.Region.amazonaws.com --bucket amzn-s3-demo-bucket --id metrics-config-id --metrics-configuration '
   {
       "Id": "metrics-config-id",
       "Filter": {
           "And": {
               "Prefix": "string",
               "Tags": [
                   {
                       "Key": "string",
                       "Value": "string"
                   }
               ],
               "AccessPointArn": "arn:aws:s3:Region:account-id:accesspoint/access-point-name"
           }
       }
   }'
   ```

## 使用 REST API
<a name="configure-cw-filter-rest"></a>

您还可以使用 Amazon S3 REST API 以编程方式添加指标配置。有关添加和使用指标配置的更多信息，请参阅 *Amazon Simple Storage Service API 参考*中的以下主题：
+ [PUT Bucket Metric 配置](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUTMetricConfiguration.html)
+ [GET Bucket Metric 配置](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketGETMetricConfiguration.html)
+ [List Bucket Metric 配置](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTListBucketMetricsConfiguration.html)
+ [DELETE Bucket Metric 配置](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTDeleteBucketMetricsConfiguration.html)