Types de métriques pour CloudFront - Amazon CloudFront

Types de métriques pour CloudFront

Vous pouvez utiliser l’API CloudWatch ou l’AWS Command Line Interface (AWS CLI) pour obtenir les métriques CloudFront dans les programmes ou les applications que vous créez. Vous pouvez utiliser les données brutes pour créer vos propres tableaux de bord personnalisés, vos propres outils d'alarme, etc.

Pour plus d’informations, consultez get-metric-data dans la Reference de l’AWS CLI ou l’opération d’API GetMetricData dans la Référence des API Amazon CloudWatch.

Note

Pour obtenir les métriques CloudFront à partir de l'API CloudWatch, vous devez utiliser la région USA Est (Virginie du Nord) (us-east-1). Vous devez également connaître certaines valeurs et types pour chaque métrique.

Valeurs pour toutes les métriques CloudFront

Les valeurs suivantes s'appliquent à toutes les métriques CloudFront :

Namespace

La valeur pour Namespace est toujours AWS/CloudFront.

Dimensions

Chaque métrique CloudFront comporte les dimensions suivantes :

DistributionId

L'ID de la distribution CloudFront pour laquelle vous souhaitez obtenir des métriques.

FunctionName

Nom de la fonction (dans CloudFront Functions) pour laquelle vous souhaitez obtenir des métriques.

Cette dimension s'applique uniquement aux fonctions.

Region

La valeur pour Region est toujours Global, car CloudFront est un service global.

Valeurs des métriques de distributions CloudFront

Utilisez les informations de la liste suivante pour obtenir des détails sur des métriques de distributions CloudFront spécifiques à partir de l'API CloudWatch. Certaines de ces métriques sont disponibles uniquement lorsque vous avez activé les métriques supplémentaires pour la distribution.

Note

Une seule statistique, Average ou Sum, est applicable à chaque métrique. La liste suivante indique quelle statistique est applicable à cette métrique.

Taux d’erreurs 4xx

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

  • Nom de métrique : 4xxErrorRate

  • Statistique valide : Average

  • Unité : Percent

Taux d’erreurs 401

Pourcentage de toutes les demandes de visionneuse pour lesquelles le code d'état HTTP de la réponse est 401. Pour obtenir cette métrique, vous devez d'abord activer les métriques supplémentaires.

  • Nom de métrique : 401ErrorRate

  • Statistique valide : Average

  • Unité : Percent

Taux d’erreurs 403

Pourcentage de toutes les demandes de visionneuse pour lesquelles le code d'état HTTP de la réponse est 403. Pour obtenir cette métrique, vous devez d'abord activer les métriques supplémentaires.

  • Nom de métrique : 403ErrorRate

  • Statistique valide : Average

  • Unité : Percent

Taux d’erreurs 404

Pourcentage de toutes les demandes de visionneuse pour lesquelles le code d'état HTTP de la réponse est 404. Pour obtenir cette métrique, vous devez d'abord activer les métriques supplémentaires.

  • Nom de métrique : 404ErrorRate

  • Statistique valide : Average

  • Unité : Percent

Taux d’erreurs 5xx

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

  • Nom de métrique : 5xxErrorRate

  • Statistique valide : Average

  • Unité : Percent

Taux d’erreurs 502

Pourcentage de toutes les demandes de visionneuse pour lesquelles le code d'état HTTP de la réponse est 502. Pour obtenir cette métrique, vous devez d'abord activer les métriques supplémentaires.

  • Nom de métrique : 502ErrorRate

  • Statistique valide : Average

  • Unité : Percent

Taux d’erreurs 503

Pourcentage de toutes les demandes de visionneuse pour lesquelles le code d'état HTTP de la réponse est 503. Pour obtenir cette métrique, vous devez d'abord activer les métriques supplémentaires.

  • Nom de métrique : 503ErrorRate

  • Statistique valide : Average

  • Unité : Percent

Taux d’erreurs 504

Pourcentage de toutes les demandes de visionneuse pour lesquelles le code d'état HTTP de la réponse est 504. Pour obtenir cette métrique, vous devez d'abord activer les métriques supplémentaires.

  • Nom de métrique : 504ErrorRate

  • Statistique valide : Average

  • Unité : Percent

Octets téléchargés

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

  • Nom de métrique : BytesDownloaded

  • Statistique valide : Sum

  • Unité : None

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.

  • Nom de métrique : BytesUploaded

  • Statistique valide : Sum

  • Unité : None

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. Pour obtenir cette métrique, vous devez d'abord activer les métriques supplémentaires.

  • Nom de métrique : CacheHitRate

  • Statistique valide : Average

  • Unité : Percent

Latence d'origine

Temps total passé, en millisecondes, 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. Pour obtenir cette métrique, vous devez d'abord activer les métriques supplémentaires.

  • Nom de métrique : OriginLatency

  • Statistique valide : Percentile

  • Unité : Milliseconds

Note

Pour obtenir une statistique Percentile à partir de l’API CloudWatch, utilisez le paramètre ExtendedStatistics au lieu de Statistics. Pour plus d’informations, consultez GetMetricStatistics dans la Référence des API Amazon CloudWatch, ou la documentation de référence pour les kits SDK AWS.

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.

  • Nom de métrique : Requests

  • Statistique valide : Sum

  • Unité : None

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.

  • Nom de métrique : TotalErrorRate

  • Statistique valide : Average

  • Unité : Percent

Valeurs des métriques de fonctions CloudFront

Utilisez les informations de la liste suivante pour obtenir des détails sur des métriques de fonctions CloudFront spécifiques à partir de l'API CloudWatch.

Note

Une seule statistique, Average ou Sum, est applicable à chaque métrique. La liste suivante indique quelle statistique est applicable à cette métrique.

Appels

Nombre de fois où la fonction a été démarrée (appelée) au cours d'une période donnée.

  • Nom de métrique : FunctionInvocations

  • Statistique valide : Sum

  • Unité : None

Erreurs de validation

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).

  • Nom de métrique : FunctionValidationErrors

  • Statistique valide : Sum

  • Unité : None

Erreurs d'exécution

Nombre d'erreurs d'exécution générées au cours d'une période donnée. Des erreurs d'exécution se produisent lorsque la fonction échoue.

  • Nom de métrique : FunctionExecutionErrors

  • Statistique valide : Sum

  • Unité : None

Utilisation du calcul

Durée nécessaire (0-100) pour l'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é.

  • Nom de métrique : FunctionComputeUtilization

  • Statistique valide : Average

  • Unité : Percent

Limitations

Nombre de fois où la fonction a été limitée au cours d'une période donnée.

  • Nom de métrique : FunctionThrottles

  • Statistique valide : Sum

  • Unité : None