Création d'une configuration de métriques qui filtre par préfixe, balise d'objet ou point d'accès - Amazon Simple Storage Service

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.

Création d'une configuration de métriques qui filtre par préfixe, balise d'objet ou point d'accès

Il existe trois types de CloudWatch métriques Amazon pour Amazon S3 : les métriques de stockage, les métriques de demande et les métriques de réplication. Les métriques du stockage sont fournies une fois par jour à tous les clients sans frais supplémentaires. Ces métriques de demande sont disponibles à des intervalles d'une minute après une latence pour le traitement. Les métriques relatives aux demandes sont facturées au CloudWatch tarif standard. Vous devez activer les métriques de demande en les configurant dans la console ou en utilisant l'API Amazon S3. Les métriques de réplication S3 fournissent des métriques détaillées pour les règles de réplication dans votre configuration de réplication. Grâce aux métriques de réplication, vous pouvez suivre la minute-by-minute progression en suivant les octets en attente, les opérations en attente, les opérations dont la réplication a échoué et la latence de réplication.

Pour plus d'informations sur CloudWatch les métriques pour Amazon S3, consultezSurveillance des métriques avec Amazon CloudWatch.

Lorsque vous configurez CloudWatch les métriques, vous pouvez créer un filtre pour tous les objets de votre bucket, ou vous pouvez filtrer la configuration en groupes d'objets connexes au sein d'un même bucket. Vous pouvez filtrer les objets d'un compartiment pour l'inclusion dans une configuration de métriques sur la base de l'un ou de plusieurs des types de filtre suivants :

  • Préfixe de nom de clé d'objet – Même si le modèle de données Amazon S3 est une structure plane, vous pouvez induire une hiérarchie au moyen d'un préfixe. La console Amazon S3 prend en charge ces préfixes avec le concept de dossiers. Si vous filtrez par préfixe, les objets ayant le même préfixe seront inclus dans la configuration des métriques. Pour en savoir plus sur les préfixes, consultez Organisation des objets à l'aide de préfixes.

  • Balise – Vous pouvez ajouter des balises, à savoir des paires de noms clés-valeurs, aux objets. Les balises vous permettent de trouver et de classer facilement les objets. Ces balises peuvent également être utilisées comme filtres pour les configurations de métriques. Pour en savoir plus sur les balises d'objet, consultez Catégorisation de votre stockage à l'aide de balises.

  • Point d'accès – Les points d'accès S3 sont nommés points de terminaison réseaux qui sont attachés à des compartiments et simplifient la gestion de l'accès aux données à l'échelle pour les jeux de données partagés dans S3. Lorsque vous créez un filtre de point d'accès, Amazon S3 inclut les demandes au point d'accès que vous indiquez dans la configuration des métriques. Pour plus d’informations, consultez Surveillance et journalisation des points d'accès.

    Note

    Lorsque vous créez une configuration de métriques qui filtre par point d'accès, vous devez utiliser Amazon Resource Name (ARN) du point d'accès, et non l'alias du point d'accès. Veillez à utiliser l'ARN pour le point d'accès lui-même, et non l'ARN pour un objet particulier. Pour plus d’informations sur les ARN des points d’accès, consultez Utilisation des points d'accès.

Si vous spécifiez un filtre, seules les demandes qui agissent sur des objets uniques peuvent correspondre au filtre et être incluses dans les métriques indiquées. Les requêtes telles que DeleteObjectset les ListObjects requêtes ne renvoient aucune métrique pour les configurations avec filtres.

