Telegraf è un agente server basato su plug-in per la raccolta e l'invio di metriche ed eventi dai sistemi.
Il plug-in di input è /etc/telegraf/vcg_metrics.sh
, un file che contiene i contatori da aggiungere. Il plug-in di output può essere Wavefront o Prometheus.
Telegraf raccoglie le metriche dagli input dichiarati e invia i dettagli agli output dichiarati.
Nota: Ogni volta che viene apportata una modifica alla configurazione di Telegraf, è necessario riavviare il processo Telegraf utilizzando il comando
systemctl restart telegraf
.
Procedura
- Utilizzare i seguenti comandi per configurare il plug-in di output. È possibile personalizzare le porte nei file di configurazione corrispondenti nel modo opportuno.
- Per Wavefront
[[outputs.wavefront]]
host = "wavefront_proxy_IP"
port = 2878
metric_separator = "."
source_override = ["hostname", "agent_host", "node_host"]
convert_paths = true
Il parametro wavefront_proxy_IP è l'indirizzo IP del server proxy di Wavefront.
- Per Prometheus
[[outputs.prometheus_client]]
listen=":9273"
metric_version=2
- Telegraf deve eseguire il comando
/opt/vc/bin/dispcnt
in vcg_metrics.sh
per raccogliere le metriche da SD-WAN Gateway e il comando richiede sudo. Utilizzare il comando seguente per aggiungere Telegraf al gruppo sudo.
sudo usermod -G sudo telegraf
- Aggiungere le regole della tabella di IP per consentire ai sistemi di monitoraggio esterni di accedere alla porta di Telegraf. Per motivi di sicurezza, è necessario specificare l'indirizzo IP di origine. Aggiungere le seguenti regole per consentire il traffico da Wavefront e Prometheus. Se necessario, è possibile personalizzare le porte nei file di configurazione corrispondenti.
Nota: Poiché le regole della tabella IP non sono persistenti dopo aver eseguito un riavvio, si consiglia di salvare le regole della tabella IP utilizzando il comando
iptables-save
. Questo comando salva le regole automaticamente. È inoltre possibile archiviare manualmente le regole in un file specifico dell'utente e riutilizzarle in un secondo momento.
- Per Wavefront
sudo iptables -I INPUT -p tcp -m tcp --source <wavefront_proxy_IP> --sport 2878 -m comment --comment "wavefront" -j ACCEPT
- Per Prometheus
sudo iptables -I INPUT -p tcp -m tcp --source <IP> --dport 9273 -m comment --comment "prometheus" -j ACCEPT
risultati
L'integrazione di Telegraf invia i dati dai gateway ai plug-in di output ed è possibile visualizzare i dettagli nei dashboard in formato visivo.
L'immagine seguente mostra un output di esempio visualizzato nel dashboard di Wavefront. Il grafico illustra le informazioni a livello di azienda relative al numero di flussi, al numero di NAT e al numero di route, nonché i dettagli relativi alla velocità effettiva.
![](images/GUID-61A955A0-C40C-4BD7-8AF4-260C7CB79820-low.png)
Per l'elenco dei contatori esportati dallo script del plug-in di input /etc/telegraf/vcg_metrics.sh
, vedere Contatori supportati.