Indicateurs CloudFront des fonctions d'affichage et de périphérie - Amazon CloudFront
Métriques CloudFront de distribution par défautActivez des métriques CloudFront de distribution supplémentairesMétriques de la fonction Lambda @Edge par défautMétriques CloudFront des fonctions 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.

Indicateurs CloudFront des fonctions d'affichage et de périphérie

Vous pouvez consulter les statistiques opérationnelles relatives à vos CloudFront distributions et à vos fonctions de périphérie dans la CloudFront console.

Pour afficher CloudFront et contourner les métriques des fonctions dans CloudFront

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

  2. Dans le panneau de navigation, choisissez Surveillance.

  3. Pour afficher des graphiques relatifs à l'activité d'une CloudFront distribution ou d'une fonction de périphérie spécifique, choisissez-en une, puis choisissez 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 de CloudFront mise à jour des informations du graphique, cliquez sur la flèche vers le bas à côté de l'icône d'actualisation, puis choisissez une fréquence de rafraîchissement. Le taux de rafraîchissement par défaut est de 1 minute, mais vous pouvez choisir d'autres options.

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

Métriques CloudFront de distribution par défaut

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

Requêtes

Le nombre total de demandes d'affichage 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 visionneuses pour les demandes GET, HEAD et OPTIONS.

Octets chargés

Nombre total d'octets vers lesquels les utilisateurs ont transféré CloudFront, utilisés POST et PUT demandés.

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 mesures sont affichées sous forme de graphiques pour chaque CloudFront distribution sur la page de surveillance de la CloudFront console. 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.

Activez des métriques CloudFront de distribution supplémentaires

En plus des métriques par défaut, vous pouvez activer des métriques supplémentaires pour un coût additionnel. Pour de plus amples informations sur le coût, veuillez consulter Estimez le coût des CloudFront mesures 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 le contenu CloudFront a été diffusé depuis 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ù une demande est CloudFront reçue et le moment où elle commence à fournir une réponse au réseau (et non à l'utilisateur), pour les demandes traitées depuis l'origine, et non depuis le CloudFront cache. Ceci est également connu sous le nom de latence du premier octet, ou time-to-first-byte.

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 CloudFront console, avec AWS CloudFormation, avec le AWS Command Line Interface (AWS CLI) ou avec l' CloudFront API.

Console
Pour activer des métriques supplémentaires

  1. Connectez-vous à la CloudFront console AWS Management Console et ouvrez-la à l'adressehttps://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 AWS::CloudFront::MonitoringSubscription ressource. L'exemple suivant montre la syntaxe du AWS CloudFormation modèle, au format YAML, permettant d'activer des 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 le AWS Command Line Interface (AWS CLI), utilisez l'une des commandes suivantes :

Pour activer des mesures 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 mesures 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 les métriques supplémentaires.

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

Pour gérer des métriques supplémentaires avec l' CloudFront API, 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 de l'API de votre AWS SDK ou d'un autre client d'API.

Estimez le coût des CloudFront mesures supplémentaires

Lorsque vous activez des métriques supplémentaires pour une distribution, CloudFront envoie jusqu'à 8 métriques CloudWatch dans la région USA Est (Virginie du Nord). CloudWatch facture un faible taux fixe 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 vos coûts restent les mêmes quel que soit le nombre de demandes ou de réponses que la CloudFront distribution reçoit ou envoie. Pour le tarif par métrique, consultez la page de CloudWatch tarification d'Amazon et le calculateur de CloudWatch prix. Des frais d'API supplémentaires s'appliquent lorsque vous récupérez les métriques avec l' CloudWatch API.

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

Vous pouvez utiliser CloudWatch des métriques pour surveiller, en temps réel, les 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 CloudFront distribution, Lambda commence à envoyer des métriques automatiquement à. CloudWatch Les métriques sont disponibles pour toutes les régions Lambda, mais pour afficher les métriques dans la CloudWatch console ou obtenir les données métriques depuis l' CloudWatch API, vous devez utiliser la région USA Est (Virginie du Nord) (us-east-1). Le nom du groupe de métriques est formaté comme suit :AWS/CloudFront/distribution-ID, où Distribution-ID est l'ID de la CloudFront distribution à laquelle la fonction Lambda @Edge est associée. Pour plus d'informations sur CloudWatch les métriques, consultez le guide de CloudWatch l'utilisateur Amazon.

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

  • 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 constatez un pic d'erreurs que vous souhaitez examiner, vous pouvez choisir une fonction, puis consulter les fichiers journaux par AWS région, jusqu'à ce que vous déterminiez quelle fonction est à l'origine des problèmes et dans quelle AWS région. Pour de plus amples informations sur le dépannage des erreurs Lambda@Edge, veuillez consulter :

Métriques CloudFront des fonctions 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 pour 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 ou est proche de 100, la fonction a utilisé ou est sur le point d'utiliser le temps d'exécution autorisé et les demandes suivantes peuvent être limitées. Si votre fonction fonctionne à 80 % ou plus, nous vous recommandons de revoir votre fonction afin de réduire le temps d'exécution et d'améliorer le taux d'utilisation. Par exemple, vous souhaiterez peut-être uniquement enregistrer les erreurs, simplifier les expressions regex complexes ou 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 :

  • Read requests (KvsReadRequests) — Le nombre de fois où la fonction a été lue avec succès dans le magasin de valeurs clés au cours d'une période donnée.

  • Erreurs de lecture (KvsReadErrors) : nombre de fois où la fonction n'est pas parvenue à lire dans le magasin de valeurs clés au cours d'une période donnée.

Toutes ces métriques sont publiées CloudWatch dans la région de l'est des États-Unis (Virginie du Nord) (us-east-1), dans l'espace de CloudFront noms. Vous pouvez également consulter ces statistiques dans la CloudWatch console. Dans la CloudWatch console, vous pouvez consulter les métriques par fonction ou par fonction par distribution.

Vous pouvez également l'utiliser CloudWatch pour définir des alarmes en fonction de ces mesures. Par exemple, vous pouvez définir une alarme basée sur la métrique du temps d'exécution (FunctionComputeUilization), 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 un certain temps. Par exemple, si vous choisissez plus de 70 % du temps disponible pendant 15 minutes continues, 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 CloudWatch uniquement pour les fonctions de la LIVE phase qui s'exécutent en réponse aux demandes et réponses de production. Lorsque vous testez une fonction, CloudFront elle n'envoie aucune métrique à CloudWatch. Le résultat du test contient des informations sur les erreurs, l'utilisation du calcul et les journaux de fonctionnement (console.log()instructions), mais ces informations ne sont pas envoyées à CloudWatch.

Pour plus d'informations sur la façon d'obtenir ces métriques avec l' CloudWatch API, consultezObtenez des statistiques à l'aide de l' CloudWatchAPI Amazon.