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.

Configurer la journalisation standard (héritée)

Pour commencer avec la journalisation standard (héritée), procédez comme suit :

Choix d’un compartiment Amazon S3 pour les journaux standard

Lorsque vous activez la journalisation pour une distribution, vous spécifiez le compartiment Amazon S3 dans lequel vous voulez que CloudFront stocke les fichiers journaux. Si vous utilisez Amazon S3 comme origine, nous vous recommandons d’utiliser un compartiment distinct pour vos fichiers journaux.

Indiquez le compartiment Amazon S3 dans lequel CloudFront doit enregistrer les journaux d’accès, par exemple amzn-s3-demo-bucket.s3.amazonaws.com.

Vous pouvez stocker les fichiers journaux de plusieurs distributions dans le même compartiment. Lorsque vous activez la journalisation, vous pouvez spécifier un préfixe facultatif pour les noms de fichier et vous pouvez ainsi savoir quels fichiers journaux sont associés à quelles distributions.

Autorisations

Votre Compte AWS doit disposer des autorisations suivantes pour le compartiment que vous spécifiez pour les fichiers journaux :

Politique de clé requise pour les compartiments SSE-KMS

Si le compartiment S3 de vos journaux standard utilise le chiffrement côté serveur avec les AWS KMS keys (SSE-KMS) utilisant une clé gérée par le client, vous devez ajouter l’instruction suivante à la stratégie de clé pour la clé gérée par votre client. Cela permet à CloudFront d’écrire des fichiers journaux dans le compartiment. Vous ne pouvez pas utiliser SSE-KMS avec la Clé gérée par AWS, car CloudFront ne pourra pas écrire les fichiers journaux dans le compartiment.

{
    "Sid": "Allow CloudFront to use the key to deliver logs",
    "Effect": "Allow",
    "Principal": {
        "Service": "delivery.logs.amazonaws.com"
    },
    "Action": "kms:GenerateDataKey*",
    "Resource": "*"
}

Si le compartiment S3 de vos journaux standard utilise SSE-KMS avec une clé de compartiment S3, vous devez également ajouter l’autorisation kms:Decrypt à l’instruction de stratégie. Dans ce cas, l’énoncé de stratégie complet ressemble à ce qui suit.

{
    "Sid": "Allow CloudFront to use the key to deliver logs",
    "Effect": "Allow",
    "Principal": {
        "Service": "delivery.logs.amazonaws.com"
    },
    "Action": [
        "kms:GenerateDataKey*",
        "kms:Decrypt"
    ],
    "Resource": "*"
}

Activation de la journalisation standard (héritée)

Pour activer la journalisation standard, utilisez la console CloudFront ou l’API CloudFront.

Activation de la journalisation standard (héritée) (console CloudFront)

Activation de la journalisation standard (héritée) (API CloudFront)

Vous pouvez également utiliser l’API CloudFront pour activer les journaux standard de vos distributions.

Modification des paramètres de journalisation standard

Vous pouvez activer ou désactiver la journalisation, changer le compartiment Amazon S3 dans lequel vos journaux sont stockés et modifier le préfixe des fichiers journaux à l’aide de la console CloudFront ou de l’API CloudFront. Les modifications apportées aux paramètres de journalisation prennent effet dans les 12 heures.

Pour plus d’informations, consultez les rubriques suivantes :

Envoi de journaux vers Amazon S3

Lorsque vos journaux sont envoyés à Amazon S3, ils se présentent sous le format suivant.

Format de nom de fichier

Le nom de chaque fichier journal que CloudFront enregistre dans votre compartiment Amazon S3 utilise le format de nom de fichier suivant :

<optional prefix>/<distribution ID>.YYYY-MM-DD-HH.unique-ID.gz

Les dates et heures sont exprimées en heure UTC (temps universel coordonné).

Par exemple, si vous utilisez example-prefix comme préfixe et que votre ID de distribution est EMLARXS9EXAMPLE, les noms de fichiers ressemblent à ceci :

example-prefix/EMLARXS9EXAMPLE.2019-11-14-20.RT4KCN4SGK9.gz

Lorsque vous activez la journalisation pour une distribution, vous pouvez spécifier un préfixe facultatif pour les noms de fichier et vous pouvez ainsi savoir quels fichiers journaux sont associés à quelles distributions. Si vous incluez une valeur pour le préfixe du fichier journal et que votre préfixe ne se termine pas par une barre oblique (/), CloudFront en ajoute une automatiquement. Si votre préfixe se termine par une barre oblique, CloudFront n’en ajoute pas une autre.

L’extension .gz à la fin du nom de fichier indique que CloudFront a compressé le fichier journal avec gzip.

Format de fichier journal standard

Chaque entrée d’un fichier journal fournit des informations détaillées sur une seule demande utilisateur. Les fichiers journaux présentent les caractéristiques suivantes :

Suppression des fichiers journaux

CloudFront ne supprime pas automatiquement les fichiers journaux de votre compartiment Amazon S3. Pour en savoir plus sur la suppression de fichiers journaux dans un compartiment Amazon S3, consultez Suppression des objets dans le Guide de l’utilisateur de la console Amazon Simple Storage Service.

Tarification

La journalisation standard est une fonction facultative de CloudFront. CloudFront ne facture pas l’activation des journaux standard. Cependant, les frais Amazon S3 usuels sont facturés pour stocker les fichiers et y accéder sur Amazon S3. Vous pouvez les supprimer à tout moment.

Pour plus d’informations sur la tarification Amazon S3, consultez Tarification Amazon S3.

Pour plus d’informations sur les frais liés à CloudFront, consultez Tarification CloudFront.