O que são Sondas?
As sondas são pequenos agentes de software que instala na sua própria infraestrutura ou em servidores remotos. Executam testes de rede e enviam os resultados em tempo real para este painel.
Visibilidade Total
Tenha a visão exata do que está a acontecer 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 ficheiro 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 os nossos servidores.
Dica: Agora pode sobrescrever o Intervalo de Pacotes MTR para alvos específicos diretamente nas definições do Alvo. A variável MTR_INTERVAL_SECONDS serve como um fallback global.
Inicie e Monitorize
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 a acontecer via Docker. Para equipas 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 alterações 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.
Otimização de Desempenho
Por que o intervalo é configurado aqui?
O TraceLog delega a execução para sondas distribuídas. O intervalo de verificação é 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 predefinição, a sonda processa 5 alvos simultaneamente. Se estiver a monitorizar um grande número de alvos (ex: > 50) com uma única sonda, poderá 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, aumentaria para 25 workers.
Dica de Redes
As flags NET_RAW e NET_ADMIN são fundamentais para que o MTR e Traceroute sejam executados em modo privilegiado no kernel.
Atualização Automática
Mantenha as suas sondas atualizadas executando "docker-compose pull" periodicamente para carregar novas funcionalidades de diagnóstico.
Versionamento
O TraceLog agora rastreia automaticamente a versão da sua sonda. Verifique em "Rede > Sondas" se está a executar a última versão estável do motor de telemetria.Versão atual da sonda: vdev