Configurar a integração do Telegraf

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

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
```
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
```
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 de tabela de IP não são persistentes entre reinícios, recomendamos guardar as regras de tabela de IP 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.