Affichage des métriques CloudFront et des fonctions de périphérie - Amazon CloudFront
Métriques par défaut de la distribution CloudFrontActivation de métriques de distribution CloudFront supplémentairesMétriques de fonction Lambda@Edge par défautMétriques des fonctions CloudFront par défaut

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.

Affichage des métriques CloudFront et des fonctions de périphérie

Vous pouvez afficher les métriques opérationnelles relatives à vos distributions CloudFront et aux fonctions de périphérie dans la console CloudFront.

Pour afficher des métriques CloudFront et des fonctions de périphérie

  1. Connectez-vous à AWS Management Console et ouvrez la console CloudFront à l’adresse https://console.aws.amazon.com/cloudfront/v4/home.

  2. Dans le panneau de navigation, choisissez Surveillance.

  3. Pour consulter des graphiques sur l'activité d'une distribution CloudFront ou d'une fonction de périphérie, choisissez-la, puis sélectionnez Afficher les métriques de distribution ou Afficher les métriques.

  4. Vous pouvez personnaliser les graphiques en procédant comme suit :

    1. Pour modifier la plage de temps des informations affichées sur les graphiques, choisissez 1h (1 heure), 3h (3 heures) ou une autre plage, ou spécifiez une plage personnalisée.

    2. Pour modifier la fréquence à laquelle CloudFront met à jour les informations du graphique, choisissez la flèche vers le bas en regard de l'icône d'actualisation, puis choisissez un taux d'actualisation. Le taux d’actualisation par défaut est d’une minute, mais vous pouvez choisir d’autres options.

  5. Pour afficher les graphiques CloudFront dans la console CloudWatch, choisissez Add to dashboard (Ajouter au tableau de bord). Vous devez utiliser la région USA Est (Virginie du Nord) pour afficher les graphiques dans la console CloudWatch.

Métriques par défaut de la distribution CloudFront

Les métriques par défaut suivantes sont incluses pour toutes les distributions CloudFront, sans frais supplémentaires :

Requêtes

Nombre total de requêtes de visionneuse reçues par CloudFront, pour toutes les méthodes HTTP et pour les requêtes HTTP et HTTPS.

Octets téléchargés

Nombre total d’octets téléchargés par les utilisateurs pour les demandes GET et HEAD.

Octets chargés

Nombre total d’octets que les utilisateurs ont téléchargés sur CloudFront, en utilisant les demandes OPTIONS, POST et PUT.

Taux d’erreurs 4xx

Pourcentage de toutes les demandes de visionneuse pour lesquelles le code d'état HTTP de la réponse est 4xx.

Taux d’erreurs 5xx

Pourcentage de toutes les demandes de visionneuse pour lesquelles le code d'état HTTP de la réponse est 5xx.

Taux d’erreurs total

Pourcentage de toutes les demandes de visionneuse pour lesquelles le code d’état HTTP de la réponse est 4xx ou 5xx.

Ces métriques sont présentées dans des graphiques pour chaque distribution CloudFront sur la page Surveillance de la console CloudFront. Sur chaque graphique, les totaux sont affichés avec un niveau de précision d’une minute. Outre l’affichage des graphiques, vous pouvez également télécharger des rapports de métriques sous forme de fichiers CSV.

Activation de métriques de distribution CloudFront supplémentaires

En plus des métriques par défaut, vous pouvez activer des métriques supplémentaires pour un coût additionnel. Pour plus d’informations sur le coût, consultez Estimation du coût des métriques CloudFront supplémentaires.

Ces métriques supplémentaires doivent être activées séparément pour chaque distribution :

Taux d’accès au cache

Pourcentage de toutes les demandes pouvant être mises en cache pour lesquelles CloudFront a fourni le contenu à partir de son cache. Les demandes HTTP POST et PUT, ainsi que les erreurs, ne sont pas considérées comme des requêtes pouvant être mises en cache.

Latence d'origine

Temps total passé entre le moment où CloudFront reçoit une demande et le moment où il commence à fournir une réponse au réseau (et non à la visionneuse), pour des demandes qui sont traitées à partir de l'origine et non du cache CloudFront. Ceci est également appelé latence du premier octet, ou temps jusqu'au premier octet.

Taux d'erreur par code d'état

Pourcentage de toutes les requêtes de visionneuse pour lesquelles le code d'état HTTP de la réponse est un code particulier dans la plage 4xx ou 5xx. Cette métrique est disponible pour tous les codes d'erreur suivants : 401, 403, 404, 502, 503 et 504.

Vous pouvez activer des métriques supplémentaires dans la console CloudFront, avec CloudFormation, avec l'AWS Command Line Interface (AWS CLI) ou avec l'API CloudFront.

