Updating an Amazon S3 Storage Lens dashboard - 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.

Updating an Amazon S3 Storage Lens dashboard

Use the following steps to update an Amazon S3 Storage Lens dashboard on the Amazon S3 console.

Step 1: Update the dashboard scope

  1. Sign in to the Amazon Web Services Management Console and open the Amazon S3 console at https://console.amazonaws.cn/s3/.

  2. In the left navigation pane, choose Storage Lens, Dashboards.

  3. Choose the dashboard that you want to edit, and then choose Edit.

    The Edit dashboard page opens.


    You can't change the following:

    • The dashboard name

    • The home Region

    • The dashboard scope of the default dashboard, which is scoped to your entire account's storage

  4. (Optional) On the dashboard configuration page, in the General section, update and add tags to your dashboard.

    You can use tags to manage permissions for your dashboard and to track costs for S3 Storage Lens. For more information, see Controlling access using resource tags in the IAM User Guide and Amazon-Generated Cost Allocation Tags in the Amazon Billing User Guide.


    You can add up to 50 tags to your dashboard configuration.

  5. In the Dashboard scope section, do the following:

    1. Update the Regions and buckets that you want S3 Storage Lens to include or exclude in the dashboard.

      • You can either include or exclude Regions and buckets. This option is limited to Regions only when creating organization-level dashboards across member accounts in your organization.

      • You can choose up to 50 buckets to include or exclude.

    2. Update the buckets in your selected Regions that you want S3 Storage Lens to include or exclude. You can either include or exclude buckets, but not both. This option is not present when creating organization-level dashboards.

Step 2: Update the metrics selection

  1. In the Metrics selection section, choose the type of metrics that you want to aggregate for this dashboard.

    • To include free metrics aggregated at the bucket level and available for queries for 14 days, choose Free metrics.

    • To enable advanced metrics and other advanced options, choose Advanced metrics and recommendations. These options include advanced prefix aggregation, Amazon CloudWatch publishing, and contextual recommendations. Data is available for queries for 15 months. Advanced metrics and recommendations have an additional cost. For more information, see Amazon S3 pricing.

      For more information about advanced metrics and free metrics, see Metrics selection.

  2. Under Advanced metrics and recommendations features, select the options that you want to enable:

    • Advanced metrics

    • CloudWatch publishing

    • Prefix aggregation


    If you enable prefix aggregation for your S3 Storage Lens configuration, prefix-level metrics will not be published to CloudWatch. Only bucket, account, and organization-level S3 Storage Lens metrics are published to CloudWatch.

  3. If you enabled Advanced metrics, select the Advanced metrics categories that you want to display in your S3 Storage Lens dashboard:

    • Activity metrics

    • Detailed status code metrics

    • Advanced cost optimization metrics

    • Advanced data protection metrics

    For more information metrics categories, see Metrics categories. For a complete list of metrics, see Amazon S3 Storage Lens metrics glossary.

  4. If you chose to enable prefix aggregation, configure the following:

    1. Choose the minimum prefix threshold size for this dashboard.

      For example, a prefix threshold of 5 percent indicates that prefixes that make up 5 percent or more of the bucket's total storage size will be aggregated.

    2. Choose the prefix depth.

      This setting indicates the maximum number of levels up to which the prefixes are evaluated. The prefix depth must be less than 10.

    3. Enter a prefix delimiter character.

      This is the value used to identify each prefix level. The default value in Amazon S3 is the / character, but your storage structure might use other delimiter characters.

(Optional) Step 3: Export metrics for the dashboard

  1. In the Metrics export section, to create a metrics export that will be placed daily in a destination bucket of your choice, choose Enable. To disable the metrics export, choose Disable.

    The metrics export is in CSV or Apache Parquet format. It represents the same scope of data as your S3 Storage Lens dashboard data without the recommendations.

  2. If enabled, choose the output format of your daily metrics export: CSV or Apache Parquet.

    Parquet is an open source file format for Hadoop that stores nested data in a flat columnar format.

  3. Choose the destination S3 bucket for your metrics export.

    You can choose a bucket in the current account of the S3 Storage Lens dashboard. Or you can choose another Amazon Web Services account if you have the destination bucket permissions and the destination bucket owner's account ID.

  4. Choose the destination S3 bucket (format: s3://bucket-name/prefix).

    The bucket must be in the home Region of your S3 Storage Lens dashboard. The S3 console shows you the Destination bucket permission that will be added by Amazon S3 to the destination bucket policy. Amazon S3 updates the bucket policy on the destination bucket to allow S3 to place data in that bucket.

  5. (Optional) To enable server-side encryption for your metrics export, choose Specify an encryption key. Then, choose the encryption key type: Amazon S3 managed keys (SSE-S3) or Amazon Key Management Service key (SSE-KMS).

    You can choose between an Amazon S3 managed key (SSE-S3) and an Amazon Key Management Service (Amazon KMS) key (SSE-KMS).

  6. (Optional) To specify an Amazon KMS key, you must choose a KMS key or enter a key Amazon Resource Name (ARN).

    If you choose a customer managed key, you must grant S3 Storage Lens permission to encrypt in the Amazon KMS key policy. For more information, see Using an Amazon KMS key to encrypt your metrics exports

  7. Choose Save changes.