[Collectd](https://collectd.org/) est un démon collectant des métriques systèmes et applications à intervalles réguliers. Il peut ensuite stocker ces métriques de différentes manières. Nous l'utilisons en combinaison avec [InfluxDB](HowtoInfluxDB) et [Grafana](HowtoGrafana).
Nous préférons collectd à [telegraf](https://www.influxdata.com/time-series-platform/telegraf/), ce dernier n'ayant pas de paquet disponible sous OpenBSD lorsque nous l'avions mis en place. Depuis, un paquet est disponible pour telegraf sous OpenBSD, mais nous restons sous collectd que nous connaissons et utilisons déjà.
Le plugin [network](https://collectd.org/documentation/manpages/collectd.conf.5.shtml#plugin_network) est indispensable et permet de spécifier vers où envoyer les métriques collectées.
Si l'authentification est configurée du côté de la base de données (par exemple sur [InfluxDB](/HowtoInfluxDB#authentification-1)), on peut la configurer ainsi :
~~~
<Pluginnetwork>
<Server"127.0.0.1""25826">
SecurityLevel "sign"
Username "username"
Password "password"
</Server>
</Plugin>
~~~
Attention à ce que le fichier de configuration ne soit lisible que par `root`, vu que le mot de passe est en clair.
Le plugin [syslog](https://collectd.org/documentation/manpages/collectd.conf.5.shtml#plugin_syslog) permet d'écrire des logs dans syslog, en y choisissant le log-level du démon. S'il n'est pas activé, aucun log ne sera présent dans syslog.
Le plugin [logfile](https://collectd.org/documentation/manpages/collectd.conf.5.shtml#plugin_logfile) permet d'écrire des logs dans un fichier texte défini, en y choisissant le log-level du démon.
Le plugin [exec](https://collectd.org/documentation/manpages/collectd-exec.5.shtml) est intéressant puisqu'il permet d'exécuter n'importe quel script afin de récupérer toutes sortes de métriques non prises en charge par un autre plugin.
~~~
<LoadPluginexec>
Interval 300
</LoadPlugin>
<Pluginexec>
Exec "user" "/path/to/script" "arg0" "arg1"
</Plugin>
~~~
La sortie du script doit respecter un format particulier :
*`host` : le nom de la machine associée à la mesure ;
*`plugin` : le nom de la mesure ;
*`instance` (facultatif) : un tag pouvant caractériser la mesure ;
*`type` : le type de mesure, parmi ceux présents dans le fichier `/usr/share/collectd/types.db` (ou `/usr/local/share/collectd/types.db` sous OpenBSD), et définissant le format de `value` ;
*`instance` (facultatif) : un tag pouvant caractériser la mesure ;
*`date` : la date à laquelle la mesure est récupérée, utiliser `N` pour remplacer par la date actuelle ;
*`value` : la valeur à récupérer.
Par exemple, pour récupérer le nombre de préfixes BGP partagés par un voisin :
Le plugin [snmp](https://collectd.org/documentation/manpages/collectd-snmp.5.shtml) permet de faire des requêtes SNMP à des machines spécifiques.
Un block `Data` définit l'OID et sous quel format stocker les valeurs récupérées, et un block `Host` définit quelles machines interroger ainsi que la configuration SNMP.
Exemple pour récupérer le débit et le nombre de paquets unicast d'un switch, la charge d'un APC, et la fréquence, la tension, l'intensité, la source préférée et le statut d'un ATS.
Pour les switchs, si on veut identifier chaque interfaces avec son nom (par exemple Gi0/1) plutôt que sa description (définie avec la commande "description" dans la configuration de l'interface), il faut modifier les lignes de configuration `Instance "1.3.6.1.2.1.31.1.1.1.18"` par `Instance "1.3.6.1.2.1.31.1.1.1.1"` pour les blocs `ifmib_if_octets64`, `ifmib_if_packets64`, `ifmib_if_errors`, et
`ifmib_if_dropped`.
Dans ce cas, au lieu que seules les interfaces ayant une description remontent des données, toutes les interfaces en remonteront (à 0 si rien n'est branché).