Console
Pour activer des métriques supplémentaires

  1. Connectez-vous à AWS Management Console et ouvrez la console CloudFront à l’adresse https://console.aws.amazon.com/cloudfront/v4/home.

  2. Dans le panneau de navigation, choisissez Surveillance.

  3. Choisissez la distribution pour laquelle vous souhaitez activer des métriques supplémentaires, puis choisissez View distribution metrics (Afficher les métriques de distribution).

  4. Choisissez Manage additional metrics (Gérer des indicateurs supplémentaires).

  5. Dans la fenêtre Manage additional metrics (Gérer des métriques supplémentaires), activez Enabled (Activé). Lorsque les métriques supplémentaires sont activées, vous pouvez fermer la fenêtre Manage additional metrics (Gérer des métriques supplémentaires).

    Lorsque les métriques supplémentaires sont activées, elles apparaissent dans les graphiques. Sur chaque graphique, les totaux sont affichés avec un niveau de précision d’une minute. Outre l’affichage des graphiques, vous pouvez également télécharger des rapports de métriques sous forme de fichiers CSV.

CloudFormation

Pour activer des métriques supplémentaires avec CloudFormation, utilisez le type de ressource AWS::CloudFront::MonitoringSubscription. L'exemple suivant montre la syntaxe de modèle CloudFormation, au format YAML, pour activer les métriques supplémentaires.

Type: AWS::CloudFront::MonitoringSubscription
Properties: 
  DistributionId: EDFDVBD6EXAMPLE
  MonitoringSubscription:
    RealtimeMetricsSubscriptionConfig:
      RealtimeMetricsSubscriptionStatus: Enabled
CLI

Pour gérer des métriques supplémentaires avec AWS Command Line Interface (AWS CLI), utilisez l'une des commandes suivantes :

Pour activer des métriques supplémentaires pour une distribution

  • Utilisez la commande create-monitoring-subscription, comme dans l’exemple suivant. Remplacez EDFDVBD6EXAMPLE par l’ID de la distribution pour laquelle vous activez des métriques supplémentaires.

    
aws cloudfront create-monitoring-subscription --distribution-id EDFDVBD6EXAMPLE --monitoring-subscription RealtimeMetricsSubscriptionConfig={RealtimeMetricsSubscriptionStatus=Enabled}
Pour savoir si des métriques supplémentaires sont activées pour une distribution

  • Utilisez la commande get-monitoring-subscription, comme dans l’exemple suivant. Remplacez EDFDVBD6EXAMPLE par l’ID de la distribution que vous vérifiez.

    
aws cloudfront get-monitoring-subscription --distribution-id EDFDVBD6EXAMPLE
Pour désactiver des métriques supplémentaires pour une distribution

  • Utilisez la commande delete-monitoring-subscription, comme dans l’exemple suivant. Remplacez EDFDVBD6EXAMPLE par l’ID de la distribution pour laquelle vous désactivez des métriques supplémentaires.

    
aws cloudfront delete-monitoring-subscription --distribution-id EDFDVBD6EXAMPLE
API

Pour gérer des métriques supplémentaires avec l'API CloudFront, utilisez l'une des opérations d'API suivantes.

Pour plus d’informations sur ces opérations d’API, consultez la documentation de référence des API pour votre kit AWS SDK ou un autre client d’API.

Estimation du coût des métriques CloudFront supplémentaires

Lorsque vous activez des métriques supplémentaires pour une distribution, CloudFront envoie jusqu'à 8 mesures à CloudWatch dans la région USA Est (Virginie du Nord). CloudWatch facture un taux fixe faible pour chaque métrique. Ce tarif n'est facturé qu'une fois par mois, par métrique (jusqu'à 8 métriques par distribution). Il s'agit d'un tarif fixe, de sorte que votre coût reste le même quel que soit le nombre de demandes ou de réponses que la distribution CloudFront reçoit ou envoie. Pour connaître le taux par métrique, consultez la page de tarification Amazon CloudWatch et le calculateur de tarification CloudWatch. Des frais d'API supplémentaires s'appliquent lorsque vous récupérez les métriques avec l'API CloudWatch.

Métriques de fonction Lambda@Edge par défaut

Vous pouvez utiliser des métriques CloudWatch pour surveiller, en temps réel, des problèmes liés à vos fonctions Lambda@Edge. L'utilisation de ces métriques n'implique aucun coût supplémentaire.

Lorsque vous associez une fonction Lambda@Edge à un comportement de cache dans une distribution CloudFront, Lambda commence à envoyer automatiquement des métriques à CloudWatch. Les métriques sont disponibles pour toutes les régions Lambda, mais pour les afficher dans la console CloudWatch ou obtenir les données de la métrique à partir de l'API CloudWatch, vous devez utiliser la région US East (N. Virginia) (USA Est (Virginie du Nord)) (us-east-1). Le nom du groupe de métriques est au format suivant : AWS/CloudFront/distribution-ID, où l'distribution-ID est l'ID de la distribution CloudFront à laquelle la fonction Lambda@Edge est associée. Pour plus d’informations sur les métriques Amazon CloudWatch, consultez le Guide de l’utilisateur Amazon CloudWatch.

