# 指标与维度
<a name="metrics-dimensions"></a>

以下各表列出了 Amazon S3 发送到 Amazon CloudWatch 的存储指标和维度。

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

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

根据此特征的最大努力性质，在[账单和成本管理控制面板](https://console.aws.amazon.com/billing/home?#/)提供的报告中可能有一个或多个访问请求不会出现在存储桶指标中。

**Topics**
+ [在 CloudWatch 中存储桶的 Amazon S3 每日存储指标](#s3-cloudwatch-metrics)
+ [CloudWatch 中的 Amazon S3 CloudWatch 请求指标](#s3-request-cloudwatch-metrics)
+ [CloudWatch 中的 S3 复制指标](#s3-cloudwatch-replication-metrics)
+ [CloudWatch 中的 S3 Storage Lens 存储统计管理工具指标](#storage-lens-metrics-cloudwatch-publish)
+ [CloudWatch 中的 S3 对象 Lambda 请求指标](#olap-cloudwatch-metrics)
+ [CloudWatch 中的 Amazon S3 维度](#s3-cloudwatch-dimensions)
+ [CloudWatch 中的 S3 复制维度](#s3-replication-dimensions)
+ [CloudWatch 中的 S3 Storage Lens 存储统计管理工具维度](#storage-lens-dimensions)
+ [CloudWatch 中的 S3 对象 Lambda 请求维度](#olap-dimensions)
+ [Amazon S3 用量指标](#s3-service-quota-metrics)

## 在 CloudWatch 中存储桶的 Amazon S3 每日存储指标
<a name="s3-cloudwatch-metrics"></a>

`AWS/S3` 命名空间包含存储桶的以下每日存储指标。


| 指标 | 说明 | 
| --- | --- | 
| BucketSizeBytes |  存储在以下存储类的存储桶中的数据量（以字节为单位）： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/AmazonS3/latest/userguide/metrics-dimensions.html) 此值通过汇总存储桶中所有对象（当前对象和非当前对象）和元数据（例如存储桶名称）的大小计算得出，包括所有向存储桶进行分段上传而未完成的所有部分的大小。  S3 Express One Zone 存储类仅可用于目录存储桶。  有效的存储类型筛选条件（请参阅 `StorageType` 维度）  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/AmazonS3/latest/userguide/metrics-dimensions.html) 单位：字节 有效统计数据：Average 有关 `StorageType` 维度的更多信息，请参阅 [CloudWatch 中的 Amazon S3 维度](#s3-cloudwatch-dimensions)。  | 
| NumberOfObjects |  通用存储桶中存储的所有存储类的对象的总数。此值通过对存储桶中的所有对象（包括当前对象和非当前对象）、删除标记以及所有向存储桶进行分段上传而未完成的所有分段的总数进行计数而计算得出。对于对象位于 S3 Express One Zone 存储类别中的目录存储桶，此值通过对存储桶中所有对象进行计数来计算得出，但不包括向存储桶进行的未完成的分段上传。 有效的存储类型筛选条件：`AllStorageTypes` (请参阅 `StorageType` 维度) 单位：计数 有效统计数据：Average  | 

## CloudWatch 中的 Amazon S3 CloudWatch 请求指标
<a name="s3-request-cloudwatch-metrics"></a>

`AWS/S3` 命名空间包含以下请求指标。这些指标包括不可计费的请求（如果是来自 `CopyObject` 和复制的 `GET` 请求）。


| 指标 | 描述 | 
| --- | --- | 
| AllRequests |  向 Amazon S3 存储桶提出的 HTTP 请求（不论类型如何）的总数。如果您要将某个指标配置用于某个筛选条件，则该指标将仅返回符合该筛选条件要求的 HTTP 请求。 单位：计数 有效统计数据：Sum  | 
| GetRequests |  向 Amazon S3 存储桶中的对象发出的 HTTP `GET` 请求的数量。这不包括列表操作。对于每个 `CopyObject` 请求的来源，此指标会递增。 单位：计数 有效统计数据：Sum  面向分页列表的请求（例如 [https://docs.aws.amazon.com/AmazonS3/latest/API/mpUploadListMPUpload.html](https://docs.aws.amazon.com/AmazonS3/latest/API/mpUploadListMPUpload.html)、[https://docs.aws.amazon.com/AmazonS3/latest/API/mpUploadListParts.html](https://docs.aws.amazon.com/AmazonS3/latest/API/mpUploadListParts.html)、[https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketGETVersion.html](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketGETVersion.html)）和其它请求不包含在此指标中。   | 
| PutRequests |  向 Amazon S3 桶中的对象发出的 HTTP `PUT` 请求的数量。对于每个 `CopyObject` 请求的目标，此指标会递增。 单位：计数 有效统计数据：Sum  | 
| DeleteRequests |  向 Amazon S3 存储桶中的对象发出的 HTTP `DELETE` 请求的数量。此指标还包括 [https://docs.aws.amazon.com/AmazonS3/latest/API/multiobjectdeleteapi.html](https://docs.aws.amazon.com/AmazonS3/latest/API/multiobjectdeleteapi.html) 请求。此指标显示发出的请求数量，而不是删除的对象数量。 单位：计数 有效统计数据：Sum  | 
| HeadRequests |  向 Amazon S3 存储桶发出的 HTTP `HEAD` 请求的数量。 单位：计数 有效统计数据：Sum  | 
| PostRequests |  向 Amazon S3 存储桶发出的 HTTP `POST` 请求的数量。 单位：计数 有效统计数据：Sum  此指标不包括 [https://docs.aws.amazon.com/AmazonS3/latest/API/multiobjectdeleteapi.html](https://docs.aws.amazon.com/AmazonS3/latest/API/multiobjectdeleteapi.html) 和 [https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectSELECTContent.html](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectSELECTContent.html) 请求。   | 
| SelectRequests |  向 Amazon S3 存储桶中的对象发出的 Amazon S3 [https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectSELECTContent.html](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectSELECTContent.html) 请求的数量。 单位：计数 有效统计数据：Sum  | 
| SelectBytesScanned |  使用 Amazon S3 存储桶中的 Amazon S3 [https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectSELECTContent.html](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectSELECTContent.html) 请求扫描的数据字节数。  单位：字节  有效统计数据：Average（每个请求的字节数）、Sum（每个周期的字节数）、Sample Count、Min、Max（与 p100 相同）、任何在 p0.0 和 p99.9 之间的百分位数  | 
| SelectBytesReturned |  使用 Amazon S3 存储桶中的 Amazon S3 [https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectSELECTContent.html](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectSELECTContent.html) 请求返回的数据字节数。  单位：字节  有效统计数据：Average (每个请求的字节数)、Sum (每个周期的字节数)、Sample Count、Min、Max（与 p100 相同）、任何在 p0.0 和 p99.9 之间的百分位数  | 
| ListRequests |  列出存储桶内容的 HTTP 请求的数量。 单位：计数 有效统计数据：Sum  | 
| BytesDownloaded |  为向 Amazon S3 存储桶提出的请求下载的字节数（请求的响应包含正文）。 单位：字节 有效统计数据：Average（每个请求的字节数）、Sum（每个周期的字节数）、Sample Count、Min、Max（与 p100 相同）、任何在 p0.0 和 p99.9 之间的百分位数  | 
| BytesUploaded |  为向 Amazon S3 存储桶发出的请求上传的字节数（请求包含正文）。 单位：字节 有效统计数据：Average (每个请求的字节数)、Sum (每个周期的字节数)、Sample Count、Min、Max（与 p100 相同）、任何在 p0.0 和 p99.9 之间的百分位数  | 
| 4xxErrors |  向 Amazon S3 存储桶发出的值为 0 或 1 的 HTTP 4*xx* 客户端错误状态代码请求数。Average 统计数据显示了错误率，Sum 统计数据显示了每个周期内该类型的错误的计数。 单位：计数 有效统计数据：Average (每个请求的报告数)、Sum (每个周期的报告数)、Min、Max、Sample Count  | 
| 5xxErrors |  向 Amazon S3 存储桶发出的值为 0 或 1 的 HTTP 5*xx* 服务器错误状态代码请求数。Average 统计数据显示了错误率，Sum 统计数据显示了每个周期内该类型的错误的计数。 单位：计数 有效统计数据：Average（每个请求的报告数）、Sum（每个周期的报告数）、Min、Max、Sample Count  | 
| FirstByteLatency |  从 Amazon S3 存储桶收到完整请求到开始返回响应的每请求时间。 单位：毫秒 有效统计数据：Average、Sum、Min、Max（与 p100 相同）、Sample Count、任何在 p0.0 和 p100 之间的百分位数  | 
| TotalRequestLatency |  从收到第一个字节到将最后一个字节发送到 Amazon S3 存储桶的已用每请求时间。此指标包括接收请求正文和发送响应正文所耗的时间（未包含在 `FirstByteLatency` 中）。 单位：毫秒 有效统计数据：Average、Sum、Min、Max（与 p100 相同）、Sample Count、任何在 p0.0 和 p100 之间的百分位数  | 

## CloudWatch 中的 S3 复制指标
<a name="s3-cloudwatch-replication-metrics"></a>

您可以使用 S3 复制指标，通过跟踪待处理的字节、待处理的操作和复制延迟，监控复制的进度。有关更多信息，请参阅[使用复制指标监控进度](https://docs.aws.amazon.com/AmazonS3/latest/userguide/replication-metrics.html)。

**注意**  
您可以在 Amazon CloudWatch 中对复制指标启用告警。为复制指标设置警报时，请将 **Missing data treatment (丢失数据处理)** 字段设置为 **Treat missing data as ignore (maintain the alarm state) [将丢失的数据视为忽略（保持警报状态）]**。


| 指标 | 说明 | 
| --- | --- | 
| ReplicationLatency |  对于给定的复制规则，复制目标 AWS 区域落后于源 AWS 区域的最大秒数。 单位：秒 有效统计数据：Max  | 
| BytesPendingReplication |  给定复制规则的待复制对象的总字节数。 单位：字节 有效统计数据：Max  | 
| OperationsPendingReplication |  给定复制规则的待复制操作数。 单位：计数 有效统计数据：Max  | 
| OperationsFailedReplication |  给定复制规则的复制失败的操作数。 单位：计数  有效统计信息：总和（失败操作总数）、平均值（失败率）、样本数（复制操作总数）  | 

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

您可以将 S3 Storage Lens 存储统计管理工具使用情况和活动指标发布到 Amazon CloudWatch，以便在 CloudWatch [控制面板](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html)中创建运营状况的统一视图。S3 Storage Lens 存储统计管理工具指标已发布到 CloudWatch 中的 `AWS/S3/Storage-Lens` 命名空间。CloudWatch 发布选项可用于已升级为 advanced metrics and recommendations（高级指标和建议）的 S3 Storage Lens 存储统计管理工具控制面板。

有关发布到 CloudWatch 的 S3 Storage Lens 存储统计管理工具指标列表，请参阅 [Amazon S3 Storage Lens 存储统计管理工具指标词汇表](storage_lens_metrics_glossary.md)。有关维度的完整列表，请参阅 [维度](storage-lens-cloudwatch-metrics-dimensions.md#storage-lens-cloudwatch-dimensions)。

## CloudWatch 中的 S3 对象 Lambda 请求指标
<a name="olap-cloudwatch-metrics"></a>

S3 对象 Lambda 包含以下请求指标。


| 指标 | 说明 | 
| --- | --- | 
| AllRequests |  使用对象 Lambda 接入点向 Amazon S3 存储桶发出的 HTTP 请求总数。 单位：计数 有效统计数据：Sum  | 
| GetRequests |  使用对象 Lambda 接入点对于对象发出的 HTTP `GET` 请求的数量。该指标不包括列出操作。 单位：计数 有效统计数据：Sum  | 
| BytesUploaded |  使用对象 Lambda 接入点上传到 Amazon S3 存储桶的字节数（请求包含正文）。 单位：字节 有效统计数据：Average（每个请求的字节数）、Sum（每个周期的字节数）、Sample Count、Min、Max（与 p100 相同）、任何在 p0.0 和 p99.9 之间的百分位数  | 
| PostRequests |  使用对象 Lambda 接入点向 Amazon S3 存储桶发出的 HTTP `POST` 请求的数量。 单位：计数 有效统计数据：Sum  | 
| PutRequests |  使用对象 Lambda 接入点对于 Amazon S3 存储桶中的对象发出的 HTTP `PUT` 请求的数量。 单位：计数  有效统计数据：Sum  | 
| DeleteRequests |  使用对象 Lambda 接入点对于 Amazon S3 存储桶中的对象发出的 HTTP `DELETE` 请求的数量。此指标包括 [https://docs.aws.amazon.com/AmazonS3/latest/API/multiobjectdeleteapi.html](https://docs.aws.amazon.com/AmazonS3/latest/API/multiobjectdeleteapi.html) 请求。此指标显示发出的请求数量，而不是删除的对象数量。 单位：计数 有效统计数据：Sum  | 
| BytesDownloaded |  为使用对象 Lambda 接入点向 Amazon S3 存储桶发出的请求下载的字节数（响应包括正文）。 单位：字节  有效统计数据：Average（每个请求的字节数）、Sum（每个周期的字节数）、Sample Count、Min、Max（与 p100 相同）、任何在 p0.0 和 p99.9 之间的百分位数  | 
| FirstByteLatency |  从 Amazon S3 存储桶通过对象 Lambda 接入点收到完整请求到开始返回响应的每请求时间。此指标取决于在 AWS Lambda 函数将字节返回给对象 Lambda 接入点之前，该函数对于对象进行转换的运行时间。 单位：毫秒  有效统计数据：Average、Sum、Min、Max（与 p100 相同）、Sample Count、任何在 p0.0 和 p100 之间的百分位数  | 
| TotalRequestLatency |  从收到第一个字节到将最后一个字节发送到对象 Lambda 接入点的已用每请求时间。此指标包括接收请求正文和发送响应正文所耗的时间（未包含在 `FirstByteLatency` 中）。 单位：毫秒 有效统计数据：Average、Sum、Min、Max（与 p100 相同）、Sample Count、任何在 p0.0 和 p100 之间的百分位数  | 
| HeadRequests |  使用对象 Lambda 接入点向 Amazon S3 存储桶发出的 HTTP `HEAD` 请求的数量。 单位：计数 有效统计数据：Sum  | 
| ListRequests |  列出 Amazon S3 存储桶内容的 HTTP `GET` 请求的数量。该指标同时包含 `ListObjects` 和 `ListObjectsV2` 操作。 单位：计数 有效统计数据：Sum  | 
| 4xxErrors |  使用对象 Lambda 接入点向 Amazon S3 存储桶发出的值为 0 或 1 的 HTTP 4*xx* 客户端错误状态代码请求数。Average 统计数据显示了错误率，Sum 统计数据显示了每个周期内该类型的错误的计数。 单位：计数  有效统计数据：Average（每个请求的报告数）、Sum（每个周期的报告数）、Min、Max、Sample Count  | 
| 5xxErrors |  使用对象 Lambda 接入点向 Amazon S3 存储桶发出的值为 0 或 1 的 HTTP 5*xx* 服务器错误状态代码请求数。Average 统计数据显示了错误率，Sum 统计数据显示了每个周期内该类型的错误的计数。 单位：计数  有效统计数据：Average（每个请求的报告数）、Sum（每个周期的报告数）、Min、Max、Sample Count  | 
| ProxiedRequests |  向返回标准 Amazon S3 API 响应的对象 Lambda 接入点发出的 HTTP 请求的数量。（此类请求没有配置 Lambda 函数。） 单位：计数 有效统计数据：Sum  | 
| InvokedLambda |  对在其中调用 Lambda 函数的 S3 对象的 HTTP 请求数。 单位：计数 有效统计数据：Sum  | 
| LambdaResponseRequests |  Lambda 函数发出的 `WriteGetObjectResponse` 请求的数量。此指标仅适用于 `GetObject` 请求。  | 
| LambdaResponse4xx |  从 Lambda 函数调用 `WriteGetObjectResponse` 时发生的 HTTP 4*xx* 客户端错误的数量。此指标提供的信息与 `4xxErrors` 相同，但仅适用于 `WriteGetObjectResponse` 调用。  | 
| LambdaResponse5xx |  从 Lambda 函数调用 `WriteGetObjectResponse` 时发生的 HTTP 5*xx* 服务器错误的数量。此指标提供的信息与 `5xxErrors` 相同，但仅适用于 `WriteGetObjectResponse` 调用。  | 

## CloudWatch 中的 Amazon S3 维度
<a name="s3-cloudwatch-dimensions"></a>

下列维度用于筛选 Amazon S3 指标。


|  维度  |  说明  | 
| --- | --- | 
|  BucketName  |  此维度筛选您仅为已识别存储桶请求的数据。  | 
|  StorageType  |  此维度按以下存储类型筛选您存储在存储桶中的数据： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/AmazonS3/latest/userguide/metrics-dimensions.html)  | 
| FilterId | 此维度将筛选您为存储桶上的请求指标指定的指标配置。创建指标配置时，需要指定筛选条件 ID（例如，前缀、标签或接入点）。有关更多信息，请参阅[创建指标配置](https://docs.aws.amazon.com/AmazonS3/latest/userguide/metrics-configurations.html)。 | 

## CloudWatch 中的 S3 复制维度
<a name="s3-replication-dimensions"></a>

下列维度用于筛选 S3 复制指标。


|  维度  |  说明  | 
| --- | --- | 
|  SourceBucket  |  从中进行复制的桶对象的名称。  | 
|  DestinationBucket  |  要复制到的桶对象的名称。  | 
|  RuleId  |  触发该复制指标进行更新的规则的唯一标识符。  | 

## CloudWatch 中的 S3 Storage Lens 存储统计管理工具维度
<a name="storage-lens-dimensions"></a>

有关用于在 CloudWatch 中筛选 S3 Storage Lens 存储统计管理工具指标的维度列表，请参阅[维度](storage-lens-cloudwatch-metrics-dimensions.md#storage-lens-cloudwatch-dimensions)。

## CloudWatch 中的 S3 对象 Lambda 请求维度
<a name="olap-dimensions"></a>

以下维度用于筛选来自对象 Lambda 接入点的数据。


| 维度 | 说明 | 
| --- | --- | 
| AccessPointName |  正在向其发出请求的接入点的名称。  | 
| DataSourceARN |  对象 Lambda 接入点正从中检索数据的来源。如果请求调用 Lambda 函数，则这指的是 Lambda Amazon 资源名称（ARN）。否则，这指接入点 ARN。  | 

## Amazon S3 用量指标
<a name="s3-service-quota-metrics"></a>

您可以使用 CloudWatch 使用情况指标来提供账户资源使用情况的可见性。这些指标可在 CloudWatch 图表和控制面板上直观呈现当前的服务使用情况。

Amazon S3 用量指标与 AWS 服务配额相对应。您可以配置警报，以在用量接近服务配额时向您发出警报。有关 CloudWatch 与 Service Quotas 集成的更多信息，请参阅《Amazon CloudWatch 用户指南》**中的 [AWS 使用情况指标](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Service-Quota-Integration.html)。

Amazon S3 在 `AWS/Usage` 命名空间中发布以下指标。


| 指标 | 描述 | 
| --- | --- | 
| `ResourceCount` |  您账户中运行的指定资源的数量。资源由与指标关联的维度定义。  | 

以下维度用于优化由 Amazon S3 发布的用量指标。


| 维度 | 描述 | 
| --- | --- | 
|  Service  |  包含该资源的 AWS 服务的名称。对于 Amazon S3 用量指标，此维度的值为 `S3`。  | 
|  Type  |  正在报告的实体的类型。目前，Amazon S3 用量指标的唯一有效值为 `Resource`。  | 
|  Resource  |  正在运行的资源的类型。目前，Amazon S3 用量指标的唯一有效值是 `GeneralPurposeBuckets`，它返回 AWS 账户中通用存储桶的数量。通用存储桶支持跨所有存储类（S3 Express One Zone 除外）存储的对象。  |