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.