Pour demander un filtrage plus complexe, choisissez deux ou plusieurs éléments. Seuls les objets possédant tous ces éléments sont inclus dans la configuration des métriques. Si vous ne définissez pas de filtres, tous les objets du compartiment sont inclus dans la configuration des métriques.

  1. Connectez-vous à la console Amazon S3 AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/s3/.

  2. Dans la liste Compartiment, choisissez le nom du compartiment qui contient les objets pour lesquels vous souhaitez les métriques des demandes.

  3. Choisissez l'onglet Métriques.

  4. Sous Bucket metrics (Métriques de compartiment), choisissez View additional charts (Afficher des graphiques supplémentaires).

  5. Choisissez l'onglet Request metrics (Métriques de demande).

  6. Choisissez Create filter (Créer un filtre).

  7. Dans la zone Filter name (Nom du filtre), saisissez un nom de filtre.

    Les noms peuvent contenir uniquement des lettres, des chiffres, des points, des tirets et des traits de soulignement.

  8. Sous Portée du filtre, choisissez Limiter la portée de ce filtre à l'aide d'un préfixe, de balises d'objet et d'un point d'accès S3, ou d'une combinaison des trois.

  9. Sous Type de filtre, choisissez au moins un type de filtre : Préfixe, Balises de ouPoint d'accès.

  10. Pour définir un filtre de préfixe et limiter la porté du filtre à un seul chemin, saisissez un préfixe dans la zone Préfixe.

  11. Pour définir un filtre de balises d'objet, sous Balises d'objet, choisissez Ajouter une balise, puis saisissez une balise Clé et Valeur.

  12. Pour définir un filtre de point d'accès, dans le champ Point d'accès S3, saisissez l'ARN du point d'accès ou choisissez Parcourir S3 pour parvenir au point d'accès.

    Important

    Vous ne pouvez pas saisir l'alias d'un point d'accès. Vous devez saisir l'ARN du point d'accès lui-même, et non l'ARN d'un objet spécifique.

  13. Sélectionnez Enregistrer les modifications.

    Amazon S3 crée un filtre qui utilise le préfixe, les balises ou le point d'accès que vous avez indiqués.

  14. Sous l'onglet Métriques de demande, sous Filtres, choisissez le filtre que vous venez de créer.

    Vous avez maintenant créé un filtre qui limite la portée des métriques des demandes par préfixe, balises d'objet ou point d'accès. Environ 15 minutes après le CloudWatch début du suivi de ces métriques de demande, vous pouvez consulter les graphiques des métriques sur Amazon S3 et sur CloudWatch les consoles. Les métriques relatives aux demandes sont facturées au CloudWatch tarif standard. Pour plus d'informations, consultez les CloudWatch tarifs Amazon.

    Vous pouvez également configurer les métriques des demandes au niveau d'un compartiment. Pour plus d’informations, consultez Création d'une configuration de CloudWatch métriques pour tous les objets de votre compartiment.

  1. Installez et configurez le AWS CLI. Pour obtenir des instructions, consultez la section Installation, mise à jour et désinstallation de la AWS CLI du Guide de l'utilisateur de la AWS Command Line Interface .

  2. Ouvrez un terminal.

  3. Pour ajouter une configuration de métriques, exécutez l'une des commandes suivantes :

    Exemple  : pour filtrer par préfixe
    aws s3api put-bucket-metrics-configuration --bucket DOC-EXAMPLE-BUCKET1 --id metrics-config-id --metrics-configuration '{"Id":"metrics-config-id", "Filter":{"Prefix":"prefix1"}} '
    Exemple  : pour filtrer par balises
    aws s3api put-bucket-metrics-configuration --bucket DOC-EXAMPLE-BUCKET1 --id metrics-config-id --metrics-configuration '{"Id":"metrics-config-id", "Filter":{"Tag": {"Key": "string", "Value": "string"}} '
    Exemple  : pour filtrer par point d'accès
    aws s3api put-bucket-metrics-configuration --bucket DOC-EXAMPLE-BUCKET1 --id metrics-config-id --metrics-configuration '{"Id":"metrics-config-id", "Filter":{"AccessPointArn":"arn:aws:s3:Region:account-id:accesspoint/access-point-name"}} '
    Exemple  : pour filtrer par préfixe, balises et point d'accès
    aws s3api put-bucket-metrics-configuration --endpoint https://s3.Region.amazonaws.com --bucket DOC-EXAMPLE-BUCKET1 --id metrics-config-id --metrics-configuration '
{
    "Id": "metrics-config-id",
    "Filter": {
        "And": {
            "Prefix": "string",
            "Tags": [
                {
                    "Key": "string",
                    "Value": "string"
                }
            ],
            "AccessPointArn": "arn:aws:s3:Region:account-id:accesspoint/access-point-name"
        }
    }
}'

Vous pouvez également ajouter des configurations de métriques par programmation avec l'API REST Amazon S3. Pour en savoir plus sur l'ajout et l'utilisation de configurations de métriques, consultez les rubriques suivantes dans la Référence d'API Amazon Simple Storage Service :