建立 Amazon S3 Storage Lens 儀表板

您可以建立額外的 S3 Storage Lens 自訂儀表板，這些儀表板可以範圍限定在帳戶中的組織， AWS Organizations 或是特定 AWS 區域或帳戶中的儲存貯體。

注意

對儀表板組態的任何更新最多可能需要 48 小時才能正確顯示或視覺化。

使用下列步驟在 Amazon S3 主控台上建立 Amazon S3 Storage Lens 儀表板。

步驟 1：設定一般設定

登入 AWS 管理主控台，並在 https://console.aws.amazon.com/s3/：// 開啟 Amazon S3 主控台。
在頁面頂端的導覽列中，選擇目前顯示的名稱 AWS 區域。接下來，選擇您想要切換到的區域。
在左導覽窗格的 S3 Storage Lens 下，選擇儀表板。
選擇 Create dashboard (建立儀表板)。
在 Dashboard (儀表板) 頁面的 General (一般) 區段中，執行以下動作：
1. 檢視儀表板的主要區域。主要區域是存放此 Storage Lens 儀表板 AWS 區域組態和指標的。
2. 輸入儀表板名稱。
  
  儀表板名稱必須少於 65 個字元，且不得包含特殊字元或空格。
  
  注意
  建立儀表板後，您就無法變更此儀表板名稱。
3. 選擇啟用，在儀表板中顯示更新的每日指標。
4. （選用）您可以選擇將標籤新增至儀表板。您可以使用標籤來管理儀表板的權限，並追蹤 S3 Storage Lens 的成本。如需詳細資訊，請參閱《IAM 使用者指南》中的使用標籤控制對 AWS 資源的存取，以及AWS Billing 《使用者指南》中的使用 AWS產生的標籤。
  
  注意
  您最多可為儀表板組態中新增 50 個標籤。
選擇下一步以儲存變更並繼續。

步驟 2：定義儀表板範圍

在儀表板範圍區段中，選擇您希望 S3 Storage Lens 在儀表板中包含或排除的區域和儲存貯體。
選擇您希望 S3 Storage Lens 包含或排除的選取區域儲存貯體。您可以包含或排除儲存貯體，但不能同時包含和排除。當您建立組織層級儀表板時，此選項無法使用。
注意
- 您可以包含或排除區域和儲存貯體。在組織中跨成員帳戶建立組織層級儀表板時，此選項會僅限於「區域」。
- 您最多可以選擇 50 個要包含或排除的儲存貯體。
選擇下一步以儲存變更並繼續。

步驟 3：選擇 Storage Lens 方案

在 Storage Lens 層區段中，選擇要為此儀表板彙總的功能層。
1. 若要包含在儲存貯體層級彙總並可用於查詢 14 天的免費指標，請選擇免費方案。
2. 若要啟用進階指標，請選擇進階層。這些選項包括字首或 Storage Lens 群組彙總、Amazon CloudWatch 發佈、擴充字首報告，以及內容建議。資料有 15 個月的時間可用於查詢。進階指標和建議會有額外的費用。如需詳細資訊，請參閱 Simple Storage Service (Amazon S3) 定價。
  
  如需進階指標和免費指標的詳細資訊，請參閱指標選擇。
在進階指標類別下，選取您要啟用的指標類別：
- 活動指標
- Detailed status code metrics (詳細的狀態碼指標)
- 成本最佳化指標
- 資料保護指標
- 效能指標
若要預覽每個類別中包含哪些指標，請使用指標類別核取方塊清單下方的下拉箭頭按鈕。如需指標類別的詳細資訊，請參閱指標類別。如需指標的完整清單，請參閱Amazon S3 Storage Lens 指標詞彙表。
選擇或指定字首分隔符號，以區分每個字首內的層級。此值用來識別每個字首層級。Amazon S3 中的預設值是「/」字元，但您的儲存結構可能會使用其他分隔符號字元。
選擇下一步以儲存變更並繼續。

步驟 4：（選用）選擇您的指標彙總

在其他指標彙總下，選擇要彙總的指標：
- 字首彙總
- Storage Lens 群組彙總
如果您已啟用字首彙總，請指定儀表板和字首深度的最低字首閾值。然後，選擇下一步以儲存並繼續。

