Telegraf est un agent de serveur piloté par plug-in pour la collecte et l'envoi de mesures et d'événements à partir de systèmes.
Le plug-in d'entrée est /etc/telegraf/vcg_metrics.sh
, un fichier contenant les compteurs à ajouter. Le plug-in de sortie peut être Wavefront ou Prometheus.
Telegraf collecte les mesures à partir des entrées déclarées et envoie les détails aux sorties déclarées.
Note : Chaque fois qu'une modification est apportée à la configuration de Telegraf, vous devez redémarrer le processus Telegraf à l'aide de la commande
systemctl restart telegraf
.
Procédure
- Utilisez les commandes suivantes pour configurer le plug-in de sortie. Vous pouvez personnaliser les ports dans les fichiers de configuration correspondants, si nécessaire.
- Pour Wavefront
[[outputs.wavefront]]
host = "wavefront_proxy_IP"
port = 2878
metric_separator = "."
source_override = ["hostname", "agent_host", "node_host"]
convert_paths = true
Le paramètre wavefront_proxy_IP est l'adresse IP du serveur proxy Wavefront.
- Pour Prometheus
[[outputs.prometheus_client]]
listen=":9273"
metric_version=2
- Telegraf doit exécuter la commande
/opt/vc/bin/dispcnt
dans vcg_metrics.sh
pour collecter les mesures depuis SD-WAN Gateway, et la commande nécessite sudo. Utilisez la commande suivante pour ajouter Telegraf au groupe sudo.
sudo usermod -G sudo telegraf
- Ajoutez les règles de la table d'adresses IP pour permettre aux systèmes de surveillance externes d'accéder au port Telegraf. Vous devez spécifier l'adresse IP source pour des raisons de sécurité. Ajoutez les règles suivantes pour autoriser le trafic en provenance de Wavefront et de Prometheus. Si nécessaire, vous pouvez personnaliser les ports dans les fichiers de configuration correspondants.
Note : Étant donné que les règles de tableau IP ne seront pas persistantes lors des redémarrages, il est recommandé de les enregistrer à l'aide de la commande
iptables-save
. Cette commande enregistre automatiquement les règles. Vous pouvez également stocker les règles manuellement dans un fichier spécifique à l'utilisateur et réutiliser les règles ultérieurement.
- Pour Wavefront
sudo iptables -I INPUT -p tcp -m tcp --source <wavefront_proxy_IP> --sport 2878 -m comment --comment "wavefront" -j ACCEPT
- Pour Prometheus
sudo iptables -I INPUT -p tcp -m tcp --source <IP> --dport 9273 -m comment --comment "prometheus" -j ACCEPT
Résultats
L'intégration de Telegraf envoie les données des passerelles aux plug-ins de sortie. Vous pouvez alors afficher les détails dans les tableaux de bord au format visuel.
L'image suivante montre un exemple de sortie affiché dans le tableau de bord Wavefront. Le graphique illustre les informations au niveau d'entreprise du nombre de flux, du nombre de NAT, du nombre de routes et des détails du débit.
![](images/GUID-61A955A0-C40C-4BD7-8AF4-260C7CB79820-low.png)
Pour obtenir la liste des compteurs exportés par le script du plug-in d'entrée /etc/telegraf/vcg_metrics.sh
, reportez-vous à la section Compteurs pris en charge.