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.
# Surveillez CloudFront les métriques avec Amazon CloudWatch
Amazon CloudFront est intégré à Amazon CloudWatch et publie automatiquement les métriques opérationnelles pour les distributions et les fonctions périphériques ([Lambda @Edge et CloudFront Functions](edge-functions.md)). Ces métriques peuvent vous aider à résoudre, suivre et déboguer des problèmes. Nombre de ces métriques sont affichées dans un ensemble de graphiques dans la CloudFront console et sont également accessibles à l'aide de l' CloudFront API ou de la CLI. Toutes ces métriques sont disponibles dans la [CloudWatch console](https://console.aws.amazon.com/cloudwatch/home) ou via l' CloudWatch API ou la CLI. CloudFront les métriques ne sont pas prises en compte dans les [CloudWatch quotas (anciennement appelés limites)](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_limits.html) et n'entraînent aucun coût supplémentaire.
Outre les mesures par défaut pour les CloudFront distributions, vous pouvez activer des mesures supplémentaires moyennant des frais supplémentaires. Les mesures supplémentaires s'appliquent aux CloudFront distributions et doivent être activées séparément pour chaque distribution. Pour plus d’informations sur le coût, consultez [Estimez le coût des CloudFront mesures supplémentaires](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional-pricing).
Vous pouvez également définir des alarmes en fonction de ces métriques dans la CloudFront console, ou dans la CloudWatch console, l'API ou la CLI. Par exemple, vous pouvez définir une alarme basée sur la métrique `5xxErrorRate`, qui représente le pourcentage de toutes les demandes de visionneuse pour lesquelles le code d'état HTTP de la réponse se trouve dans la plage `500` à `599`, incluses. Lorsque le taux d'erreur atteint une certaine valeur pendant un certain laps de temps (par exemple, 5 % des demandes pendant 5 minutes continues), l'alarme est déclenchée. Vous spécifiez la valeur de l'alarme et son unité de temps lorsque vous créez l'alarme.
**Remarques**
Lorsque vous créez une CloudWatch alarme dans la CloudFront console, elle en crée une pour vous dans la région USA Est (Virginie du Nord) (`us-east-1`). Si vous créez une alarme à partir de la CloudWatch console, vous devez utiliser la même région. Comme il CloudFront s'agit d'un service mondial, les mesures relatives au service sont envoyées vers l'est des États-Unis (Virginie du Nord).
Lors de la création d'alarmes, la [ CloudWatch tarification standard](https://aws.amazon.com/cloudwatch/pricing/) s'applique.
**Topics**
+ [Indicateurs CloudFront des fonctions d'affichage et de périphérie](viewing-cloudfront-metrics.md)
+ [Création d'alarmes pour les métriques](receiving-notifications.md)
+ [Téléchargement des données de métriques au format CSV](cloudwatch-csv.md)
+ [Types de métriques pour CloudFront](programming-cloudwatch-metrics.md)
# 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](https://aws.amazon.com/cloudfront/features/#Edge_Computing) 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'adresse[https://console.aws.amazon.com/cloudfront/v4/home](https://console.aws.amazon.com/cloudfront/v4/home).
1. Dans le panneau de navigation, choisissez **Surveillance**.
1. 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**.
1. 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.
1. 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 d’actualisation par défaut est d’une minute, mais vous pouvez choisir d’autres options.
1. 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.
**Topics**
+ [Métriques CloudFront de distribution par défaut](#monitoring-console.distributions)
+ [Activez des métriques CloudFront de distribution supplémentaires](#monitoring-console.distributions-additional)
+ [Métriques de fonction Lambda@Edge par défaut](#monitoring-console.lambda-at-edge)
+ [Métriques CloudFront des fonctions par défaut](#monitoring-console.cloudfront-functions)
## 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 utilisateurs pour les demandes `GET` et `HEAD`.
**Octets chargés**
Nombre total d'octets vers lesquels les utilisateurs ont transféré CloudFront`OPTIONS`, 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](cloudwatch-csv.md).
## 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 plus d’informations sur le coût, consultez [Estimez le coût des CloudFront mesures supplémentaires](#monitoring-console.distributions-additional-pricing).
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 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'adresse[https://console.aws.amazon.com/cloudfront/v4/home](https://console.aws.amazon.com/cloudfront/v4/home).
1. Dans le panneau de navigation, choisissez **Surveillance**.
1. Choisissez la distribution pour laquelle vous souhaitez activer des métriques supplémentaires, puis choisissez **View distribution metrics (Afficher les métriques de distribution)**.
1. Choisissez **Manage additional metrics** (Gérer des indicateurs supplémentaires).
1. 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](cloudwatch-csv.md).
------
#### [ 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 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 métriques supplémentaires pour une distribution**
+ Utilisez la commande **create-monitoring-subscription**, comme dans l’exemple suivant. *EDFDVBD6EXAMPLE*Remplacez-le 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. *EDFDVBD6EXAMPLE*Remplacez-le par l'ID de la distribution que vous êtes en train de vérifier.
```
aws cloudfront get-monitoring-subscription --distribution-id EDFDVBD6EXAMPLE
```
**Pour désactiver des métriques supplémentaires pour une distribution**
+ Utilisez la commande **delete-monitoring-subscription**, comme dans l’exemple suivant. *EDFDVBD6EXAMPLE*Remplacez-le 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 activer des mesures supplémentaires pour une distribution, utilisez [CreateMonitoringSubscription](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_CreateMonitoringSubscription.html).
+ Pour savoir si des métriques supplémentaires sont activées pour une distribution, utilisez [GetMonitoringSubscription](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_GetMonitoringSubscription.html).
+ Pour désactiver des mesures supplémentaires pour une distribution, utilisez [DeleteMonitoringSubscription](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_DeleteMonitoringSubscription.html).
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](https://aws.amazon.com/cloudwatch/pricing/) et le [calculateur de CloudWatch prix](https://aws.amazon.com/cloudwatch/pricing/#Pricing_calculator). Des frais d'API supplémentaires s'appliquent lorsque vous récupérez les métriques avec l' CloudWatch API.
## Métriques de 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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/).
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 :
+ `5xx`Taux 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 :
+ [Comment déterminer le type d'échec](lambda-edge-testing-debugging.md#lambda-edge-testing-debugging-failure-type)
+ [Quatre étapes pour débugger la diffusion de votre contenu sur AWS](https://aws.amazon.com/blogs/networking-and-content-delivery/four-steps-for-debugging-your-content-delivery-on-aws/)
## 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](functions-event-structure.md) 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 100 ou s’en approche, cela signifie que la fonction a utilisé ou est sur le point d’utiliser le temps d’exécution autorisé, et les demandes suivantes pourraient être limitées. Si votre fonction fonctionne avec un taux d’utilisation de 80 % ou plus, nous vous recommandons d’examiner votre fonction afin d’en réduire le temps d’exécution et d’améliorer son utilisation. Par exemple, vous pouvez choisir de ne consigner que les erreurs, de simplifier des expressions regex complexes ou de 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 :
+ **Demandes de lecture** (`KvsReadRequests`) : nombre de fois où la fonction a réussi à lire dans le magasin de clés-valeurs au cours d’une période donnée.
+ **Erreurs de lecture** (`KvsReadErrors`) : nombre de fois où la fonction n’a pas réussi à lire dans le magasin de clés-valeurs durant 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 (`FunctionComputeUtilization`), 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 une durée déterminée. Par exemple, si vous choisissez supérieur à 70 % du temps disponible pendant 15 minutes consécutives, 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](test-function.md), 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, consultez[Types de métriques pour CloudFront](programming-cloudwatch-metrics.md).
# Création d'alarmes pour les métriques
Dans la CloudFront console, vous pouvez définir des alarmes pour qu'elles vous avertissent par Amazon Simple Notification Service (Amazon SNS) en fonction de mesures spécifiques. CloudFront
**Pour créer des alarmes pour les métriques**
1. Connectez-vous à la CloudFront console AWS Management Console et ouvrez-la à l'adresse[https://console.aws.amazon.com/cloudfront/v4/home](https://console.aws.amazon.com/cloudfront/v4/home).
1. Dans le panneau de navigation, cliquez sur **Alarms (Alarmes)**.
1. Sélectionnez **Créer une alarme**.
1. Pour **Détails**, spécifiez les paramètres suivants :
1. **Nom de l’alarme** : un nom pour l’alarme.
1. **Distribution** : CloudFront distribution pour laquelle vous créez l'alarme.
1. Pour **Condition**, spécifiez ce qui suit :
1. **Métrique** : la métrique pour laquelle vous créez l’alarme.
1. **« SI »** : seuil à partir duquel une alarme CloudWatch doit être déclenchée et une notification doit être envoyée à la rubrique Amazon SNS. Par exemple, pour recevoir une notification lorsque le taux d'erreurs `5xx` dépasse 1 %, spécifiez ce qui suit :
**Taux d’erreurs 5xx** **> 1**
1. **« PENDANT » périodes consécutives** : la durée pendant laquelle la condition doit être remplie avant de déclencher une alarme. Lorsque vous choisissez une valeur, essayez de trouver l’équilibre approprié entre une valeur qui ne déclenche par une alarme pour des problèmes temporaires, mais qui en déclenche une pour des problèmes durables ou réels.
1. (Facultatif) **Notification** : la rubrique Amazon SNS à laquelle envoyer une notification si cette métrique déclenche une alarme.
1. Sélectionnez **Créer une alerte**.
**Remarques**
Lorsque vous entrez les valeurs de la condition, utilisez des nombres entiers sans ponctuation. Par exemple, pour spécifier mille, entrez **1000**.
Pour `4xx`, `5xx` et les taux de nombre total d'erreurs, vous spécifiez un pourcentage.
Pour les requêtes, les octets téléchargés et les octets chargés, vous spécifiez des unités. Par exemple, 1073742000 octets.
Pour plus d’informations sur la création de rubriques Amazon SNS, consultez [Création d’une rubrique Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/sns-create-topic.html) dans le *Guide du développeur Amazon Simple Notification Service*.
# Téléchargement des données de métriques au format CSV
Vous pouvez télécharger les données CloudWatch métriques d'une CloudFront distribution au format CSV.
**Pour télécharger des données de métriques au format CSV**
1. Connectez-vous à la CloudFront console AWS Management Console et ouvrez-la à l'adresse[https://console.aws.amazon.com/cloudfront/v4/home](https://console.aws.amazon.com/cloudfront/v4/home).
1. Dans le panneau de navigation, choisissez **Surveillance**.
1. Choisissez la distribution, puis sélectionnez **Afficher les métriques de distribution**.
1. Choisissez **Télécharger le rapport CSV**, puis sélectionnez la période souhaitée (par exemple, **Pour le dernier jour (période d’une heure)**.
1. Une fois le fichier téléchargé, ouvrez-le pour afficher les informations suivantes.
**Topics**
+ [Informations sur le rapport](#cloudwatch-csv-header)
+ [Données du rapport Metrics](#cloudwatch-csv-data)
## Informations sur le rapport
Les toutes premières lignes du rapport incluent les informations suivantes :
**Version**
La version CloudFront de rapport.
**Rapport**
Nom du rapport.
**DistributionID**
ID de la distribution pour laquelle vous avez exécuté le rapport.
**StartDateUTC**
Début de la plage de dates pour laquelle vous avez exécuté le rapport, en heure UTC.
**EndDateUTC**
Fin de la plage de dates pour laquelle vous avez exécuté le rapport, en heure UTC.
**GeneratedTimeUTC**
Date et heure auxquelles vous avez exécuté le rapport, en heure UTC.
**Granularité**
Durée de chaque ligne du rapport, par exemple, `ONE_MINUTE`.
## Données du rapport Metrics
Le rapport inclut les valeurs suivantes :
**DistributionID**
ID de la distribution pour laquelle vous avez exécuté le rapport.
**FriendlyName**
Nom de domaine alternatif (CNAME) de la distribution, le cas échéant. Si une distribution ne comporte pas de noms de domaines alternatifs, la liste inclut un nom de domaine d’origine pour la distribution.
**TimeBucket**
L'heure du jour correspondant aux données, en heure UTC (temps universel coordonné).
**Requêtes**
Nombre total de demandes pour tous les codes d'état HTTP (par exemple, `200`, `404`, etc.) et toutes les méthodes (par exemple, `GET`, `HEAD`, `POST`) pendant la période.
**BytesDownloaded**
Nombre d'octets que les utilisateurs ont téléchargé pour la distribution spécifiée pendant la période.
**BytesUploaded**
Nombre d'octets que les utilisateurs ont chargé pour la distribution spécifiée pendant la période.
**TotalErrorRatePct**
Pourcentage des requêtes pour lesquelles le code d'état HTTP était une erreur `4xx` ou `5xx` pour la distribution spécifiée pendant la période.
**4 xxErrorRate pct**
Pourcentage de requêtes pour lesquelles le code d’état HTTP était une erreur `4xx` pour la distribution spécifiée pendant la période.
**5 xxErrorRate pct**
Pourcentage de requêtes pour lesquelles le code d’état HTTP était une erreur `5xx` pour la distribution spécifiée pendant la période.
Si vous avez [activé des métriques supplémentaires](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional) pour votre distribution, le rapport inclut également les valeurs supplémentaires suivantes :
**401 ErrorRatePct**
Pourcentage de requêtes pour lesquelles le code d’état HTTP était une erreur `401` pour la distribution spécifiée pendant la période.
**403 ErrorRatePct**
Pourcentage de requêtes pour lesquelles le code d’état HTTP était une erreur `403` pour la distribution spécifiée pendant la période.
**404 ErrorRatePct**
Pourcentage de requêtes pour lesquelles le code d’état HTTP était une erreur `404` pour la distribution spécifiée pendant la période.
**502 ErrorRatePct**
Pourcentage de requêtes pour lesquelles le code d’état HTTP était une erreur `502` pour la distribution spécifiée pendant la période.
**503 ErrorRatePct**
Pourcentage de requêtes pour lesquelles le code d’état HTTP était une erreur `503` pour la distribution spécifiée pendant la période.
**504 ErrorRatePct**
Pourcentage de requêtes pour lesquelles le code d’état HTTP était une erreur `504` pour la distribution spécifiée pendant la période.
**OriginLatency**
Temps total passé, en millisecondes, entre le moment où une demande CloudFront a été reçue et le moment où elle a commencé à fournir une réponse au réseau (et non au téléspectateur), 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*.
**CacheHitRate**
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.
# Types de métriques pour CloudFront
Vous pouvez utiliser l' CloudWatch API ou AWS Command Line Interface (AWS CLI) pour obtenir les CloudFront métriques 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](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/get-metric-data.html)la *référence des AWS CLI commandes* ou le fonctionnement de l'[GetMetricData](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricData.html)API dans la *référence des CloudWatch API Amazon*.
**Topics**
+ [Valeurs pour tous les CloudFront indicateurs](#cloudfront-metrics-global-values)
+ [Valeurs pour les métriques CloudFront de distribution](#cloudfront-metrics-distribution-values)
+ [Valeurs pour les métriques des CloudFront fonctions](#cloudfront-metrics-function-values)
**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 tous les CloudFront indicateurs
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 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](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional).
+ 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](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional).
+ 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](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional).
+ 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](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional).
+ 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](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional).
+ 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](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional).
+ 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 vers lesquels les utilisateurs ont transféré CloudFront`OPTIONS`, 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](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional).
+ 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](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional).
+ Nom de métrique : `OriginLatency`
+ Statistique valide : `Percentile`
+ Unité : `Milliseconds`
Pour obtenir une `Percentile` statistique à partir de l' CloudWatch API, utilisez le `ExtendedStatistics` paramètre, not`Statistics`. Pour plus d'informations, consultez [GetMetricStatistics](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricStatistics.html)le *manuel Amazon CloudWatch API Reference* ou la documentation de référence du [AWS SDKs](https://docs.aws.amazon.com/#sdks).
**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`