View a markdown version of this page

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 personalizzate aggiuntive di S3 Storage Lens che possono essere associate alla tua organizzazione in AWS Organizations o a specifici Regioni AWS bucket 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.

Fase 1: Configurare le impostazioni generali

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

  2. Nella barra di navigazione, scegli il nome dell'oggetto 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 per 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 Guida per l'utente IAM e Utilizzo dei tag AWS generati nella Guida per l'AWS Billing utente.

      Nota

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

  6. Scegli Avanti per salvare le modifiche e procedere.

Passaggio 2: definire l'ambito del dashboard

  1. Nella sezione Ambito del 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 di 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 domande per 14 giorni, scegli il livello gratuito.

    2. Per abilitare le metriche avanzate, scegli il livello avanzato. Queste opzioni includono l'aggregazione dei gruppi di prefissi o Storage Lens, la CloudWatch pubblicazione su Amazon, il rapporto sui prefissi espansi e i 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 visualizzare in anteprima quali metriche sono incluse in ciascuna categoria, utilizza il pulsante freccia a discesa sotto l'elenco delle caselle di controllo della categoria delle 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.

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

  1. In Aggregazione delle 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 di profondità S3 Storage Lens analizzerà i prefissi degli oggetti, con un limite massimo di 10 livelli. La soglia Prefix 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 Storage Lens, scegli una delle seguenti opzioni:

    • Includi i gruppi Storage Lens

    • Escludere i gruppi Storage Lens

  4. Quando includi i gruppi Storage Lens nell'aggregazione, puoi includere tutti i gruppi Storage Lens nella tua regione principale 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 delle metriche, scegli la CloudWatch pubblicazione se desideri accedere alle metriche di Storage Lens nella dashboard. CloudWatch

    Nota

    Prefix-level le metriche non sono disponibili in. CloudWatch

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

    • Rapporto sulle metriche predefinite

    • Rapporto sulle metriche dei prefissi espanso

  3. (Facoltativo) Se hai scelto il 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 tabellare S3 gestito. AWS In base al tipo di bucket selezionato, aggiorna le opzioni General Purpose bucket destination settings o Table bucket destination settings.

    Nota

    Il rapporto sulle metriche predefinito include solo i prefissi all'interno della soglia e della 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 da Amazon S3 (). SSE-S3 Se la tua 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 in S3 non riesce. Per ulteriori informazioni, consulta Utilizzando un 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 tabellare 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 estesi include tutti i prefissi fino alla profondità del prefisso 50 in tutti i bucket selezionati specificati nell'ambito della dashboard.

    Se scegli di specificare una chiave di crittografia, devi scegliere una chiave (SSE-KMS) o una AWS KMS chiave gestita da Amazon S3 (). SSE-S3 Se la tua 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 in S3 non riesce. Per ulteriori informazioni, consulta Utilizzando un 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 tua dashboard.

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

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

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

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

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

  5. Nella sezione Esportazione delle metriche, rivedi le tue impostazioni. Scegli Modifica per apportare 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 estesi, 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.