Creare una dashboard di Amazon S3 Storage Lens - Amazon Simple Storage Service

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Creare una dashboard di Amazon S3 Storage Lens

Puoi creare dashboard personalizzati aggiuntivi di S3 Storage Lens che possono essere adattati alla tua organizzazione o a gruppi specifici AWS Organizations Regioni AWS o all'interno di un account.

Nota

Affinché la visualizzazione di qualsiasi aggiornamento alla configurazione del pannello di controllo sia accurata, possono essere necessarie fino a 48 ore.

Attieniti alla procedura seguente per creare un pannello di controllo Amazon S3 Storage Lens sulla console Amazon S3.

Passaggio 1: configura le impostazioni generali

  1. Accedi a Console di gestione AWS e apri la console Amazon S3 all'indirizzo. https://console.aws.amazon.com/s3/

  2. Nella barra di navigazione nella parte superiore della pagina, scegli il nome del file attualmente visualizzato Regione AWS. Quindi, scegli la Regione a cui passare.

  3. Nel pannello di navigazione a sinistra, in S3 Storage Lens scegli Pannelli di controllo.

  4. Seleziona Crea pannello di controllo.

  5. Nella sezione Generale della pagina Pannello di controllo completa le seguenti operazioni:

    1. Visualizzare la Regione di origine della dashboard. La regione principale è la regione Regione AWS in cui sono archiviate la configurazione e le metriche di questa dashboard di Storage Lens.

    2. Specifica il nome di un pannello di controllo.

      I nomi del pannello di controllo devono contenere meno di 65 caratteri e non possono contenere caratteri speciali o spazi.

      Nota

      Il nome del pannello di controllo dopo la creazione non potrà più essere modificato.

    3. Scegli Abilitato per visualizzare le metriche giornaliere aggiornate nella dashboard.

    4. (Facoltativo) Puoi scegliere di aggiungere tag alla tua dashboard. I tag possono essere utilizzati per gestire le autorizzazioni per il pannello di controllo e tenere traccia dei costi per S3 Storage Lens. Per ulteriori informazioni, consulta Controllare l'accesso alle AWS risorse utilizzando i tag nella IAM User Guide e Using AWS-generated tags nella AWS Billing User Guide.

      Nota

      Puoi aggiungere fino a 50 tag alla configurazione del pannello di controllo.

  6. Scegli Avanti per salvare le modifiche e procedere.

Fase 2: Definire l'ambito del dashboard

  1. Nella sezione Ambito della dashboard, scegli le regioni e i bucket che desideri che S3 Storage Lens includa o escluda nella dashboard.

  2. Scegli i bucket nelle regioni selezionate che desideri siano inclusi o esclusi da S3 Storage Lens. Puoi includere o escludere i bucket, ma non puoi eseguire entrambe le operazioni. Questa opzione non è disponibile quando crei dashboard a livello di organizzazione.

    Nota

    • Puoi anche includere o escludere Regioni e bucket. Questa opzione è limitata alle Regioni solo se si creano dashboard a livello di organizzazione tra gli account membri dell'organizzazione.

    • Puoi scegliere fino a 50 bucket da includere o escludere.

  3. Scegli Avanti per salvare le modifiche e procedere.

