Amazon Simple Storage Service
开发人员指南 (API Version 2006-03-01)
AWS 服务或AWS文档中描述的功能,可能因地区/位置而异。点 击 Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

存储桶的指标配置

利用 Amazon S3 的 CloudWatch 请求指标,您可以接收 1 分钟 CloudWatch 指标、设置 CloudWatch 警报和访问 CloudWatch 控制面板,以查看 Amazon S3 存储的近乎实时的运行状况和性能。对于依赖于云存储的应用程序而言,这些指标使您可以快速识别运行问题并采取措施。启用后,这些 1 分钟指标默认在 Amazon S3 存储桶级别提供。

如果您要获取某个存储桶中的对象的 CloudWatch 请求指标,则必须为该存储桶创建指标配置。您还可以为使用共享前缀或对象标签收集的指标定义筛选条件,这样您就可以使各个指标筛选条件满足特定业务应用程序、工作流或内部组织的需求。

有关可用 CloudWatch 指标的更多信息和存储指标与请求指标之间的区别,请参阅 使用 Amazon CloudWatch 来监控指标

在使用指标配置时,请记住以下几点:

  • 每个存储桶最多可以配置 1000 个指标。

  • 您可以利用筛选条件选择存储桶中的哪些对象可纳入指标配置。通过筛选共享前缀或对象标签,您可以使各个指标筛选条件满足特定业务应用程序、工作流或内部组织的需求。要请求整个存储桶的指标,请创建一种不带筛选条件的指标配置。

  • 只有启用请求指标才需要指标配置。存储桶级每日存储指标始终保持开启状态,并且免费提供。目前不能为筛选过的对象子集获取日常存储指标。

  • 每个指标配置均可启用全套可用请求指标。只有存在适用于您的存储桶或筛选条件请求类型,才会报告针对特定操作的指标 (例如 PostRequests)。

  • 将报告对象级操作的请求指标,并且还将报告列出存储桶内容的操作,例如 GET Bucket (List Objects)GET Bucket Object Versions列出分段上传,但不报告存储桶的其他操作。

最大努力 CloudWatch 指标传输

系统将以最大努力传输 CloudWatch 指标。大多数具有请求指标的针对 Amazon S3 对象的请求会导致将数据点发送到 CloudWatch。

因此无法保证指标的完整性和及时性。返回的特定请求的数据点所带的时间戳可能会晚于实际处理请求的时间,或者数据点可能推迟一分钟才通过 CloudWatch 提供,又或者可能根本不会提供。您可以通过 CloudWatch 请求指标近乎实时地了解有关存储桶流量性质方面的信息。这并不意味着会完整记录所有请求。

根据此功能的最大努力性质,在账单和成本管理控制面板提供的报告中可能有一个或多个访问请求不会出现在存储桶指标中。

筛选指标配置

当使用 CloudWatch 指标配置时,您可以选择将配置筛选到一个存储桶中的多组相关对象。您可以基于以下一个或多个因素在存储桶中筛选包含在指标配置中的对象:

  • 对象键名称前缀 - 尽管 Amazon S3 数据模型是一种扁平结构,但您仍可以使用前缀推断层次结构。Amazon S3 控制台支持这些带有文件夹概念的前缀。如果您按前缀进行筛选,有相同前缀的对象将包含在指标配置中。

  • 标签 - 您可以为对象添加标签和键值名称对。标签可让您轻松查找和整理对象。这些标签还可用作指标配置的筛选条件。

如果您指定了一项筛选条件,则仅在单个对象运行的请求可以满足筛选条件,并包含在报告的指标中。类似 Delete Multiple Objects 这样的请求和 List 请求不会为有筛选条件的配置返回指标。

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

如何添加指标配置

您可以通过 Amazon S3 控制台、使用 AWS CLI 或使用 Amazon S3 REST API 向存储桶添加指标配置。有关如何在 AWS 管理控制台 中执行此操作的信息,请参阅 Amazon S3 控制台用户指南

使用 AWS CLI 添加指标配置

  1. 安装并设置 AWS CLI。有关说明,请参阅获取 AWS Command Line Interface 用户指南 中的使用 AWS 命令行界面进行设置

  2. 打开终端。

  3. 运行以下命令以添加指标配置:

    Copy
    aws s3api put-bucket-metrics-configuration --endpoint http://s3-us-west-2.amazonaws.com --bucket bucket-name --id metrics-config-id --metrics-configuration '{"Id":" metrics-config-id ","Filter":{"Prefix":"prefix1"}}'
  4. 要验证配置是否已添加,请执行以下命令:

    Copy
    aws s3api get-bucket-metrics-configuration --endpoint http://s3-us-west-2.amazonaws.com --bucket bucket-name --id metrics-config-id

    这将返回以下响应:

    Copy
    { "MetricsConfiguration": { "Filter": { "Prefix": "prefix1" }, "Id": "metrics-config-id" } }

您还可以使用 Amazon S3 REST API 以编程方式添加指标配置。有关更多信息,请参阅 Amazon Simple Storage Service API Reference中的以下主题: