¿Qué son las Sondas?
Las sondas son pequeños agentes de software que instalas en tu propia infraestructura o servidores remotos. Realizan pruebas de red y envían los resultados en tiempo real a este panel.
Visibilidad Total
Obtén la vista exacta de lo que ocurre en distintos puntos de presencia (PoPs) o en la red de tu cliente final.
Resolución Ágil de Problemas
Identifica si la latencia alta es un problema local, de tránsito IP o de destino probando desde múltiples orígenes.
Guía de Implementación
Prepara el Entorno
Crea un directorio dedicado para la sonda en tu servidor Linux con Docker instalado.
$ mkdir tracelog-probe
$ cd tracelog-probe
Configurar Docker Compose
Crea el docker-compose.yml archivo con las variables de entorno correctas.
version: '3.8'
services:
probe:
image: evocodeia/tracelog-probe:latest
container_name: tracelog-probe
restart: always
network_mode: "host"
dns:
- 8.8.8.8 # Google
- 1.1.1.1 # Cloudflare
- 8.8.4.4 # Google Backup
- 1.0.0.1 # Cloudflare Backup
- 9.9.9.9 # Quad9
- 208.67.222.222 # OpenDNS
environment:
- API_BASE_URL=https://tracelog.evocode.ia.br/api
- SENSOR_KEY=SUA_CHAVE_DE_API
- CHECK_INTERVAL_MINUTES=5
- MAX_WORKERS=5 # Opcional: Testes simultâneos (Default: 5)
- MTR_INTERVAL_SECONDS=0.5 # Opcional: Intervalo entre pacotes (Default: 0.5s)Atención
La SENSOR_KEY debe generarse en el menú "Red > Sondas" de este panel. Sin esta clave, la sonda no podrá autenticarse con nuestros servidores.
Consejo: ahora puedes anular el intervalo de paquetes MTR para objetivos específicos directamente en la configuración del Objetivo. La variable MTR_INTERVAL_SECONDS sirve como respaldo global.
Iniciar y Monitorear
Inicia el contenedor y sigue los logs en tiempo real para validar la comunicación.
Compatibilidad con Agente NOC
El despliegue remoto de sondas sigue realizándose mediante Docker. Para equipos que ya usan Agente NOC, TraceLog puede exponer telemetría y estadísticas dentro del agente como capa opcional de compatibilidad.
Continuidad operativa
TraceLog sigue siendo la plataforma de observabilidad mientras Agente NOC se convierte en una interfaz adicional para consultar cambios de ruta, latencia y evidencias.
Acceso a datos con contexto
Los clientes que ya operan con Agente NOC pueden consultar mediciones de TraceLog sin duplicar paneles ni cambiar el despliegue de sondas.
Ajuste de Rendimiento
¿Por qué el intervalo se configura aquí?
TraceLog delega la ejecución a sondas distribuidas. El intervalo de comprobación se define globalmente en la sonda (CHECK_INTERVAL) para garantizar consistencia y respetar la capacidad de procesamiento (Workers). Definir intervalos individuales por objetivo causaría fragmentación y problemas de cálculo de capacidad.
Recomendamos siempre configurar el intervalo de la sonda con un margen de seguridad (ej: +20%) por encima del tiempo mínimo calculado.
Por defecto, la sonda procesa 5 objetivos simultáneamente. Si estás monitoreando un gran número de objetivos (ej.: > 50) con una sola sonda, puede que necesites ajustar el MAX_WORKERS para asegurar que todas las comprobaciones se completen dentro del intervalo configurado.
Fórmula de Optimización
Escenario
- Objetivos100
- Intervalo5 min (300s)
- Tiempo Promedio MTR~15s
Recomendación
MAX_WORKERS = (100 * 15s) / 300s ≈ 5En este caso, 5 workers son suficientes. Para 500 objetivos, deberías aumentarlo a 25 workers.
Consejo de Redes
Las flags NET_RAW y NET_ADMIN son fundamentales para que MTR y Traceroute se ejecuten en modo privilegiado en el kernel.
Actualización Automática
Mantén tus sondas actualizadas ejecutando "docker-compose pull" periódicamente para cargar nuevas funciones de diagnóstico.
Versionado
TraceLog ahora rastrea automáticamente la versión de tu sonda. Verifica en "Red > Sondas" si estás ejecutando la última versión estable del motor de telemetría.Versión actual de la sonda: vdev