Metrics and dimensions - Amazon Simple Storage Service

Metrics and dimensions

The storage metrics and dimensions that Amazon S3 sends to CloudWatch are listed below.

Amazon S3 daily storage metrics for buckets in CloudWatch

The AWS/S3 namespace includes the following daily storage metrics for buckets.

Metric Description
BucketSizeBytes

The amount of data in bytes stored in a bucket in the STANDARD storage class, INTELLIGENT_TIERING storage class, Standard-Infrequent Access (STANDARD_IA) storage class, OneZone-Infrequent Access (ONEZONE_IA), Reduced Redundancy Storage (RRS) class, S3 Glacier Instant Retrieval storage class, Deep Archive Storage (S3 Glacier Deep Archive) class or, S3 Glacier Flexible Retrieval (GLACIER) storage class. This value is calculated by summing the size of all objects and metadata in the bucket (both current and noncurrent objects), including the size of all parts for all incomplete multipart uploads to the bucket.

Valid storage type filters: StandardStorage, IntelligentTieringFAStorage, IntelligentTieringIAStorage, IntelligentTieringAAStorage, IntelligentTieringAIAStorage, IntelligentTieringDAAStorage, StandardIAStorage, StandardIASizeOverhead, StandardIAObjectOverhead, OneZoneIAStorage, OneZoneIASizeOverhead, ReducedRedundancyStorage, GlacierInstantRetrievalSizeOverhead GlacierInstantRetrievalStorage, GlacierStorage, GlacierStagingStorage, GlacierObjectOverhead, GlacierS3ObjectOverhead, DeepArchiveStorage, DeepArchiveObjectOverhead, DeepArchiveS3ObjectOverhead and, DeepArchiveStagingStorage (see the StorageType dimension)

Units: Bytes

Valid statistics: Average

NumberOfObjects

The total number of objects stored in a bucket for all storage classes. This value is calculated by counting all objects in the bucket (both current and noncurrent objects) and the total number of parts for all incomplete multipart uploads to the bucket.

Valid storage type filters: AllStorageTypes (see the StorageType dimension)

Units: Count

Valid statistics: Average

Amazon S3 request metrics in CloudWatch

The AWS/S3 namespace includes the following request metrics.

Metric Description
AllRequests

The total number of HTTP requests made to an Amazon S3 bucket, regardless of type. If you're using a metrics configuration with a filter, then this metric only returns the HTTP requests that meet the filter's requirements.

Units: Count

Valid statistics: Sum

GetRequests

The number of HTTP GET requests made for objects in an Amazon S3 bucket. This doesn't include list operations.

Units: Count

Valid statistics: Sum

Note

Paginated list-oriented requests, like List Multipart Uploads, List Parts, Get Bucket Object versions, and others, are not included in this metric.

PutRequests

The number of HTTP PUT requests made for objects in an Amazon S3 bucket.

Units: Count

Valid statistics: Sum

DeleteRequests

The number of HTTP DELETE requests made for objects in an Amazon S3 bucket. This also includes Delete Multiple Objects requests. This metric shows the number of requests, not the number of objects deleted.

Units: Count

Valid statistics: Sum

HeadRequests

The number of HTTP HEAD requests made to an Amazon S3 bucket.

Units: Count

Valid statistics: Sum

PostRequests

The number of HTTP POST requests made to an Amazon S3 bucket.

Units: Count

Valid statistics: Sum

Note

Delete Multiple Objects and SELECT Object Content requests are not included in this metric.

SelectRequests

The number of Amazon S3 SELECT Object Content requests made for objects in an Amazon S3 bucket.

Units: Count

Valid statistics: Sum

SelectBytesScanned

The number of bytes of data scanned with Amazon S3 SELECT Object Content requests in an Amazon S3 bucket.

Units: Bytes

Valid statistics: Average (bytes per request), Sum (bytes per period), Sample Count, Min, Max (same as p100), any percentile between p0.0 and p99.9

SelectBytesReturned

The number of bytes of data returned with Amazon S3 SELECT Object Content requests in an Amazon S3 bucket.

Units: Bytes

Valid statistics: Average (bytes per request), Sum (bytes per period), Sample Count, Min, Max (same as p100), any percentile between p0.0 and p99.9

ListRequests

The number of HTTP requests that list the contents of a bucket.

Units: Count

Valid statistics: Sum

BytesDownloaded

The number of bytes downloaded for requests made to an Amazon S3 bucket, where the response includes a body.

Units: Bytes

