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.
# CloudWatch Métriques Amazon ECS
Vous pouvez utiliser les statistiques CloudWatch d'utilisation pour obtenir une visibilité sur l'utilisation des ressources de votre compte. Utilisez ces indicateurs pour visualiser l'utilisation actuelle de vos services sur CloudWatch des graphiques et des tableaux de bord.
Amazon ECS envoie des métriques à des CloudWatch intervalles d'une minute. Ces métriques sont collectées pour les ressources dont les tâches sont dans l’état `RUNNING`. Si aucune tâche n’est en cours d’exécution sur un cluster, un service ou une autre ressource, aucune métrique ne sera communiquée pour cette ressource pendant cette période. Par exemple, si vous avez un cluster avec un service mais que ce service ne comporte aucune tâche dans un `RUNNING` état, aucune métrique ne sera envoyée à CloudWatch. De même, si vous disposez de deux services et que l’un d’eux exécute des tâches tandis que l’autre n’en exécute pas, seules les métriques du service exécutant des tâches seront envoyées.
****
| Métrique | Description | Dimension valide | Statistiques utiles | Unit |
| --- | --- | --- | --- | --- |
| CPUReservation | Pourcentage d’unités d’UC réservées dans le cluster ou le service. La réserve d’UC (filtrée par `ClusterName`) est calculée en divisant le nombre total d’unités d’UC réservées par les tâches Amazon ECS sur le cluster par le nombre total d’unités d’UC pour toutes les instances Amazon EC2 enregistrées dans le cluster. Seules les instances Amazon EC2 dont le statut est `ACTIVE` ou `DRAINING` auront une incidence sur métriques de réserve d’UC. Cette méthode n’est prise en charge que pour les tâches hébergées sur des instances Amazon EC2. | ClusterName. | Moyenne, Minimum, Maximum | Pourcentage |
| CPUUtilization | Pourcentage d'unités de processeur utilisées par le cluster, le service ou le démon géré. L’utilisation de l’UC au niveau du cluster (filtrées par `ClusterName`) est mesurée sur la base du nombre total d’unités d’UC en cours d’utilisation par les tâches Amazon ECS sur le cluster, divisé par le nombre total d’unités d’UC pour toutes les instances Amazon EC2 enregistrées dans le cluster. Seules les instances Amazon EC2 dont le statut est `ACTIVE` ou `DRAINING` auront une incidence sur métriques de réserve d’UC. La métrique au niveau du cluster n’est prise en charge que pour les tâches hébergées sur une instance Amazon EC2. L’utilisation de l’UC au niveau du service (filtrée par `ClusterName`, `ServiceName`) est mesurée comme le nombre total d’unités d’UC utilisées par les tâches appartenant au service, divisé par le nombre total d’unités d’UC qui sont en réserve pour les tâches appartenant au service. La métrique de niveau de service est prise en charge pour les tâches hébergées sur des instances Amazon EC2 et Fargate. L'utilisation du processeur au niveau du démon (filtrée par`ClusterName`,`ServiceName`) est mesurée comme le nombre total d'unités de processeur utilisées par les tâches appartenant au démon géré, divisé par le nombre total d'unités de processeur réservées aux tâches appartenant au démon géré. | ClusterName, ServiceName | Moyenne, Minimum, Maximum | Pourcentage |
| MemoryReservation | Pourcentage de mémoire qui est réservé en exécutant des tâches dans le cluster. La réserve de mémoire du cluster est mesurée comme la mémoire totale réservée par les tâches Amazon ECS sur le cluster, divisée par la quantité totale de mémoire pour toutes les instances Amazon EC2 enregistrées dans le cluster. Cette métrique ne peut être filtrée que par `ClusterName`. Seules les instances Amazon EC2 dont le statut est `ACTIVE` ou `DRAINING` auront une incidence sur métriques de réserve de mémoire. La métrique de réserve de mémoire au niveau du cluster n’est prise en charge que pour les tâches hébergées sur une instance Amazon EC2. Lors du calcul de l’utilisation de la mémoire, si elle `MemoryReservation` est spécifiée, elle est utilisée dans le calcul au lieu de la mémoire totale. | ClusterName. | Moyenne, Minimum, Maximum | Pourcentage |
| MemoryUtilization | Pourcentage de mémoire utilisé par le cluster, le service ou le démon géré. L’utilisation de la mémoire au niveau du cluster (filtrée par `ClusterName`) est mesurée comme la mémoire totale utilisée par les tâches Amazon ECS sur le cluster, divisée par la mémoire totale de toutes les instances Amazon EC2 enregistrées dans le cluster. Seules les instances Amazon EC2 dont le statut est `ACTIVE` ou `DRAINING` auront une incidence sur métriques d’utilisation de mémoire. La métrique au niveau du cluster n’est prise en charge que pour les tâches hébergées sur une instance Amazon EC2. L’utilisation de la mémoire au niveau du service (filtrée par `ClusterName`, `ServiceName`) est mesurée comme la mémoire totale utilisée par les tâches appartenant au service, divisée par la mémoire totale réservée aux tâches appartenant au service. La métrique de niveau de service est prise en charge pour les tâches hébergées sur des instances Amazon EC2 et Fargate. L'utilisation de la mémoire au niveau du démon (filtrée par`ClusterName`,`ServiceName`) est mesurée comme la mémoire totale utilisée par les tâches appartenant au démon géré, divisée par la mémoire totale réservée aux tâches appartenant au démon géré. | ClusterName, ServiceName | Moyenne, Minimum, Maximum | Pourcentage |
| EBSFilesystemUtilization | Pourcentage du système de fichiers Amazon EBS utilisé par les tâches d’un service. La métrique d’utilisation du système de fichiers EBS au niveau du service (filtrée par `ClusterName`, `ServiceName`) est mesurée comme la quantité totale du système de fichiers EBS utilisée par les tâches appartenant au service, divisée par la quantité totale de stockage du système de fichiers EBS allouée à toutes les tâches appartenant au service. La métrique d’utilisation du système de fichiers EBS au niveau du service n’est disponible que pour les tâches hébergées sur des instances Amazon EC2 (utilisant la version de l’agent conteneur `1.79.0`) et Fargate (utilisant la version de plateforme `1.4.0`) auxquelles un volume EBS est associé. Pour les tâches hébergées sur Fargate, il existe un espace sur le disque qui n’est utilisé que par Fargate. Il n’y a aucun coût associé à l’espace utilisé par Fargate, mais vous pourrez voir ce stockage supplémentaire à l’aide d’outils tels que `df`. | ClusterName, ServiceName | Moyenne, Minimum, Maximum | Pourcentage |
| GPUReservation | Pourcentage du total disponible GPUs réservé en exécutant des tâches dans le cluster. La métrique de réserve de GPU au niveau du cluster est calculée en divisant le nombre de GPU réservés par les tâches Amazon ECS sur le cluster par le nombre total de GPU disponibles sur toutes les instances Amazon EC2 avec des GPU enregistrés dans le cluster. Seules les instances Amazon EC2 dont le statut est `ACTIVE` ou `DRAINING` auront une incidence sur métriques de réserve de GPU. | ClusterName | Moyenne, Minimum, Maximum | Pourcentage |
| ActiveConnectionCount | Nombre total de connexions simultanées actives entre les clients et les proxys Amazon ECS Service Connect qui s'exécutent dans le cadre de tâches qui partagent le `DiscoveryName` sélectionné. Cette métrique n'est disponible que si vous disposez d'Amazon ECS Service Connect. Dimensions valides : `DiscoveryName` et `DiscoveryName, ServiceName, ClusterName`. | DiscoveryName et DiscoveryName, ServiceName, ClusterName | Moyenne, Minimum, Maximum, Somme | Nombre |
| NewConnectionCount | Nombre total de nouvelles connexions établies entre les clients et les proxys Service Connect Amazon ECS qui s'exécutent dans le cadre de tâches qui partagent le `DiscoveryName` sélectionné. Cette métrique n'est disponible que si vous disposez d'Amazon ECS Service Connect. | DiscoveryName et DiscoveryName, ServiceName, ClusterName | Moyenne, Minimum, Maximum, Somme | Nombre |
| ProcessedBytes | Nombre total d'octets de trafic entrant traités par les proxys Service Connect. Cette métrique n'est disponible que si vous disposez d'Amazon ECS Service Connect. | DiscoveryName et DiscoveryName, ServiceName, ClusterName | Moyenne, Minimum, Maximum, Somme | Octets |
| RequestCount | Nombre de demandes de trafic entrant traitées par les proxys Service Connect. Cette métrique n'est disponible que si vous disposez d'Amazon ECS Service Connect. Vous devez également configurer `appProtocol` dans le mappage des ports dans votre définition de tâche. | DiscoveryName et DiscoveryName, ServiceName, ClusterName | Moyenne, Minimum, Maximum, Somme | Nombre |
| GrpcRequestCount | Nombre de demandes de trafic entrant gRPC traitées par les proxys Service Connect. Cette métrique n'est disponible que si vous avez configuré Amazon ECS Service Connect et que le `appProtocol` est `GRPC` dans le mappage des ports de la définition de la tâche. | DiscoveryName et DiscoveryName, ServiceName, ClusterName | Moyenne, Minimum, Maximum, Somme | Nombre |
| HTTPCode\$1Target\$12XX\$1Count | Nombre de codes de réponse HTTP numérotés de 200 à 299 générés par les applications dans le cadre de ces tâches. Ces tâches sont les cibles. Cette métrique ne compte que les réponses envoyées aux proxys Service Connect par les applications dans le cadre de ces tâches, et non les réponses envoyées directement. Cette métrique n'est disponible que si vous avez configuré Amazon ECS Service Connect et que le `appProtocol` est `HTTP` ou `HTTP2` dans le mappage des ports de la définition de la tâche. Dimensions valides : | TargetDiscoveryName et TargetDiscoveryName, ServiceName, ClusterName | Moyenne, Minimum, Maximum, Somme | Nombre |
| HTTPCode\$1Target\$13XX\$1Count | Nombre de codes de réponse HTTP numérotés de 300 à 399 générés par les applications dans le cadre de ces tâches. Ces tâches sont les cibles. Cette métrique ne compte que les réponses envoyées aux proxys Service Connect par les applications dans le cadre de ces tâches, et non les réponses envoyées directement. Cette métrique n'est disponible que si vous avez configuré Amazon ECS Service Connect et que le `appProtocol` est `HTTP` ou `HTTP2` dans le mappage des ports de la définition de la tâche. | TargetDiscoveryName et TargetDiscoveryName, ServiceName, ClusterName | Moyenne, Minimum, Maximum, Somme | Nombre |
| HTTPCode\$1Target\$14XX\$1Count | Nombre de codes de réponse HTTP numérotés de 400 à 499 générés par les applications dans le cadre de ces tâches. Ces tâches sont les cibles. Cette métrique ne compte que les réponses envoyées aux proxys Service Connect par les applications dans le cadre de ces tâches, et non les réponses envoyées directement. Cette métrique n'est disponible que si vous avez configuré Amazon ECS Service Connect et que le `appProtocol` est `HTTP` ou `HTTP2` dans le mappage des ports de la définition de la tâche. | TargetDiscoveryName et TargetDiscoveryName, ServiceName, ClusterName | Moyenne, Minimum, Maximum, Somme | Nombre |
| HTTPCode\$1Target\$15XX\$1Count | Nombre de codes de réponse HTTP numérotés de 500 à 599 générés par les applications dans le cadre de ces tâches. Ces tâches sont les cibles. Cette métrique ne compte que les réponses envoyées aux proxys Service Connect par les applications dans le cadre de ces tâches, et non les réponses envoyées directement. Cette métrique n'est disponible que si vous avez configuré Amazon ECS Service Connect et que le `appProtocol` est `HTTP` ou `HTTP2` dans le mappage des ports de la définition de la tâche. | TargetDiscoveryName et TargetDiscoveryName, ServiceName, ClusterName | Moyenne, Minimum, Maximum, Somme | Nombre |
| RequestCountPerTarget | Nombre moyen de demandes reçues par chaque cible qui partage le `DiscoveryName` sélectionné. Cette métrique n'est disponible que si vous disposez d'Amazon ECS Service Connect. | TargetDiscoveryName et TargetDiscoveryName, ServiceName, ClusterName | Moyenne | Nombre |
| TargetProcessedBytes | Nombre total d'octets traités par les proxys Service Connect. Cette métrique n'est disponible que si vous disposez d'Amazon ECS Service Connect. | TargetDiscoveryName et TargetDiscoveryName, ServiceName, ClusterName | Moyenne, Minimum, Maximum, Somme | Octets |
| TargetResponseTime | Latence du traitement des demandes d'application. Temps écoulé, en millisecondes, entre le moment où la demande arrive au proxy Service Connect dans la tâche cible et le moment où une réponse de l'application cible arrive au proxy. Cette métrique n'est disponible que si vous disposez d'Amazon ECS Service Connect. | TargetDiscoveryName et TargetDiscoveryName, ServiceName, ClusterName | Moyenne, Minimum, Maximum | Millisecondes |
| ClientTLSNegotiationErrorCount | Nombre total de fois où la connexion TLS a échoué. Cette métrique n’est utilisée que lorsque le protocole TLS est activé. Cette métrique n'est disponible que si vous disposez d'Amazon ECS Service Connect. | DiscoveryName et DiscoveryName, ServiceName, ClusterName | Moyenne, Minimum, Maximum, Somme | Nombre |
| TargetTLSNegotiationErrorCount | Nombre total de fois où la connexion TLS a échoué en raison de certificats clients manquants, d'échecs de AWS CA privée vérifications ou de vérifications SAN infructueuses. Cette métrique n’est utilisée que lorsque le protocole TLS est activé. Cette métrique n'est disponible que si vous disposez d'Amazon ECS Service Connect. | ServiceName, ClusterName, TargetDiscoveryName et TargetDiscoveryName | Moyenne, Minimum, Maximum, Somme | Nombre |
## Dimensions pour les métriques Amazon ECS
Les métriques Amazon ECS utilisent l'espace de noms `AWS/ECS` et fournissent des métriques pour les dimensions suivantes. Amazon ECS envoie uniquement des métriques pour les ressources dont les tâches sont à l'état `RUNNING`. Par exemple, si vous avez un cluster avec un service mais que ce service n'a aucune tâche avec l'état `RUNNING`, aucune métrique n'est envoyée à CloudWatch. Si vous disposez de deux services et que l'un d'eux seulement a des tâches en cours d'exécution, seules les métriques du service avec des tâches en cours d'exécution seront envoyées.
****
| Dimension | Définition |
| --- | --- |
| ClusterName | Cette dimension filtre les données que vous demandez pour toutes les ressources dans un cluster donné. Toutes les métriques Amazon ECS sont filtrées par `ClusterName`. |
| ServiceName | Cette dimension filtre les données que vous demandez pour toutes les ressources d'un service ou d'un démon spécifique au sein d'un cluster spécifique. Pour les métriques du démon, la valeur de la `ServiceName` dimension comporte le préfixe `daemon:` suivi du nom du démon. Par exemple, un démon nommé `my-daemon` aurait une valeur de `ServiceName` dimension de`daemon:my-daemon`. |
| DiscoveryName | Cette dimension filtre les données que vous demandez pour les métriques de trafic vers un nom de découverte Service Connect spécifié dans tous les clusters Amazon ECS. Notez qu'un port spécifique d'un conteneur en cours d'exécution peut avoir plusieurs noms de découverte. |
| DiscoveryName, ServiceName, ClusterName | Cette dimension filtre les données que vous demandez pour les métriques de trafic vers un nom de découverte Service Connect spécifié pour les tâches portant ce nom de découverte et créées par ce service dans ce cluster. Utilisez cette dimension pour voir les métriques du trafic entrant d'un service spécifique, si vous avez réutilisé le même nom de découverte dans plusieurs services dans des espaces de noms différents. Notez qu'un port spécifique d'un conteneur en cours d'exécution peut avoir plusieurs noms de découverte. |
| TargetDiscoveryName | Cette dimension filtre les données que vous demandez pour les métriques de trafic vers un nom de découverte Service Connect spécifié dans tous les clusters Amazon ECS. À la différence de `DiscoveryName`, ces métriques de trafic mesurent uniquement le trafic entrant vers ce `DiscoveryName` issu d'autres tâches Amazon ECS ayant une configuration Service Connect dans cet espace de noms. Cela inclut les tâches effectuées par les services avec une configuration Service Connect client uniquement ou client-serveur. Notez qu'un port spécifique d'un conteneur en cours d'exécution peut avoir plusieurs noms de découverte. |
| TargetDiscoveryName, ServiceName, ClusterName | Cette dimension filtre les données que vous demandez pour les métriques de trafic vers un nom de découverte Service Connect spécifié, mais ne compte que le trafic des tâches créées par ce service dans ce cluster. Utilisez cette dimension pour voir les métriques de trafic entrant provenant d'un client spécifique dans un autre service. À la différence de `DiscoveryName, ServiceName, ClusterName`, ces métriques de trafic mesurent uniquement le trafic entrant vers ce `DiscoveryName` issu d'autres tâches Amazon ECS ayant une configuration Service Connect dans cet espace de noms. Cela inclut les tâches effectuées par les services avec une configuration Service Connect client uniquement ou client-serveur. Notez qu'un port spécifique d'un conteneur en cours d'exécution peut avoir plusieurs noms de découverte. |