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.
# Récupération de métriques personnalisées avec StatsD
Vous pouvez récupérer des métriques personnalisées supplémentaires à partir de vos applications ou services à l'aide de l' CloudWatch agent associé au `StatsD` protocole. StatsD est une solution open source populaire qui peut collecter des métriques à partir d'une grande variété d'applications. StatsD est particulièrement utile pour instrumenter vos propres métriques. Pour un exemple d'utilisation conjointe de l' CloudWatch agent et de StatsD, consultez [Comment mieux surveiller les métriques personnalisées de votre application à l'aide d'Amazon CloudWatch](https://aws.amazon.com/blogs/devops/new-how-to-better-monitor-your-custom-application-metrics-using-amazon-cloudwatch-agent/) Agent.
`StatsD`est pris en charge à la fois sur les serveurs Linux et sur les serveurs exécutant Windows Server. CloudWatch prend en charge le `StatsD` format suivant :
```
MetricName:value|type|@sample_rate|#tag1:
value,tag1...
```
+ `MetricName` – Une chaîne sans signe deux-points, sans barre, sans caractère \$1 ou @.
+ `value` – Il peut s'agir d'un nombre entier ou à virgule flottante.
+ `type` – Spécifie `c` pour compteur, `g` pour jauge, `ms` pour minuteur, `h` pour histogramme ou `s` pour définir.
+ `sample_rate` – (Facultatif) Une valeur à virgule flottante comprise entre 0 et 1, inclus. À réserver aux métriques de compteur, d'histogramme et de minuteur. La valeur par défaut est 1 (échantillonnage 100 % du temps).
+ `tags`— (Facultatif) Liste de balises séparées par des virgules. `StatsD`les balises sont similaires aux dimensions de CloudWatch. Utilisez le signe deux-points pour les balises clé/valeur, telles que `env:prod`.
Vous pouvez utiliser n'importe quel `StatsD` client utilisant ce format pour envoyer les métriques à l' CloudWatch agent. Pour plus d'informations sur certains des `StatsD` clients disponibles, consultez la [page du client StatsD](https://github.com/etsy/statsd/wiki#client-implementations) sur. GitHub
Pour collecter ces métriques personnalisées, ajoutez une ligne `"statsd": {}` à la section `metrics_collected` du fichier de configuration de l'agent. Vous pouvez ajouter cette ligne manuellement. Si vous utilisez l'assistant pour créer le fichier de configuration, cette opération est faite à votre place. Pour de plus amples informations, consultez [Création du fichier de configuration de CloudWatch l'agent](create-cloudwatch-agent-configuration-file.md).
La configuration par défaut du protocole `StatsD` fonctionne pour la plupart des utilisateurs. Il existe des champs facultatifs que vous pouvez ajouter à la section **statsd** du fichier de configuration de l'agent, le cas échéant :
+ `service_address`— L'adresse de service que l' CloudWatch agent doit écouter. Le format est le suivant `ip:port`. Si vous omettez l'adresse IP, l'agent écoute sur toutes les interfaces disponibles. Seul le format UDP est pris en charge, vous n'avez donc pas besoin de spécifier un préfixe UDP.
La valeur par défaut est `:8125`.
+ `metrics_collection_interval` – Indique la fréquence, en secondes, d'exécution et de collecte des métriques par le plugin `StatsD`. La valeur par défaut est de 10 secondes. La plage est comprise entre 1 et 172 000.
+ `metrics_aggregation_interval`— À quelle fréquence, en secondes, CloudWatch agrège les métriques en points de données uniques. La valeur par défaut est de 60 secondes.
Par exemple, si la valeur `metrics_collection_interval` est égale à 10 et `metrics_aggregation_interval` à 60, CloudWatch collecte des données toutes les 10 secondes. Après chaque minute, les six lectures de données effectuées lors de cette minute sont regroupées en un seul point de données, qui est envoyé à CloudWatch.
La plage est comprise entre 0 et 172 000. Le fait de définir `metrics_aggregation_interval` sur zéro désactive le regroupement de métriques `StatsD`.
+ `allowed_pending_messages` – Nombre de messages UDP autorisés à être placés en file d'attente. Lorsque la file d'attente est pleine, le serveur StatsD commence à supprimer des paquets. La valeur par défaut est 10 000.
+ `drop_original_metrics` : facultatif. Si vous utilisez le champ `aggregation_dimensions` de la section `metrics` pour regrouper les métriques dans des résultats agrégés, l'agent envoie par défaut les métriques agrégées et les métriques d'origine qui sont séparées pour chaque valeur de la dimension. Si vous ne souhaitez pas que les mesures d'origine soient envoyées à CloudWatch, vous pouvez spécifier ce paramètre avec une liste de mesures. Les mesures spécifiées avec ce paramètre ne sont pas signalées à CloudWatch. Au lieu de cela, seules les métriques agrégées sont signalées. Cela réduit le nombre de métriques collectées par l'agent, ce qui réduit vos coûts.
Voici un exemple de la section **statsd** du fichier de configuration de l'agent, qui utilise le port par défaut et des intervalles de collecte et de regroupement personnalisés.
```
{
"metrics":{
"metrics_collected":{
"statsd":{
"service_address":":8125",
"metrics_collection_interval":60,
"metrics_aggregation_interval":300
}
}
}
}
```
## Afficher les métriques StatsD importées par l'agent CloudWatch
Après avoir importé les métriques StatsD dans CloudWatch, vous pouvez les visualiser sous forme de graphiques chronologiques et créer des alarmes qui peuvent surveiller ces métriques et vous avertir si elles dépassent un seuil que vous spécifiez. La procédure suivante montre comment afficher les métriques StatsD sous la forme d'un graphique de séries chronologiques. Pour plus d'informations sur la configuration des alertes, consultez [Utilisation des CloudWatch alarmes Amazon](CloudWatch_Alarms.md).
**Pour afficher les métriques StatsD dans la console CloudWatch**
1. Ouvrez la CloudWatch console à l'adresse [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Dans le panneau de navigation, sélectionnez **Métriques**.
1. Sélectionnez l'espace de noms pour les métriques collectées par l'agent. C'est le cas par défaut **CWAgent**, mais vous avez peut-être spécifié un espace de noms différent dans le fichier de configuration de l' CloudWatch agent.
1. Sélectionnez une dimension de métrique (**Per-Instance Metrics (Métriques par instance)** par exemple).
1. L'onglet **All metrics (Toutes les métriques)** affiche toutes les métriques pour cette dimension dans l'espace de nom. Vous pouvez effectuer les opérations suivantes :
1. Pour représenter graphiquement une métrique, cochez la case en regard de la métrique. Pour sélectionner toutes les métriques, cochez la case dans la ligne d’en-tête du tableau.
1. Pour trier le tableau, utilisez l’en-tête de colonne.
1. Pour filtrer par ressource, sélectionnez l'ID de ressource, puis **Add to search Ajouter à la recherche)**.
1. Pour filtrer par métrique, choisissez le nom de la métrique, puis **Add to search (Ajouter à la recherche)**.
1. (Facultatif) Pour ajouter ce graphique à un CloudWatch tableau de bord, choisissez **Actions**, puis **Ajouter au tableau de bord**.