注意
字首深度設定會決定深度 S3 Storage Lens 會分析物件字首的階層層級，上限為 10 個層級。字首閾值指定字首在包含在 Storage Lens 指標中之前，必須代表的總儲存量百分比下限。
如果您已啟用 Storage Lens 群組彙總，請選擇下列其中一項：
- 包含 Storage Lens 群組
- 排除 Storage Lens 群組
當您在彙總中包含 Storage Lens 群組時，您可以包含主區域中的所有 Storage Lens 群組，或指定要包含的 Storage Lens 群組。
選擇下一步以儲存變更並繼續。

步驟 5：（選用）選擇您的指標匯出和發佈設定

在指標發佈下，如果您想要存取 CloudWatch 儀表板中的 Storage Lens 指標，請選擇 CloudWatch 發佈。 CloudWatch

注意
CloudWatch 中無法使用字首層級指標。
在指標匯出下，選擇您要每天匯出的 Storage Lens 儀表板資料：
- 預設指標報告
- 擴充字首指標報告
（選用）如果您選擇預設指標報告，請在預設指標報告設定中選擇儲存貯體類型。您可以將報告匯出至一般用途的 Amazon S3 儲存貯體 AWS或受管 S3 資料表儲存貯體。根據選取的儲存貯體類型，更新一般用途儲存貯體目的地設定或資料表儲存貯體目的地設定選項。

注意
預設指標報告僅包含設定閾值內的字首，以及字首彙總設定中設定的深度。
如果您選擇指定加密金鑰，則必須選擇 AWS KMS 金鑰 (SSE-KMS) 或 Amazon S3 受管金鑰 (SSE-S3)。如果您的目的地儲存貯體政策需要加密，您必須為指標匯出提供加密金鑰。如果沒有加密金鑰，匯出至 S3 失敗。如需詳細資訊，請參閱使用 AWS KMS key 加密指標匯出。
（選用）如果您選擇展開字首指標報告，請在展開字首指標報告設定中選擇儲存貯體類型。您可以將報告匯出至一般用途的 Amazon S3 儲存貯體或唯讀 S3 資料表儲存貯體。根據選取的儲存貯體類型，更新一般用途儲存貯體目的地設定或資料表儲存貯體目的地設定。

注意
擴展字首指標報告包含儀表板範圍中指定之所有所選儲存貯體中字首深度上限為 50 的所有字首。
如果您選擇指定加密金鑰，則必須選擇 AWS KMS 金鑰 (SSE-KMS) 或 Amazon S3 受管金鑰 (SSE-S3)。如果您的目的地儲存貯體政策需要加密，您必須為指標匯出提供加密金鑰。如果沒有加密金鑰，匯出至 S3 失敗。如需詳細資訊，請參閱使用 AWS KMS key 加密指標匯出。
選擇下一步以儲存變更並繼續。
檢閱和建立頁面上的所有內容。如果沒有其他變更，請選擇下一步以儲存變更並建立儀表板。

步驟 6：檢閱儀表板組態並建立儀表板

在一般區段中，檢閱您的設定。選擇編輯以進行任何變更。
在儀表板範圍區段中，檢閱您的設定。選擇編輯以進行任何變更。
在 Storage Lens 方案區段中，檢閱您的設定。選擇編輯以進行任何變更。
在指標彙總區段中，檢閱您的設定。選擇編輯以進行任何變更。
在指標匯出區段中，檢閱您的設定。選擇編輯以進行任何變更。
檢閱並確認所有儀表板組態設定後，請選擇提交以建立儀表板。

成功建立新的 Storage Lens 儀表板後，您可以檢視 Storage Lens 儀表板頁面下列出的新儀表板。

範例

下列範例命令會建立包含標籤的 Amazon S3 Storage Lens 組態。若要使用這些範例，請以您自己的資訊取代 user input placeholders。


aws s3control put-storage-lens-configuration --account-id=111122223333 --config-id=example-dashboard-configuration-id --region=us-east-1 --storage-lens-configuration=file://./config.json --tags=file://./tags.json

範例

下列範例命令會建立不含標籤的 Amazon S3 Storage Lens 組態。若要使用這些範例，請以您自己的資訊取代 user input placeholders。


