Managing S3 on Outposts capacity with Amazon CloudWatch metrics - Amazon Simple Storage Service
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China.

Managing S3 on Outposts capacity with Amazon CloudWatch metrics

If there is not enough space to store an object on your Outpost, the API returns an insufficient capacity exemption (ICE). To avoid this, you can create CloudWatch alerts that tell you when storage utilization exceeds a certain threshold. For more information, see Amazon S3 on Outposts metrics in CloudWatch.

You can use this method to free up space by explicitly deleting data, using a lifecycle expiration policy, or copying data from your Amazon S3 on Outposts bucket to an S3 bucket in an Amazon Web Services Region by using Amazon DataSync. For more information about using DataSync, see Getting Started with Amazon DataSync in the Amazon DataSync User Guide.

CloudWatch metrics

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