Passaggio 3: scegli il livello Storage Lens

  1. Nella sezione Storage Lens tier, scegli il livello di funzionalità che desideri aggregare per questa dashboard.

    1. Per includere metriche gratuite aggregate a livello di bucket e disponibili per le query per 14 giorni, scegli il livello gratuito.

    2. Per abilitare le metriche avanzate, scegli il livello Avanzato. Queste opzioni includono l'aggregazione di gruppi di prefissi o Storage Lens, la CloudWatch pubblicazione su Amazon, il report esteso sui prefissi e consigli contestuali. I dati sono disponibili per le query per 15 mesi. I parametri e i suggerimenti avanzati hanno un costo aggiuntivo. Per ulteriori informazioni, consulta Prezzi di Amazon S3.

      Per ulteriori informazioni su parametri avanzati e parametri gratuiti, consulta Selezione delle metriche.

  2. In Categorie di metriche avanzate, seleziona la categoria di metriche che desideri abilitare:

    • Parametri delle attività

    • Detailed status code metrics (Parametri dettagliati codice di stato)

    • Metriche di ottimizzazione dei costi

    • Metriche di protezione dei dati

    • Metriche delle prestazioni

    Per vedere in anteprima quali metriche sono incluse in ogni categoria, utilizza il pulsante con la freccia a discesa sotto l'elenco delle caselle di controllo delle categorie di metriche. Per ulteriori informazioni sulle categorie di parametri, consulta Categorie di parametri. Per un elenco completo di parametri, consulta Glossario dei parametri di Amazon S3 Storage Lens.

  3. Scegli o specifica un delimitatore di prefisso per distinguere i livelli all'interno di ciascun prefisso. Questo valore viene utilizzato per identificare ogni livello di prefisso. Il valore predefinito in Amazon S3 è il carattere "/", ma la struttura di storage potrebbe utilizzare altri caratteri delimitatori.

  4. Scegli Avanti per salvare le modifiche e procedere.

Passaggio 4: (Facoltativo) Scegli l'aggregazione delle metriche

  1. In Aggregazione di metriche aggiuntive, scegli quali metriche vuoi aggregare:

    • Aggregazione di prefisso

    • Aggregazione dei gruppi Storage Lens

  2. Se hai abilitato l'aggregazione dei prefissi, specifica la soglia minima del prefisso per la dashboard e la profondità del prefisso. Quindi, scegli Avanti per salvare e procedere.

    Nota

    L'impostazione della profondità del prefisso determina quanti livelli gerarchici deep S3 Storage Lens analizzerà i prefissi degli oggetti, con un limite massimo di 10 livelli. La soglia del prefisso specifica la percentuale minima di spazio di archiviazione totale che un prefisso deve rappresentare prima di essere incluso nelle metriche di Storage Lens.

  3. Se hai abilitato l'aggregazione dei gruppi di Storage Lens, scegli una delle seguenti opzioni:

    • Includi i gruppi Storage Lens

    • Escludi i gruppi Storage Lens

  4. Quando includi i gruppi Storage Lens nella tua aggregazione, puoi includere tutti i gruppi Storage Lens nella tua regione d'origine o specificare i gruppi Storage Lens da includere.

  5. Scegli Avanti per salvare le modifiche e procedere.

