--- title: Amazon S3 Storage Lens description: >- Amazon S3 Storage Lens provides a single view of object storage usage and activity across your entire Amazon S3 storage. breadcrumbs: Docs > Integrations > Amazon S3 Storage Lens --- # Amazon S3 Storage Lens ## Overview{% #overview %} Amazon S3 Storage Lens provides a single view of usage and activity across your Amazon S3 storage. You can use S3 Storage Lens to generate summary insights, such as finding out how much storage you have across your entire organization, or which are the fastest growing buckets and prefixes. Identify outliers in your storage metrics, and then drill down to further investigate the source of the spike in usage or activity. Enable this integration to see all your S3 Storage Lens metrics in Datadog. ## Setup{% #setup %} ### Installation{% #installation %} If you haven't already, set up the [Amazon Web Services integration](https://docs.datadoghq.com/integrations/amazon_web_services.md) first. ### Metric collection{% #metric-collection %} 1. Enable [CloudWatch publishing for S3 Storage Lens](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-lens-cloudwatch-enable-publish-option.html) within your AWS account. You must be using "Advanced metrics and recommendations" to use this feature. 1. In the [AWS integration page](https://app.datadoghq.com/integrations/amazon-web-services), ensure that `S3 Storage Lens` is enabled under the `Metric Collection` tab. 1. Install the [Datadog - Amazon S3 Storage Lens integration](https://app.datadoghq.com/integrations/amazon-s3-storage-lens). **Note:** S3 Storage Lens metrics are daily metrics and are published to CloudWatch once per day. ## Data Collected{% #data-collected %} ### Metrics{% #metrics %} | | | | | **aws.s3.storagelens.4xx\_errors**(gauge) | The total number of HTTP 4xx errors in scope.*Shown as error* | | **aws.s3.storagelens.5xx\_errors**(gauge) | The total number of HTTP 5xx server errors in scope.*Shown as error* | | **aws.s3.storagelens.all\_requests**(gauge) | The total number of HTTP requests made.*Shown as request* | | **aws.s3.storagelens.bytes\_downloaded**(gauge) | The total number bytes downloaded.*Shown as byte* | | **aws.s3.storagelens.bytes\_uploaded**(gauge) | The total number bytes uploaded.*Shown as byte* | | **aws.s3.storagelens.current\_version\_object\_count**(gauge) | The total number of objects that are current version.*Shown as object* | | **aws.s3.storagelens.current\_version\_storage\_bytes**(gauge) | The total number of bytes that are current version.*Shown as byte* | | **aws.s3.storagelens.delete\_marker\_object\_count**(gauge) | The total number of objects with a delete marker.*Shown as object* | | **aws.s3.storagelens.delete\_requests**(gauge) | The total number of HTTP DELETE requests made.*Shown as request* | | **aws.s3.storagelens.encrypted\_object\_count**(gauge) | The total number of objects that are encrypted with S3 server-side encryption.*Shown as object* | | **aws.s3.storagelens.encrypted\_storage\_bytes**(gauge) | The total number of bytes that are encrypted with S3 server-side encryption.*Shown as byte* | | **aws.s3.storagelens.get\_requests**(gauge) | The total number of HTTP GET requests made.*Shown as request* | | **aws.s3.storagelens.head\_requests**(gauge) | The total number of HTTP HEAD requests made.*Shown as request* | | **aws.s3.storagelens.incomplete\_multipart\_upload\_object\_count**(gauge) | The total number of objects with incomplete multipart uploads.*Shown as object* | | **aws.s3.storagelens.incomplete\_multipart\_upload\_storage\_bytes**(gauge) | The total number of bytes with incomplete multipart uploads.*Shown as byte* | | **aws.s3.storagelens.list\_requests**(gauge) | The total number of HTTP requests made that list contents.*Shown as request* | | **aws.s3.storagelens.non\_current\_version\_object\_count**(gauge) | The total number of objects that are not current version.*Shown as object* | | **aws.s3.storagelens.non\_current\_version\_storage\_bytes**(gauge) | The total number of bytes that are not current version.*Shown as byte* | | **aws.s3.storagelens.object\_count**(gauge) | The total number of objects.*Shown as object* | | **aws.s3.storagelens.object\_lock\_enabled\_object\_count**(gauge) | The total number of objects with Object Lock enabled.*Shown as object* | | **aws.s3.storagelens.object\_lock\_enabled\_storage\_bytes**(gauge) | The total number of bytes with Object Lock enabled.*Shown as byte* | | **aws.s3.storagelens.post\_requests**(gauge) | The total number of HTTP POST requests made.*Shown as request* | | **aws.s3.storagelens.put\_requests**(gauge) | The total number of HTTP PUT requests made.*Shown as request* | | **aws.s3.storagelens.replicated\_object\_count**(gauge) | The total number of objects that are replicated.*Shown as object* | | **aws.s3.storagelens.replicated\_storage\_bytes**(gauge) | The total number of bytes that are replicated.*Shown as byte* | | **aws.s3.storagelens.select\_requests**(gauge) | The total number of select requests made.*Shown as request* | | **aws.s3.storagelens.select\_returned\_bytes**(gauge) | The total number of select bytes returned.*Shown as byte* | | **aws.s3.storagelens.select\_scanned\_bytes**(gauge) | The total number of select bytes scanned.*Shown as byte* | | **aws.s3.storagelens.storage\_bytes**(gauge) | The total number of storage bytes.*Shown as byte* | ### Events{% #events %} The Amazon S3 Storage Lens integration does not include any events. ### Service Checks{% #service-checks %} The Amazon S3 Storage Lens integration does not include any service checks. ## Troubleshooting{% #troubleshooting %} Need help? Contact [Datadog support](https://docs.datadoghq.com/help/). ## Further Reading{% #further-reading %} - [Monitor and optimize S3 storage with Amazon S3 Storage Lens metrics](https://www.datadoghq.com/blog/amazon-s3-storage-lens-monitoring-datadog/)