O Telegraf é um agente de servidor orientado por plugins para recolha e envio de métricas e eventos de sistemas.

O plugin de entrada é /etc/telegraf/vcg_metrics.sh, um ficheiro que contém os contadores a serem adicionados. O plugin de saída pode ser Wavefront ou Prometheus.

O Telegraf recolhe as métricas das Entradas declaradas e envia os detalhes para as Saídas declaradas.

Nota: Sempre que houver uma alteração na configuração do Telegraf, é necessário reiniciar o processo Telegraf através do comando systemctl restart telegraf.

Procedimento

  1. Utilize os seguintes comandos para configurar o plugin de Saída. Pode personalizar as portas nos ficheiros de configuração correspondentes, conforme necessário.
    • Para o Wavefront
      [[outputs.wavefront]]
      host = "wavefront_proxy_IP"
      port = 2878
      metric_separator = "."
      source_override = ["hostname", "agent_host", "node_host"]
      convert_paths = true
      
      

      O parâmetro wavefront_proxy_IP é o endereço IP do servidor de proxy do Wavefront.

    • Para o Prometheus
      [[outputs.prometheus_client]]
      listen=":9273"
      metric_version=2
  2. O Telegraf precisa de executar o comando /opt/vc/bin/dispcnt em vcg_metrics.sh para recolher as métricas de SD-WAN Gateway e o comando requer sudo. Utilize o comando que se segue para adicionar o Telegraf ao grupo sudo.
    sudo usermod -G sudo telegraf
  3. Adicione as regras da tabela de IP para permitir aos sistemas de monitorização externos acesso à porta do Telegraf. O endereço IP de origem deve ser especificado por razões de segurança. Adicione as seguintes regras para permitir o tráfego do Wavefront e Prometheus. Caso necessário, pode personalizar as portas nos ficheiros de configuração correspondentes.
    Nota: Como as regras iptable não serão persistentes entre reinícios, recomendamos guardar as regras iptable com o comando iptables-save. Este comando guarda as regras automaticamente. Também pode armazenar as regras manualmente num ficheiro específico do utilizador e reutilizar as regras mais tarde.
    • Para o Wavefront
      sudo iptables -I INPUT -p tcp -m tcp --source <wavefront_proxy_IP> --sport 2878 -m comment --comment "wavefront" -j ACCEPT
    • Para o Prometheus
      sudo iptables -I INPUT -p tcp -m tcp --source <IP> --dport 9273 -m comment --comment "prometheus" -j ACCEPT

Resultados

A integração do Telegraf envia os dados dos Gateways para os plugins de saída e pode ver os detalhes nos painéis num formato visual.

A imagem que se segue mostra uma saída de exemplo apresentada no painel do wavefront. O Gráfico ilustra informações de nível Empresarial da contagem de fluxos, contagem de NAT, contagem de caminhos e detalhes de débito.

Para obter a lista dos contadores que são exportados pelo script de plugin de entrada /etc/telegraf/vcg_metrics.sh, veja Contadores suportados.