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.
Rubriques
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
Namespaceest toujoursAWS/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
Regionest toujoursGlobal, 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
GETetHEAD.-
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,POSTetPUT.-
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
POSTetPUT, 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ètreExtendedStatisticsau lieu deStatistics. 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
4xxou5xx.-
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
-