Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Activation de la publication sur CloudWatch pour S3 Storage Lens
Vous pouvez publier les métriques S3 Storage Lens sur Amazon CloudWatch pour créer une vue unifiée de votre état opérationnel dans les tableaux de bord CloudWatch. Vous pouvez également utiliser les fonctionnalités CloudWatch, comme les alarmes et les actions déclenchées, les mathématiques appliquées aux métriques et la détection d'anomalies pour surveiller les métriques S3 Storage Lens et agir dessus. En outre, les opérations d'API CloudWatch permettent aux applications, y compris à celles des fournisseurs tiers, d'accéder à vos métriques S3 Storage Lens. Pour de plus amples informations sur les fonctions de CloudWatch, consultez le guide de l'utilisateur Amazon CloudWatch.
Les métriques S3 Storage Lens sont publiées sur CloudWatch dans le compte propriétaire de la configuration S3 Storage Lens. Une fois que vous avez activé l'option de publication sur CloudWatch dans les métriques et recommandations avancées, vous pouvez accéder aux métriques au niveau de l'organisation, du compte et du compartiment dans CloudWatch. Les métriques au niveau du préfixe ne sont pas disponibles dans CloudWatch.
Vous pouvez activer la prise en charge CloudWatch pour des configurations de tableau de bord nouvelles ou existantes à l'aide de la console S3, des API REST Amazon S3, d'AWS CLI et des kits AWS SDK. L'option de publication sur CloudWatch est disponible pour les tableaux de bord mis à niveau vers les métriques et recommandations avancées S3 Storage Lens. Pour obtenir la tarification des métriques et recommandations avancées S3 Storage Lens, consultez Tarification Amazon S3
Pour activer l'option CloudWatch publishing (publication sur CloudWatch) pour les métriques S3 Storage Lens, consultez les rubriques ci-dessous.
Note
Les métriques S3 Storage Lens sont des métriques quotidiennes et sont publiées sur CloudWatch une fois par jour. Lorsque vous interrogez des métriques S3 Storage Lens dans CloudWatch, la période de la requête doit être d'un jour (86 400 secondes). Une fois que vos métriques quotidiennes S3 Storage Lens s'affichent dans votre tableau de bord S3 Storage Lens de la console Amazon S3, plusieurs heures peuvent être nécessaires pour que ces mêmes métriques s'affichent dans CloudWatch. Lorsque vous activez l'option CloudWatch publishing (publication sur CloudWatch) pour les métriques S3 Storage Lens pour la première fois, la publication de vos métriques sur CloudWatch peut prendre jusqu'à 24 heures.
Actuellement, les métriques S3 Storage Lens ne peuvent pas être utilisées via les flux CloudWatch.
Lorsque vous mettez à jour un tableau de bord S3 Storage Lens, vous ne pouvez pas modifier le nom du tableau de bord ni la région d'origine. Vous ne pouvez pas non plus modifier la portée du tableau de bord par défaut, qui est délimitée à l'ensemble du stockage de votre compte.
Pour mettre à jour un tableau de bord S3 Storage Lens afin d'activer la publication sur CloudWatch
-
Connectez-vous à la AWS Management Console et ouvrez la console Amazon S3 à l'adresse https://console.aws.amazon.com/s3/
. -
Dans le panneau de navigation de gauche, choisissez S3 Storage Lens, Dashboards (Tableaux de bord).
-
Choisissez le tableau de bord que vous souhaitez modifier, puis choisissez Edit (Modifier).
-
Sous Metrics selection (Sélection des métriques), choisissez Advanced metrics and recommendations (Métriques et recommandations avancées).
Des métriques et recommandations avancées sont disponibles moyennant des frais supplémentaires. Les métriques et recommandations avancées incluent une période de 15 mois pour les requêtes de données, les métriques d'utilisation agrégées au niveau du préfixe, les métriques d'activité agrégées par compartiment, l'option de publication sur CloudWatch et les recommandations contextuelles qui vous aident à optimiser les coûts de stockage et à appliquer les bonnes pratiques de protection des données. Pour de plus amples informations, veuillez consulter Tarification Amazon S3
. -
Sous Select Advanced metrics and recommendations features (Sélectionner les métriques et les recommandations avancées), sélectionnez CloudWatch publishing (Publication sur CloudWatch).
Important
Si votre configuration autorise l'agrégation de préfixes pour les métriques d'utilisation, les métriques au niveau du préfixe ne seront pas publiées sur CloudWatch. Seules les métriques S3 Storage Lens au niveau du compartiment, du compte et de l'organisation sont publiées sur CloudWatch.
-
Sélectionnez Save Changes (Enregistrer les modifications).
Création d'un tableau de bord S3 Storage Lens qui permet la prise en charge de CloudWatch
-
Connectez-vous à la AWS Management Console et ouvrez la console Amazon S3 à l'adresse https://console.aws.amazon.com/s3/
. -
Dans le panneau de navigation de gauche, choisissez Storage Lens, Dashboards (Tableaux de bord).
-
Choisissez Create dashboard (Créer un tableau de bord).
-
Sous General (Général), définissez les options de configuration suivantes :
-
Dans Dashboard name (Nom du tableau de bord), saisissez le nom de votre tableau de bord.
Les noms de tableau de bord doivent contenir moins de 65 caractères et ne doivent pas contenir de caractères spéciaux ou d'espaces. Vous ne pouvez pas modifier le nom d'un tableau de bord une fois que vous l'avez créé.
-
Sélectionnez la Home Region (Région d'origine) de votre tableau de bord.
Les métriques de toutes les Régions incluses dans la portée de ce tableau de bord sont stockées de manière centralisée dans la Région d'origine désignée. Dans CloudWatch, les métriques S3 Storage Lens sont également disponibles dans la Région d'origine. Vous ne pouvez pas modifier la région d'origine une fois que vous avez créé votre tableau de bord.
-
-
(Facultatif) Pour ajouter des étiquettes, choisissez Add tag (Ajouter une balise) et saisissez la Key (Clé) d'étiquette et une Value (Valeur).
Note
Vous pouvez ajouter jusqu'à 50 balises à votre configuration de tableau de bord.
-
Définissez la portée de votre configuration :
-
Si vous créez une configuration au niveau de l'organisation, choisissez les comptes à inclure dans la configuration : Include all accounts in your configuration (Inclure tous les comptes dans votre configuration) ou Limit the scope to your signed-in account (Limiter la portée au compte connecté).
Note
Lorsque vous créez une configuration au niveau de l'organisation qui inclut tous les comptes, vous pouvez inclure ou exclure uniquement des régions, et non pas des compartiments.
-
Choisissez les régions et les compartiments que vous souhaitez que S3 Storage Lens inclue de la configuration du tableau de bord en procédant comme suit :
-
Pour inclure toutes les Régions, choisissez Include Regions and buckets (Inclure les Régions et les compartiments).
-
Pour inclure des Régions spécifiques, effacez Include all Regions (Inclure toutes les Régions). Sous Choose Regions to include (Choisir les Régions à inclure), choisissez les Régions que vous souhaitez que S3 Storage Lens inclue dans le tableau de bord.
-
Pour inclure des compartiments spécifiques, effacez Include all buckets (Inclure tous les compartiments). Sous Choose buckets to include (Choisir les compartiments à inclure), choisissez les compartiments que vous souhaitez que S3 Storage Lens inclue dans le tableau de bord.
Note
Vous pouvez choisir jusqu'à 50 compartiments.
-
-
-
Pour Metrics selection (Sélection des métriques), choisissez Advanced metrics and recommendations (Métriques et recommandations avancées).
Pour plus d'informations sur la tarification des métriques et recommandations avancées, consultez Tarification Amazon S3
. -
Sous Advanced metrics and recommendations features (Fonctionnalités de métriques et recommandations avancées), sélectionnez les options que vous voulez activer :
-
Advanced metrics (Métriques avancées)
-
CloudWatch publishing (Publication sur CloudWatch)
Important
Si vous activez l'agrégation de préfixes pour votre configuration S3 Storage Lens, les métriques au niveau du préfixe ne seront pas publiées sur CloudWatch. Seules les métriques S3 Storage Lens au niveau du compartiment, du compte et de l'organisation sont publiées sur CloudWatch.
-
Prefix aggregation (Agrégation de préfixes)
Note
Pour plus d'informations sur les fonctionnalités des métriques et recommandations avancées, consultez Sélection des métriques.
-
-
Si vous avez activé Advanced metrics (Métriques avancées), sélectionnez les Advanced metrics categories (Catégories de métriques avancées) que vous souhaitez afficher dans votre tableau de bord S3 Storage Lens :
-
Métriques d'activité
-
Detailed status code metrics (Métriques détaillées sur le code de statut)
-
Advanced cost optimization metrics (Métriques avancées sur l'optimisation des coûts)
-
Advanced data protection metrics (Métriques avancées sur la protection des données)
Pour plus d'informations sur les catégories de métriques, consultez Catégories de métriques. Pour obtenir une liste complète des métriques, consultez Glossaire des métriques Amazon S3 Storage Lens.
-
-
(Facultatif) Configurez l'exportation de vos métriques.
Pour plus d'informations sur la configuration d'une exportation de métriques, consultez l'étape Créer un tableau de bord Amazon S3 Storage Lens.
-
Choisissez Create dashboard (Créer un tableau de bord).
L'exemple AWS CLI suivant permet d'activer l'option de publication sur CloudWatch à l'aide d'une configuration S3 Storage Lens au niveau de l'organisation des métriques et recommandations avancées. Pour utiliser cet exemple, remplacez
par vos propres informations.user input
placeholders
aws s3control put-storage-lens-configuration --account-id=
555555555555
--config-id=your-configuration-id
--region=us-east-1
--storage-lens-configuration=file://./config.json config.json { "Id": "SampleS3StorageLensConfiguration
", //Use this property to identify your S3 Storage Lens configuration. "AwsOrg": { //Use this property when enabling S3 Storage Lens for AWS Organizations. "Arn": "arn:aws:organizations::123456789012
:organization/o-abcdefgh
" }, "AccountLevel": { "ActivityMetrics": { "IsEnabled":true
}, "AdvancedCostOptimizationMetrics": { "IsEnabled":true
}, "AdvancedDataProtectionMetrics": { "IsEnabled":true
}, "DetailedStatusCodesMetrics": { "IsEnabled":true
}, "BucketLevel": { "ActivityMetrics": { "IsEnabled":true
//Mark this as false if you want only free metrics. }, "ActivityMetrics": { "IsEnabled":true
//Mark this as false if you want only free metrics. }, "AdvancedCostOptimizationMetrics": { "IsEnabled":true
//Mark this as false if you want only free metrics. }, "DetailedStatusCodesMetrics": { "IsEnabled":true
//Mark this as false if you want only free metrics. }, "PrefixLevel":{ "StorageMetrics":{ "IsEnabled":true
, //Mark this as false if you want only free metrics. "SelectionCriteria":{ "MaxDepth":5
, "MinStorageBytesPercentage":1.25
, "Delimiter":"/
" } } } } }, "Exclude": { //Replace with "Include" if you prefer to include Regions. "Regions": [ "eu-west-1
" ], "Buckets": [ //This attribute is not supported for AWS Organizations-level configurations. "arn:aws:s3:::source_bucket1
" ] }, "IsEnabled": true, //Whether the configuration is enabled "DataExport": { //Details about the metrics export "S3BucketDestination": { "OutputSchemaVersion": "V_1
", "Format": "CSV
", //You can add "Parquet" if you prefer. "AccountId": "111122223333
", "Arn": "arn:aws:s3:::destination-bucket-name
", // The destination bucket for your metrics export must be in the same Region as your S3 Storage Lens configuration. "Prefix": "prefix-for-your-export-destination
", "Encryption": { "SSES3": {} } }, "CloudWatchMetrics": { "IsEnabled":true
//Mark this as false if you want to export only free metrics. } } }
package aws.example.s3control; import com.amazonaws.AmazonServiceException; import com.amazonaws.SdkClientException; import com.amazonaws.auth.profile.ProfileCredentialsProvider; import com.amazonaws.services.s3control.AWSS3Control; import com.amazonaws.services.s3control.AWSS3ControlClient; import com.amazonaws.services.s3control.model.AccountLevel; import com.amazonaws.services.s3control.model.ActivityMetrics; import com.amazonaws.services.s3control.model.BucketLevel; import com.amazonaws.services.s3control.model.CloudWatchMetrics; import com.amazonaws.services.s3control.model.Format; import com.amazonaws.services.s3control.model.Include; import com.amazonaws.services.s3control.model.OutputSchemaVersion; import com.amazonaws.services.s3control.model.PrefixLevel; import com.amazonaws.services.s3control.model.PrefixLevelStorageMetrics; import com.amazonaws.services.s3control.model.PutStorageLensConfigurationRequest; import com.amazonaws.services.s3control.model.S3BucketDestination; import com.amazonaws.services.s3control.model.SSES3; import com.amazonaws.services.s3control.model.SelectionCriteria; import com.amazonaws.services.s3control.model.StorageLensAwsOrg; import com.amazonaws.services.s3control.model.StorageLensConfiguration; import com.amazonaws.services.s3control.model.StorageLensDataExport; import com.amazonaws.services.s3control.model.StorageLensDataExportEncryption; import com.amazonaws.services.s3control.model.StorageLensTag; import java.util.Arrays; import java.util.List; import static com.amazonaws.regions.Regions.
US_WEST_2
; public class CreateAndUpdateDashboard { public static void main(String[] args) { String configurationId = "ConfigurationId
"; String sourceAccountId = "Source Account ID
"; 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 = new SelectionCriteria() .withDelimiter("/
") .withMaxDepth(5
) .withMinStorageBytesPercentage(10.0
); PrefixLevelStorageMetrics prefixStorageMetrics = new PrefixLevelStorageMetrics() .withIsEnabled(true
) .withSelectionCriteria(selectionCriteria); BucketLevel bucketLevel = new BucketLevel() .withActivityMetrics(new ActivityMetrics().withIsEnabled(true
)) .withAdvancedCostOptimizationMetrics(new AdvancedCostOptimizationMetrics().withIsEnabled(true
)) .withAdvancedDataProtectionMetrics(new AdvancedDataProtectionMetrics().withIsEnabled(true
)) .withDetailedStatusCodesMetrics(new DetailedStatusCodesMetrics().withIsEnabled(true
)) .withPrefixLevel(new PrefixLevel().withStorageMetrics(prefixStorageMetrics)); AccountLevel accountLevel = new AccountLevel() .withActivityMetrics(new ActivityMetrics().withIsEnabled(true
)) .withAdvancedCostOptimizationMetrics(new AdvancedCostOptimizationMetrics().withIsEnabled(true
)) .withAdvancedDataProtectionMetrics(new AdvancedDataProtectionMetrics().withIsEnabled(true
)) .withDetailedStatusCodesMetrics(new DetailedStatusCodesMetrics().withIsEnabled(true
)) .withBucketLevel(bucketLevel); Include include = new Include() .withBuckets(Arrays.asList("arn:aws:s3:::bucketName
")) .withRegions(Arrays.asList("us-west-2
")); StorageLensDataExportEncryption exportEncryption = new StorageLensDataExportEncryption() .withSSES3(new SSES3()); S3BucketDestination s3BucketDestination = new S3BucketDestination() .withAccountId(exportAccountId) .withArn(exportBucketArn) .withEncryption(exportEncryption) .withFormat(exportFormat) .withOutputSchemaVersion(OutputSchemaVersion.V_1) .withPrefix("Prefix"); CloudWatchMetrics cloudWatchMetrics = new CloudWatchMetrics() .withIsEnabled(true
); StorageLensDataExport dataExport = new StorageLensDataExport() .withCloudWatchMetrics(cloudWatchMetrics) .withS3BucketDestination(s3BucketDestination); StorageLensAwsOrg awsOrg = new StorageLensAwsOrg() .withArn(awsOrgARN
); StorageLensConfiguration configuration = new StorageLensConfiguration() .withId(configurationId) .withAccountLevel(accountLevel) .withInclude(include) .withDataExport(dataExport) .withAwsOrg(awsOrg) .withIsEnabled(true
); List<StorageLensTag> tags = Arrays.asList( new StorageLensTag().withKey("key-1
").withValue("value-1
"), new StorageLensTag().withKey("key-2
").withValue("value-2
") ); AWSS3Control s3ControlClient = AWSS3ControlClient.builder() .withCredentials(new ProfileCredentialsProvider()) .withRegion(US_WEST_2
) .build(); s3ControlClient.putStorageLensConfiguration(new PutStorageLensConfigurationRequest() .withAccountId(sourceAccountId) .withConfigId(configurationId) .withStorageLensConfiguration(configuration) .withTags(tags) ); } catch (AmazonServiceException 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(); } } }
Pour activer l'option de publication sur CloudWatch à l'aide de l'API REST Amazon S3, vous pouvez utiliser PutStorageLensConfiguration.
Étapes suivantes
Une fois que vous avez activé l'option CloudWatch publishing (publication sur CloudWatch), vous pouvez accéder à vos métriques S3 Storage Lens dans CloudWatch. Vous pouvez également exploiter les fonctions CloudWatch pour surveiller et analyser vos données S3 Storage Lens dans CloudWatch. Pour plus d'informations, consultez les rubriques suivantes :