Cuando diseñamos el agente CCS, la primera pregunta fue obvia: ¿cómo envía el servidor datos al panel? La respuesta instintiva es polling HTTP. Elegimos otro modelo.
POLLING HTTP: unas 180 req/s para 150 servidores, 12 capas y un intervalo de 10 segundos.
WEBSOCKET: 150 conexiones persistentes y bidireccionales.
La matemática
requests_per_second = 150 hosts × 12 capas / 10s
= 180 req/s
Con intervalos de un segundo son 1.800 requests por segundo; con 100 ms, 18.000. El coste crece con la flota y no con la cantidad de información útil intercambiada.
Por qué WebSocket
WebSocket paga la apertura una vez por servidor y después ofrece streaming full-duplex sobre una conexión TCP persistente. Reduce latencia, permite acciones de vuelta sin otro endpoint y comprime bien los datos estructurados.
El CCS client usa WebSocket binario, framing CBOR y autenticación mTLS, con reconexión exponencial, heartbeat y buffer local offline.
De dentro hacia fuera
El client instalado en el host inicia la conexión al CCS sys externo. El host no expone un puerto administrativo, no acepta SSH del plano de control y no hace circular credenciales de acceso remoto. Telemetría y acciones comparten el canal autenticado.
Esta separación también aísla fallos: un host con presión de CPU, memoria o Docker no comparte recursos con el plano de control.
Trade-offs
Las conexiones persistentes requieren planificación, los proxies pueden cerrarlas en silencio y depurarlas es más difícil que usar curl. Heartbeats, reconexión y herramientas de inspección dedicadas son imprescindibles.
Lo que quedó
El polling es defendible para sistemas pequeños que toleran minutos de latencia. WebSocket vale la pena cuando los eventos deben llegar en segundos, las acciones deben volver sin endpoints inbound y cientos de hosts deben permanecer conectados sin multiplicar la ceremonia HTTP.
Lo que muestra el panel CCS existe porque un agente acaba de enviarlo, no porque un cron job vaya a comprobarlo dentro de cinco minutos.
— Henrique Salles · Ingeniería · Plataforma · CCS