Obtenez des statistiques à l'aide de l' CloudWatchAPI Amazon

Vous pouvez utiliser l' CloudWatch API ou AWS Command Line Interface (AWS CLI) pour obtenir les CloudFront métriques dans les programmes ou 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-datala référence des AWS CLI commandes ou le fonctionnement de l'GetMetricDataAPI dans la référence des CloudWatch API Amazon.

Note

Pour obtenir les CloudFront métriques à partir de l' CloudWatch API, 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 CloudFront mesures :

Namespace

La valeur pour Namespace est toujours AWS/CloudFront.

Dimensions

Chaque CloudFront métrique possède les deux dimensions suivantes :

DistributionId

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

FunctionName

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

Cette dimension s'applique uniquement aux fonctions.

Region

La valeur pour « Region c'est toujours Global parce que CloudFront c'est un service mondial ».

Valeurs pour les métriques CloudFront de distribution

Utilisez les informations de la liste suivante pour obtenir des informations sur des métriques de CloudFront distribution spécifiques à partir de l' CloudWatch API. 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 visionneuses pour les demandes GET, HEAD et OPTIONS.

• Nom de métrique : BytesDownloaded

• Statistique valide : Sum

• Unité : None

Octets chargés

Le nombre total d'octets que les utilisateurs ont téléchargés vers votre origine avecCloudFront, utilisés POST et PUT demandés.

• 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 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. 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ù 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 cache. CloudFront Ceci est également connu sous le nom de latence du premier octet, ou time-to-first-byte. 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 Percentile statistique à partir de l' CloudWatch API, utilisez le ExtendedStatistics paramètre, notStatistics. Pour plus d'informations, consultez GetMetricStatisticsle Amazon CloudWatch API Reference ou la documentation de référence des AWS SDK.

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.

• 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 pour les métriques des CloudFront fonctions

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

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

Throttles

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