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 collectd
Vous pouvez récupérer des métriques supplémentaires à partir de vos applications ou services à l'aide de l' CloudWatchagent avec le protocole collectd, qui n'est pris en charge que sur les serveurs Linux. collectd est une solution open source populaire dotée de plugins permettant de recueillir des statistiques système pour une grande variété d'applications. En combinant les métriques système que l' CloudWatch agent peut déjà collecter avec les métriques supplémentaires collectées, vous pouvez mieux surveiller, analyser et dépanner vos systèmes et applications. Pour de plus amples informations sur collectd, consultez [collectd - Démon de collecte des statistiques système](https://collectd.org/).
Vous utilisez le logiciel collectd pour envoyer les métriques à l' CloudWatch agent. Pour les métriques collectées, l' CloudWatch agent agit en tant que serveur tandis que le plugin collectd agit en tant que client.
Le logiciel collectd n'est pas installé automatiquement sur chaque serveur. Sur un serveur exécutant Amazon Linux 2, procédez comme suit pour installer collectd
```
sudo amazon-linux-extras install collectd
```
Pour obtenir des informations sur l'installation de collectd sur d'autres systèmes, consultez la [page de téléchargement de collectd](https://www.collectd.org/download.html).
Pour collecter ces métriques personnalisées, ajoutez une ligne **"collectd": {}** à 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 pour vous. Pour de plus amples informations, consultez [Création du fichier de configuration de CloudWatch l'agent](create-cloudwatch-agent-configuration-file.md).
Des paramètres facultatifs sont également disponibles. Si vous utilisez collectd et que vous n'utilisez pas `/etc/collectd/auth_file` comme votre **collectd\_auth\_file**, vous devez définir certaines de ces options.
+ **service\_address : adresse** du service que l' CloudWatch agent doit écouter. Le format est le suivant `"udp://{{ip}}:{{port}}`. La valeur par défaut est `udp://127.0.0.1:25826`.
+ **name\_prefix** : Un préfixe à attacher au début du nom de chaque métrique collectd. La valeur par défaut est `collectd_`. La longueur maximale est de 255 caractères.
+ **collectd\_security\_level** : définit le niveau de sécurité pour la communication réseau. La valeur par défaut est **encrypt**.
**encrypt** spécifie que seules les données chiffrées sont acceptées. **sign** spécifie que seules les données signées et chiffrées sont acceptées. **none** spécifie que toutes les données sont acceptées. Si vous spécifiez une valeur pour **collectd\_auth\_file**, les données chiffrées sont déchiffrées si cela est possible.
Pour plus d'informations, consultez [Client setup](https://collectd.org/wiki/index.php/Networking_introduction#Client_setup) (Configuration de client) et [Possible interactions](https://collectd.org/wiki/index.php/Networking_introduction#Possible_interactions) (Interactions possibles) dans le Wiki collectd.
+ **collectd\_auth\_file** Définit un fichier dans lequel les noms d'utilisateur sont mappés aux mots de passe. Ces mots de passe sont utilisés pour vérifier les signatures et pour déchiffrer des paquets réseau chiffrés. Le cas échéant, les données signées sont vérifiées et les paquets chiffrés sont déchiffrés. Dans le cas contraire, les données signées sont acceptées sans vérification de la signature et les données chiffrées ne peuvent pas être déchiffrées.
La valeur par défaut est `/etc/collectd/auth_file`.
Si **collectd\_security\_level** est défini sur **none**, l'opération est facultative. Si vous définissez **collectd\_security\_level** sur `encrypt` ou **sign**, vous devez spécifier **collectd\_auth\_file**.
Pour le format du fichier d'authentification, chaque ligne est un nom d'utilisateur suivi de deux points et d'un nombre quelconque d'espaces, puis du mot de passe. Par exemple :
`user1: user1_password`
`user2: user2_password`
+ **collectd\_typesdb :** liste d'un ou de plusieurs fichiers qui contiennent les descriptions des ensembles de données. La liste doit être entourée d'accolades, même si la liste ne comprend qu'une seule entrée. Chaque entrée de la liste doit figurer entre guillemets doubles. Si la liste contient plusieurs entrées, séparez-les par des virgules. La valeur par défaut sur les serveurs Linux est `["/usr/share/collectd/types.db"]`. La valeur par défaut sur les ordinateurs macOs dépend de la version de collectd. Par exemple, `["/usr/local/Cellar/collectd/5.12.0/share/collectd/types.db"]`.
Pour de plus amples informations, veuillez consulter [https://www.collectd.org/documentation/manpages/types.db.html](https://www.collectd.org/documentation/manpages/types.db.html).
+ **metrics\_aggregation\_interval** : Indique la fréquence, en secondes, de regroupement des métriques en points de données uniques par CloudWatch. Le durée par défaut est de 60 secondes. La plage est comprise entre 0 et 172 000. La définir à zéro désactive le regroupement de métriques collectd.
L'exemple suivant illustre la section collectd du fichier de configuration d'agent.
```
{
"metrics":{
"metrics_collected":{
"collectd":{
"name_prefix":"My_collectd_metrics_",
"metrics_aggregation_interval":120
}
}
}
}
```
## Afficher les métriques collectées importées par l' CloudWatch agent
Après avoir importé les métriques collectées 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 collectd 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 collectées 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. Par défaut, il s'agit de **CWagent**, mais vous avez peut-être spécifié un espace de noms différent dans le fichier de configuration de l' CloudWatch agent.
1. Choisissez une dimension métrique (par exemple, **Per-InstanceMetrics**).
1. L'onglet **All metrics (Toutes les métriques)** affiche toutes les métriques pour cette dimension dans l'espace de noms. 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**.