aws s3control put-storage-lens-configuration --account-id=222222222222 --config-id=your-configuration-id --region=us-east-1 --storage-lens-configuration=file://./config.json

範例– 建立和更新 Amazon S3 Storage Lens 組態

下列範例會在適用於 Java 的 SDK 中建立和更新 Amazon S3 Storage Lens 組態：


package aws.example.s3control;

import software.amazon.awssdk.awscore.exception.AwsServiceException;
import software.amazon.awssdk.core.exception.SdkClientException;
import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.s3control.S3ControlClient;
import software.amazon.awssdk.services.s3control.model.AccountLevel;
import software.amazon.awssdk.services.s3control.model.ActivityMetrics;
import software.amazon.awssdk.services.s3control.model.AdvancedCostOptimizationMetrics;
import software.amazon.awssdk.services.s3control.model.AdvancedDataProtectionMetrics;
import software.amazon.awssdk.services.s3control.model.AdvancedPerformanceMetrics;
import software.amazon.awssdk.services.s3control.model.BucketLevel;
import software.amazon.awssdk.services.s3control.model.CloudWatchMetrics;
import software.amazon.awssdk.services.s3control.model.DetailedStatusCodesMetrics;
import software.amazon.awssdk.services.s3control.model.Format;
import software.amazon.awssdk.services.s3control.model.Include;
import software.amazon.awssdk.services.s3control.model.OutputSchemaVersion;
import software.amazon.awssdk.services.s3control.model.PrefixLevel;
import software.amazon.awssdk.services.s3control.model.PrefixLevelStorageMetrics;
import software.amazon.awssdk.services.s3control.model.PutStorageLensConfigurationRequest;
import software.amazon.awssdk.services.s3control.model.S3BucketDestination;
import software.amazon.awssdk.services.s3control.model.SSES3;
import software.amazon.awssdk.services.s3control.model.SelectionCriteria;
import software.amazon.awssdk.services.s3control.model.StorageLensAwsOrg;
import software.amazon.awssdk.services.s3control.model.StorageLensConfiguration;
import software.amazon.awssdk.services.s3control.model.StorageLensDataExport;
import software.amazon.awssdk.services.s3control.model.StorageLensDataExportEncryption;
import software.amazon.awssdk.services.s3control.model.StorageLensExpandedPrefixesDataExport;
import software.amazon.awssdk.services.s3control.model.StorageLensTableDestination;
import software.amazon.awssdk.services.s3control.model.StorageLensTag;

import java.util.Arrays;
import java.util.List;

public class CreateAndUpdateDashboard {

