Configurar la integración de Telegraf

Telegraf es un agente de servidor basado en complementos para recopilar y enviar métricas y eventos desde los sistemas.

El complemento de entrada es /etc/telegraf/vcg_metrics.sh, un archivo que contiene los contadores que se agregarán. El complemento de salida puede ser Wavefront o Prometheus.

Telegraf recopila las métricas de las entradas declaradas y envía los detalles a las salidas declaradas.

Nota: Cada vez que se produce un cambio en la configuración de Telegraf, es necesario reiniciar el proceso de Telegraf mediante el comando systemctl restart telegraf.

Procedimiento

1. Utilice los siguientes comandos para configurar el complemento de salida. Puede personalizar los puertos en los archivos de configuración correspondientes según sea necesario.
   • Para Wavefront

     [[outputs.wavefront]]
     host = "wavefront_proxy_IP"
     port = 2878
     metric_separator = "."
     source_override = ["hostname", "agent_host", "node_host"]
     convert_paths = true
     
     

     El parámetro wavefront_proxy_IP es la dirección IP del servidor proxy de Wavefront.

   • Para Prometheus

     [[outputs.prometheus_client]]
     listen=":9273"
     metric_version=2

2. Telegraf necesita ejecutar el comando /opt/vc/bin/dispcnt en vcg_metrics.sh para recopilar las métricas de SD-WAN Gateway, y el comando requiere sudo. Utilice el siguiente comando para agregar Telegraf al grupo de sudo.

   sudo usermod -G sudo telegraf

3. Agregue las reglas de tabla IP para permitir que los sistemas de supervisión externa accedan al puerto de Telegraf. La dirección IP de origen debe especificarse por motivos de seguridad. Agregue las siguientes reglas para permitir el tráfico desde Wavefront y Prometheus. Si es necesario, puede personalizar los puertos en los archivos de configuración correspondientes.
   Nota: Dado que las reglas de tabla IP no se mantendrán después de los reinicios, se recomienda guardarlas mediante el comando iptables-save. Este comando guarda las reglas automáticamente. También puede almacenar las reglas manualmente en un archivo específico del usuario y reutilizarlas más adelante.
   • Para Wavefront

     sudo iptables -I INPUT -p tcp -m tcp --source <wavefront_proxy_IP> --sport 2878 -m comment --comment "wavefront" -j ACCEPT

   • Para Prometheus

     sudo iptables -I INPUT -p tcp -m tcp --source <IP> --dport 9273 -m comment --comment "prometheus" -j ACCEPT

Resultados

La integración de Telegraf envía los datos desde las puertas de enlace hacia los complementos de salida y permite ver los detalles en los paneles de control en un formato visual.

La siguiente imagen muestra un ejemplo de salida que se muestra en el panel de Wavefront. El gráfico muestra información de nivel empresarial sobre el recuento de flujos, el recuento de NAT, el recuento de rutas y los detalles de rendimiento.

Para obtener la lista de contadores que exporta el script del complemento de entrada /etc/telegraf/vcg_metrics.sh, consulte Contadores admitidos.