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

  1. 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
  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
  3. 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.

Per l'elenco dei contatori esportati dallo script del plug-in di input /etc/telegraf/vcg_metrics.sh, vedere Contatori supportati.