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.
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.
Rubriques
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 toujoursAWS/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 toujoursGlobal
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
etOPTIONS
.-
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
etPUT
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
etPUT
, 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 leExtendedStatistics
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
ou5xx
.-
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
-