Valid statistics: Average (bytes per request), Sum (bytes per period), Sample Count, Min, Max (same as p100), any percentile between p0.0 and p99.9

BytesUploaded

The number of bytes uploaded that contain a request body, made to an Amazon S3 bucket.

Units: Bytes

Valid statistics: Average (bytes per request), Sum (bytes per period), Sample Count, Min, Max (same as p100), any percentile between p0.0 and p99.9

4xxErrors

The number of HTTP 4xx client error status code requests made to an Amazon S3 bucket with a value of either 0 or 1. The average statistic shows the error rate, and the sum statistic shows the count of that type of error, during each period.

Units: Count

Valid statistics: Average (reports per request), Sum (reports per period), Min, Max, Sample Count

5xxErrors

The number of HTTP 5xx server error status code requests made to an Amazon S3 bucket with a value of either 0 or 1. The average statistic shows the error rate, and the sum statistic shows the count of that type of error, during each period.

Units: Counts

Valid statistics: Average (reports per request), Sum (reports per period), Min, Max, Sample Count

FirstByteLatency

The per-request time from the complete request being received by an Amazon S3 bucket to when the response starts to be returned.

Units: Milliseconds

Valid statistics: Average, Sum, Min, Max(same as p100), Sample Count, any percentile between p0.0 and p100

TotalRequestLatency

The elapsed per-request time from the first byte received to the last byte sent to an Amazon S3 bucket. This includes the time taken to receive the request body and send the response body, which is not included in FirstByteLatency.

Units: Milliseconds

Valid statistics: Average, Sum, Min, Max(same as p100), Sample Count, any percentile between p0.0 and p100

Amazon S3 replication metrics in CloudWatch

You can monitor the progress of replication with S3 replication metrics by tracking bytes pending, operations pending, and replication latency. For more information, see Monitoring progress with replication metrics.

Note

You can enable alarms for your replication metrics on Amazon CloudWatch. When you set up alarms for your replication metrics, set the Missing data treatment field to Treat missing data as ignore (maintain the alarm state).

Metric Description
ReplicationLatency

The maximum number of seconds by which the replication destination Region is behind the source Region for a given replication rule.

Units: Seconds

Valid statistics: Max

BytesPendingReplication

The total number of bytes of objects pending replication for a given replication rule.

Units: Bytes

Valid statistics: Max

OperationsPendingReplication

The number of operations pending replication for a given replication rule.

Units: Counts

Valid statistics: Max

Amazon S3 Storage Lens metrics in CloudWatch

You can publish S3 Storage Lens usage and activity metrics to Amazon CloudWatch to create a unified view of your operational health in CloudWatch dashboards. S3 Storage Lens metrics are published to the AWS/S3/Storage-Lens namespace in CloudWatch. The CloudWatch publishing option is available for S3 Storage Lens dashboards upgraded to advanced metrics and recommendations.

For a list of S3 Storage Lens metrics published to CloudWatch, see Amazon S3 Storage Lens metrics glossary. For a complete list of dimensions, see Dimensions.

Amazon S3 on Outposts metrics in CloudWatch

The S3Outposts namespace includes the following metrics for Amazon S3 on Outposts buckets. You can monitor the total number of S3 on Outposts bytes provisioned, the total free bytes available for objects, and the total size of all objects for a given bucket.

Note

S3 on Outposts supports only the following metrics, and no other Amazon S3 metrics.

Because S3 on Outposts has fixed capacity, you can create CloudWatch alerts that alert you when your storage utilization exceeds a certain threshold.

Metric Description
OutpostTotalBytes

The total provisioned capacity in bytes for an Outpost.

Units: Bytes

Period: 5 minutes

OutpostFreeBytes

The count of free bytes available on an Outpost to store customer data.

Units: Bytes

Period: 5 minutes

BucketUsedBytes

The total size of all objects for the given bucket.

Units: Counts

Period: 5 minutes

AccountUsedBytes

The total size of all objects for the specified Outposts account.

Units: Bytes

Period: 5 minutes

Amazon S3 dimensions in CloudWatch

The following dimensions are used to filter Amazon S3 metrics.

Dimension

Description

BucketName

This dimension filters the data that you request for the identified bucket only.

StorageType

