Pular para o conteúdo
Felipe Sousa

Sistema de Observabilidade de Rede Doméstica

Sentinel: um sistema de monitoramento e alertas de rede doméstica, com descoberta de dispositivos, visibilidade de DNS, inteligência de categorias, score de risco e um dashboard para o operador. Em refatoração: os módulos anteriores estão sendo unidos em repositório próprio.

ObservabilityBackendDevOps/Infra

Problema

Redes domésticas comuns dão pouca visibilidade sobre comportamento de dispositivos, atividade de DNS e eventos operacionais, deixando o monitoramento e o controle fragmentados e superficiais.

Solução

Um sensor de rede always-on alimenta eventos de descoberta de dispositivos e consultas DNS numa API de plataforma compartilhada, que normaliza, categoriza e pontua esses dados para um dashboard dedicado ao operador, com alertas, limites configuráveis e relatórios.

Destaques de arquitetura

  • Sensor always-on: descoberta via ARP no Linux, descoberta via cache ICMP/ARP no Windows, visibilidade de DNS via polling do log de consultas de um resolvedor DNS local
  • API de plataforma que recebe dispositivos e eventos de DNS atrás de uma fronteira autenticada por sensor, sustentada por Postgres/Prisma
  • Sete workers agendados: rollups, detecção de offline, arquivamento, revisão de risco, alertas de limite, resumo diário por e-mail e verificação de saúde do próprio sistema
  • Dashboard em Next.js com score de risco por dispositivo (sempre acompanhado do detalhamento dos fatores que o produziram, nunca um número opaco), categorias, alertas, limites customizados, exportação em CSV e relatórios em PDF sob demanda
  • Auto-monitoramento: o sistema detecta e alerta sobre as próprias falhas (resolvedor DNS fora do ar, sensor parado, mudança de endereço do host), verificadas pelo worker e não pelo sensor, justamente porque o sensor é uma das coisas vigiadas
  • Acesso com segundo fator mesmo numa superfície que não é alcançável pela internet: posição na rede não é modelo de autorização

Desafios

  • Descoberta de dispositivos multiplataforma sem uma API de SO única e confiável: ARP no Linux, cache ICMP/ARP no Windows
  • Validar o sistema contra uma rede doméstica real e ativa, em vez de dados sintéticos
  • Um reinício de roteador derrubou o DNS da casa inteira por dias, e diagnosticar isso foi uma investigação manual longa: o sistema sabia descrever todo dispositivo da rede e não tinha nada a dizer sobre si mesmo

Responsabilidades

  • Definir a arquitetura modular dos fluxos de monitoramento e controle
  • Implementar a fundação de visibilidade de DNS e rede de ponta a ponta, do sensor ao dashboard
  • Modelar as entidades de banco para dispositivos, sessões, atividade de DNS, categorias e alertas
  • Entregar o dashboard do operador, os alertas e os relatórios

Resultados

  • Criou uma prova aplicada forte, além do trabalho de arquitetura só do ecossistema
  • Demonstrou pensamento sistêmico em rede, backend, dados e frontend
  • Foi validado de ponta a ponta contra uma rede doméstica real, com descoberta de dispositivos e tráfego de DNS reais, enquanto rodava como módulo da plataforma

Aprendizados

  • Validação contra tráfego real de rede e DNS revelou casos de borda que dados sintéticos não teriam mostrado
  • Um sistema de monitoramento que não enxerga a própria queda reporta "tudo tranquilo" e "eu morri" exatamente igual. Fechar essa lacuna não exigiu infraestrutura nova: bastou reusar o feed de alertas que já existia, com três tipos novos sem dispositivo associado
  • Prova de vida tem que ser sinal direto, não inferência: deduzir "o sensor está vivo" da recência de eventos DNS confunde sensor parado com casa dormindo, e toda madrugada vira falso positivo

Stack

TypeScriptNext.jsReactNode.jsPostgreSQLPrisma