Les métriques par défaut suivantes sont présentées sous forme de graphiques pour chaque fonction Lambda@Edge sur la page Surveillance de la console CloudFront :

  • 5xxTaux d'erreur pour Lambda@Edge

  • Erreurs d'exécution Lambda

  • Lambda réponses invalides

  • Limitations Lambda

Les graphiques incluent les nombres d'appels, d'erreurs, de limitations, etc. Sur chaque graphique, les totaux sont affichés avec un niveau de précision d'une minute, regroupés par région AWS.

Si vous voyez un pic d'erreurs que vous souhaitez étudier, vous pouvez choisir une fonction, puis consulter les fichiers journaux par région AWS jusqu'à ce que vous ayez déterminé quelle fonction est à l'origine des problèmes et dans quelle région AWS. Pour plus d’informations sur le dépannage des erreurs Lambda@Edge, consultez :

Métriques des fonctions CloudFront par défaut

CloudFront Functions envoie des métriques opérationnelles à Amazon CloudWatch afin que vous puissiez surveiller vos fonctions. Ces métriques peut vous aider à résoudre, suivre et déboguer des problèmes. CloudFront Functions publie les métriques suivantes dans CloudWatch :

  • Appels (FunctionInvocations) – nombre de fois où la fonction a été lancée (appelée) au cours d'une période donnée.

  • Erreurs de validation (FunctionValidationErrors) – nombre d'erreurs de validation générées par la fonction au cours d'une période donnée. Des erreurs de validation se produisent lorsque la fonction s'exécute correctement, mais renvoie des données non valides (un objet d'événement non valide).

  • Erreurs d'exécution (FunctionExecutionErrors) – nombre d'erreurs d'exécution survenues au cours d'une période donnée. Des erreurs d'exécution se produisent lorsque la fonction échoue.

  • Utilisation du calcul (FunctionComputeUtilization) – durée d'exécution de la fonction en pourcentage de la durée maximale autorisée. Par exemple, une valeur de 35 signifie que la durée d'exécution de la fonction représente 35 % du temps maximum autorisé. Cette métrique est un nombre compris entre 0 et 100.

    Si cette valeur atteint 100 ou s’en approche, cela signifie que la fonction a utilisé ou est sur le point d’utiliser le temps d’exécution autorisé, et les demandes suivantes pourraient être limitées. Si votre fonction fonctionne avec un taux d’utilisation de 80 % ou plus, nous vous recommandons d’examiner votre fonction afin d’en réduire le temps d’exécution et d’améliorer son utilisation. Par exemple, vous pouvez choisir de ne consigner que les erreurs, de simplifier des expressions regex complexes ou de supprimer l’analyse inutile d’objets JSON complexes.

  • Limitations(FunctionThrottles) – nombre de fois où la fonction a été limitée au cours d'une période donnée. Les fonctions peuvent être limitées pour les raisons suivantes :

    • La fonction dépasse continuellement la durée maximale autorisée pour l'exécution.

    • La fonction entraîne des erreurs de compilation.

    • Le nombre de demandes par seconde est exceptionnellement élevé.

CloudFront KeyValueStore envoie également les métriques opérationnelles suivantes à Amazon CloudWatch :

  • Demandes de lecture (KvsReadRequests) : nombre de fois où la fonction a réussi à lire dans le magasin de clés-valeurs au cours d’une période donnée.

  • Erreurs de lecture (KvsReadErrors) : nombre de fois où la fonction n’a pas réussi à lire dans le magasin de clés-valeurs durant une période donnée.

Toutes ces métriques sont publiées dans CloudWatch dans la région USA Est (Virginie du Nord) (us-east-1), dans l'espace de noms CloudFront. Vous pouvez également afficher ces métriques dans la console CloudWatch. Dans la console CloudWatch, vous pouvez afficher les métriques par fonction ou par fonction et par distribution.

Vous pouvez également utiliser CloudWatch pour définir des alarmes en fonction de ces métriques. Par exemple, vous pouvez définir une alarme basée sur la métrique du temps d'exécution (FunctionComputeUtilization), qui représente le pourcentage du temps disponible que votre fonction a pris pour s'exécuter. Lorsque le temps d’exécution atteint une certaine valeur pendant une durée déterminée. Par exemple, si vous choisissez supérieur à 70 % du temps disponible pendant 15 minutes consécutives, l’alarme se déclenche. Vous spécifiez la valeur de l'alarme et son unité de temps lorsque vous créez l'alarme.

Note

CloudFront Functions envoie des métriques et des journaux à CloudWatch uniquement pour les fonctions à l'étape LIVE qui s'exécutent suite à des requêtes et à des réponses en production. Lorsque vous testez une fonction, CloudFront n'envoie aucun journal ni aucune métrique à CloudWatch. La sortie du test contient des informations sur les erreurs, l’utilisation du calcul et les journaux de fonctions (instructions console.log()), mais ces informations ne sont pas envoyées à CloudWatch.

Pour plus d'informations sur la façon d'obtenir ces métriques à l'aide de l'API CloudWatch, consultez Types de métriques pour CloudFront.