This dimension filters the data that you have stored in a bucket by the following types of storage:

  • StandardStorage – The number of bytes used for objects in the STANDARD storage class.

  • IntelligentTieringAAStorage – The number of bytes used for objects in the Archive Access tier of the INTELLIGENT_TIERING storage class.

  • IntelligentTieringAIAStorage – The number of bytes used for objects in the Archive Instant Access tier of the INTELLIGENT_TIERING storage class.

  • IntelligentTieringDAAStorage – The number of bytes used for objects in the Deep Archive Access tier of the INTELLIGENT_TIERING storage class.

  • IntelligentTieringFAStorage – The number of bytes used for objects in the Frequent Access tier of the INTELLIGENT_TIERING storage class.

  • IntelligentTieringIAStorage – The number of bytes used for objects in the Infrequent Access tier of the INTELLIGENT_TIERING storage class.

  • StandardIAStorage – The number of bytes used for objects in the Standard-Infrequent Access (STANDARD_IA) storage class.

  • StandardIASizeOverhead – The number of bytes used for objects smaller than 128 KB in size in the STANDARD_IA storage class.

  • IntAAObjectOverhead – For each object in the INTELLIGENT_TIERING storage class in the Archive Access tier, S3 Glacier adds 32 KB of storage for index and related metadata. This extra data is necessary to identify and restore your object. You are charged S3 Glacier rates for this additional storage.

  • IntAAS3ObjectOverhead – For each object in the INTELLIGENT_TIERING storage class in the Archive Access tier, Amazon S3 uses 8 KB of storage for the name of the object and other metadata. You are charged STANDARD rates for this additional storage.

  • IntDAAObjectOverhead – For each object in the INTELLIGENT_TIERING storage class in the Deep Archive Access tier, S3 Glacier adds 32 KB of storage for index and related metadata. This extra data is necessary to identify and restore your object. You are charged S3 Glacier Deep Archive storage rates for this additional storage.

  • IntDAAS3ObjectOverhead – For each object in the INTELLIGENT_TIERING storage class in the Deep Archive Access tier, Amazon S3 adds 8 KB of storage for index and related metadata. This extra data is necessary to identify and restore your object. You are charged STANDARD rates for this additional storage.

  • OneZoneIAStorage – The number of bytes used for objects in the S3 One Zone-Infrequent Access (ONEZONE_IA) storage class.

  • OneZoneIASizeOverhead – The number of bytes used for objects smaller than 128 KB in size in the ONEZONE_IA storage class.

  • ReducedRedundancyStorage – The number of bytes used for objects in the Reduced Redundancy Storage (RRS) class.

  • GlacierInstantRetrievalSizeOverhead – The number of bytes used for objects smaller than 128 KB in size in the S3 Glacier Instant Retrieval storage class.

  • GlacierInstantRetrievalStorage – The number of bytes used for objects in the S3 Glacier Instant Retrieval storage class.

  • GlacierStorage – The number of bytes used for objects in the S3 Glacier Flexible Retrieval storage class.

  • GlacierStagingStorage – The number of bytes used for parts of Multipart objects before the CompleteMultipartUpload request is completed on objects in the S3 Glacier Flexible Retrieval storage class.

  • GlacierObjectOverhead – For each archived object, S3 Glacier adds 32 KB of storage for index and related metadata. This extra data is necessary to identify and restore your object. You are charged S3 Glacier Flexible Retrieval rates for this additional storage.

  • GlacierS3ObjectOverhead – For each object archived to S3 Glacier Flexible Retrieval, Amazon S3 uses 8 KB of storage for the name of the object and other metadata. You are charged STANDARD rates for this additional storage.

  • DeepArchiveStorage – The number of bytes used for objects in the S3 Glacier Deep Archive storage class.

  • DeepArchiveObjectOverhead – For each archived object, S3 Glacier adds 32 KB of storage for index and related metadata. This extra data is necessary to identify and restore your object. You are charged S3 Glacier Deep Archive rates for this additional storage.

  • DeepArchiveS3ObjectOverhead – For each object archived to S3 Glacier Deep Archive, Amazon S3 uses 8 KB of storage for the name of the object and other metadata. You are charged STANDARD rates for this additional storage.

  • DeepArchiveStagingStorage – The number of bytes used for parts of Multipart objects before the CompleteMultipartUpload request is completed on objects in the S3 Glacier Deep Archive storage class.

FilterId

This dimension filters metrics configurations that you specify for request metrics on a bucket, for example, a prefix or a tag. You specify a filter ID when you create a metrics configuration. For more information, see Creating a metrics configuration.

Amazon S3 Storage Lens dimensions in CloudWatch

For a list of dimensions used to filter S3 Storage Lens metrics in CloudWatch, see Dimensions.