Passaggio 5: (Facoltativo) Scegli le impostazioni di esportazione e pubblicazione delle metriche

  1. In Pubblicazione di metriche, scegli la CloudWatchpubblicazione se desideri accedere alle metriche di Storage Lens nella dashboard. CloudWatch

    Nota

    Le metriche a livello di prefisso non sono disponibili in. CloudWatch

  2. In Esportazione delle metriche, scegli i dati del dashboard di Storage Lens che desideri esportare ogni giorno:

    • Rapporto sulle metriche predefinite

    • Rapporto esteso sulle metriche dei prefissi

  3. (Facoltativo) Se hai scelto Rapporto sulle metriche predefinite, nelle impostazioni del rapporto sulle metriche predefinite, scegli il tipo di bucket. Puoi esportare il report in un bucket Amazon S3 generico o in un bucket da tabella S3 AWS gestito. In base al tipo di bucket selezionato, aggiorna le impostazioni di destinazione del bucket per uso generico o le opzioni di destinazione del bucket Table.

    Nota

    Il rapporto sulle metriche predefinite include solo i prefissi entro la soglia e la profondità impostate nelle impostazioni di aggregazione dei prefissi.

    Se scegli di specificare una chiave di crittografia, devi scegliere una chiave (SSE-KMS) o una AWS KMS chiave gestita Amazon S3 (SSE-S3). Se la policy del bucket di destinazione richiede la crittografia, devi fornire una chiave di crittografia per l'esportazione delle metriche. Senza la chiave di crittografia, l'esportazione verso S3 non riesce. Per ulteriori informazioni, consulta Utilizzo di an AWS KMS key per crittografare le esportazioni delle metriche.

  4. (Facoltativo) Se hai scelto il rapporto sulle metriche dei prefissi espansi, nelle impostazioni del rapporto sulle metriche dei prefissi espansi, scegli il tipo di bucket. Puoi esportare il report in un bucket Amazon S3 generico o in un bucket da tabella S3 di sola lettura. In base al tipo di bucket selezionato, aggiorna le impostazioni di destinazione del bucket per uso generico o le impostazioni di destinazione del bucket Table.

    Nota

    Il rapporto sulle metriche dei prefissi espansi include tutti i prefissi fino alla profondità del prefisso 50 in tutti i bucket selezionati specificati nell'ambito del dashboard.

    Se scegli di specificare una chiave di crittografia, devi scegliere una chiave (SSE-KMS) o una AWS KMS chiave gestita Amazon S3 (SSE-S3). Se la policy del bucket di destinazione richiede la crittografia, devi fornire una chiave di crittografia per l'esportazione delle metriche. Senza la chiave di crittografia, l'esportazione verso S3 non riesce. Per ulteriori informazioni, consulta Utilizzo di an AWS KMS key per crittografare le esportazioni delle metriche.

  5. Scegli Avanti per salvare le modifiche e procedere.

  6. Controlla tutto nella pagina Rivedi e crea. Se non ci sono ulteriori modifiche, scegli Avanti per salvare le modifiche e creare la dashboard.

Passaggio 6: rivedi la configurazione della dashboard e crea la dashboard

  1. Nella sezione Generale, rivedi le tue impostazioni. Scegli Modifica per apportare eventuali modifiche.

  2. Nella sezione Ambito della dashboard, rivedi le tue impostazioni. Scegli Modifica per apportare eventuali modifiche.

  3. Nella sezione Storage Lens tier, rivedi le tue impostazioni. Scegli Modifica per apportare eventuali modifiche.

  4. Nella sezione Aggregazione delle metriche, rivedi le tue impostazioni. Scegli Modifica per apportare eventuali modifiche.

  5. Nella sezione Esportazione delle metriche, rivedi le impostazioni. Scegli Modifica per apportare eventuali modifiche.

  6. Dopo aver esaminato e confermato tutte le impostazioni di configurazione della dashboard, scegli Invia per creare la dashboard.

Dopo aver creato con successo la nuova dashboard di Storage Lens, puoi visualizzarla elencata nella pagina Storage Lens Dashboard.

Esempio

Il seguente esempio di comando crea una configurazione di Amazon S3 Storage Lens con tag. Per utilizzare questi esempi, sostituisci user input placeholders con le tue informazioni.

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
Esempio

Il seguente esempio di comando crea una configurazione di Amazon S3 Storage Lens senza tag. Per utilizzare questi esempi, sostituisci user input placeholders con le informazioni appropriate.

aws s3control put-storage-lens-configuration --account-id=222222222222 --config-id=your-configuration-id --region=us-east-1 --storage-lens-configuration=file://./config.json
Esempio- Creare e aggiornare la configurazione di Amazon S3 Storage Lens

L'esempio seguente crea e aggiorna una configurazione di Amazon S3 Storage Lens in SDK per Java:

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();
        }
    }
}

Per accedere ai gruppi di S3 Storage Lens o ai prefissi espansi, devi aggiornare la dashboard per utilizzare il livello avanzato. Si applicano costi aggiuntivi. Per ulteriori informazioni sui livelli gratuito e avanzato, consultaSelezione delle metriche. Per ulteriori informazioni sui gruppi S3 Storage Lens, consulta Operazioni con i gruppi S3 Storage Lens per filtrare e aggregare le metriche.