    public static void main(String[] args) {
        String configurationId = "ConfigurationId";
        String sourceAccountId = "111122223333";
        String exportAccountId = "Destination Account ID";
        String exportBucketArn = "arn:aws:s3:::destBucketName"; // The destination bucket for your metrics export must be in the same Region as your S3 Storage Lens configuration.
        String awsOrgARN = "arn:aws:organizations::123456789012:organization/o-abcdefgh";
        Format exportFormat = Format.CSV;

        try {
            SelectionCriteria selectionCriteria = SelectionCriteria.builder()
                    .delimiter("/")
                    .maxDepth(5)
                    .minStorageBytesPercentage(10.0)
                    .build();

            PrefixLevelStorageMetrics prefixStorageMetrics = PrefixLevelStorageMetrics.builder()
                    .isEnabled(true)
                    .selectionCriteria(selectionCriteria)
                    .build();

            BucketLevel bucketLevel = BucketLevel.builder()
                    .activityMetrics(ActivityMetrics.builder().isEnabled(true).build())
                    .advancedCostOptimizationMetrics(AdvancedCostOptimizationMetrics.builder().isEnabled(true).build())
                    .advancedDataProtectionMetrics(AdvancedDataProtectionMetrics.builder().isEnabled(true).build())
                    .advancedPerformanceMetrics(AdvancedPerformanceMetrics.builder().isEnabled(true).build())
                    .detailedStatusCodesMetrics(DetailedStatusCodesMetrics.builder().isEnabled(true).build())
                    .prefixLevel(PrefixLevel.builder().storageMetrics(prefixStorageMetrics).build())
                    .build();

            AccountLevel accountLevel = AccountLevel.builder()
                    .activityMetrics(ActivityMetrics.builder().isEnabled(true).build())
                    .advancedCostOptimizationMetrics(AdvancedCostOptimizationMetrics.builder().isEnabled(true).build())
                    .advancedPerformanceMetrics(AdvancedPerformanceMetrics.builder().isEnabled(true).build())
                    .advancedDataProtectionMetrics(AdvancedDataProtectionMetrics.builder().isEnabled(true).build())
                    .detailedStatusCodesMetrics(DetailedStatusCodesMetrics.builder().isEnabled(true).build())
                    .bucketLevel(bucketLevel)
                    .build();

            Include include = Include.builder()
                    .buckets(Arrays.asList("arn:aws:s3:::bucketName"))
                    .regions(Arrays.asList("us-west-2"))
                    .build();

            StorageLensDataExportEncryption exportEncryption = StorageLensDataExportEncryption.builder()
                    .sses3(SSES3.builder().build())
                    .build();

            S3BucketDestination s3BucketDestination = S3BucketDestination.builder()
                    .accountId(exportAccountId)
                    .arn(exportBucketArn)
                    .encryption(exportEncryption)
                    .format(exportFormat)
                    .outputSchemaVersion(OutputSchemaVersion.V_1)
                    .prefix("Prefix")
                    .build();

            StorageLensTableDestination s3TablesDestination = StorageLensTableDestination.builder()
                    .encryption(exportEncryption)
                    .isEnabled(true)
                    .build();

            CloudWatchMetrics cloudWatchMetrics = CloudWatchMetrics.builder()
                    .isEnabled(true)
                    .build();

            StorageLensDataExport dataExport = StorageLensDataExport.builder()
                    .cloudWatchMetrics(cloudWatchMetrics)
                    .s3BucketDestination(s3BucketDestination)
                    .storageLensTableDestination(s3TablesDestination)
                    .build();

            StorageLensAwsOrg awsOrg = StorageLensAwsOrg.builder()
                    .arn(awsOrgARN)
                    .build();

            StorageLensExpandedPrefixesDataExport expandedPrefixesDataExport = StorageLensExpandedPrefixesDataExport.builder()
                    .s3BucketDestination(s3BucketDestination)
                    .storageLensTableDestination(s3TablesDestination)
                    .build();

            StorageLensConfiguration configuration = StorageLensConfiguration.builder()
                    .id(configurationId)
                    .accountLevel(accountLevel)
                    .include(include)
                    .dataExport(dataExport)
                    .awsOrg(awsOrg)
                    .expandedPrefixesDataExport(expandedPrefixesDataExport)
                    .prefixDelimiter("/")
                    .isEnabled(true)
                    .build();

            List<StorageLensTag> tags = Arrays.asList(
                    StorageLensTag.builder().key("key-1").value("value-1").build(),
                    StorageLensTag.builder().key("key-2").value("value-2").build()
            );

            S3ControlClient s3ControlClient = S3ControlClient.builder()
                    .region(Region.US_WEST_2)
                    .credentialsProvider(ProfileCredentialsProvider.create())
                    .build();

            s3ControlClient.putStorageLensConfiguration(PutStorageLensConfigurationRequest.builder()
                    .accountId(sourceAccountId)
                    .configId(configurationId)
                    .storageLensConfiguration(configuration)
                    .tags(tags)
                    .build()
            );

        } catch (AwsServiceException e) {
            // The call was transmitted successfully, but Amazon S3 couldn't process
            // it and returned an error response.
            e.printStackTrace();
        } catch (SdkClientException e) {
            // Amazon S3 couldn't be contacted for a response, or the client
            // couldn't parse the response from Amazon S3.
            e.printStackTrace();
        }
    }
}

若要存取 S3 Storage Lens 群組或擴充字首，您必須升級儀表板才能使用進階層。需支付額外費用。如需免費和進階方案的詳細資訊，請參閱指標選擇。如需關於 S3 Storage Lens 群組的詳細資訊，請參閱使用 S3 Storage Lens 群組來篩選和彙總指標。

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

使用 Amazon S3 Storage Lens

更新儀表板