O que são Sondas?
Sondas são pequenos agentes de software que você instala em sua própria infraestrutura ou servidores remotos. Eles executam testes de rede e enviam os resultados em tempo real para este painel.
Visibilidade Total
Tenha a visão exata do que está acontecendo em diferentes pontos de presença (PoPs) ou na rede do seu cliente final.
Troubleshooting Ágil
Identifique se a latência alta é um problema local, de trânsito IP ou do destino testando de múltiplas origens.
Guia de Implementação
Prepare o Ambiente
Crie um diretório dedicado para a sonda no seu servidor Linux com Docker instalado.
$ mkdir tracelog-probe
$ cd tracelog-probe
Configure o Docker Compose
Crie o arquivo docker-compose.yml com as variáveis de ambiente corretas.
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)Atenção
A SENSOR_KEY deve ser gerada no menu "Rede > Sondas" deste painel. Sem essa chave, a sonda não conseguirá se autenticar com nossos servidores.
Dica: Agora você pode sobrescrever o Intervalo de Pacotes MTR para alvos específicos diretamente nas configurações do Alvo. A variável MTR_INTERVAL_SECONDS serve como um fallback global.
Inicie e Monitore
Inicie o container e acompanhe os logs em tempo real para validar a comunicação.
Compatibilidade com Agente NOC
A implantação remota de sondas continua acontecendo via Docker. Para equipes que já usam o Agente NOC, o TraceLog pode expor telemetria e estatísticas dentro do agente como camada opcional de compatibilidade.
Continuidade operacional
O TraceLog permanece a plataforma de observabilidade enquanto o Agente NOC se torna uma interface extra para consultar mudanças de rota, latência e evidências.
Acesso a dados com contexto
Clientes que já operam com o Agente NOC podem consultar medições do TraceLog sem duplicar painéis ou alterar a implantação das sondas.
Ajuste de Performance
Por que o intervalo é configurado aqui?
O TraceLog delega a execução para sondas distribuídas. O intervalo de checagem é definido globalmente na sonda (CHECK_INTERVAL) para garantir consistência e respeitar a capacidade de processamento (Workers). Definir intervalos individuais por alvo causaria fragmentação e dificuldades no cálculo de capacidade.
Recomendamos sempre configurar o intervalo da sonda com uma margem de segurança (ex: +20%) acima do tempo mínimo calculado.
Por padrão, a sonda processa 5 alvos simultaneamente. Se você estiver monitorando um grande número de alvos (ex: > 50) com uma única sonda, pode ser necessário ajustar o MAX_WORKERS para garantir que todas as verificações sejam concluídas dentro do intervalo configurado.
Fórmula de Otimização
Cenário
- Alvos100
- Intervalo5 min (300s)
- Tempo Médio MTR~15s
Recomendação
MAX_WORKERS = (100 * 15s) / 300s ≈ 5Neste caso, 5 workers são suficientes. Para 500 alvos, você aumentaria para 25 workers.
Dica de Redes
As flags NET_RAW e NET_ADMIN são fundamentais para que o MTR e Traceroute rodem em modo privilegiado no kernel.
Atualização Automática
Mantenha suas sondas atualizadas rodando "docker-compose pull" periodicamente para carregar novos recursos de diagnóstico.
Versionamento
O TraceLog agora rastreia automaticamente a versão da sua sonda. Verifique em "Rede > Sondas" se você está rodando a última versão estável do motor de telemetria.Versão atual da sonda: vdev