REQUESTS / S
1.24k+12.8%CASE STUDY / 2026LEITURA · 06 MIN
NetSphere: um case study de produto e engenharia.
Como uma ideia de observabilidade virou produto, arquitetura e operação em produção.
WORKSPACE / PROJECTapi-demo / production
RANGE · 1HLATENCY P95
184ms−8.4%ERROR RATE
0.42%−0.08%MAPA DO PROJETO
Um sistema. Todas as camadas conectadas.
Produto, arquitetura e operação em uma única leitura.
Área explorávelSistema em produção
01 / PRODUTO
Sinais complexos, decisões claras.
Da visão geral ao detalhe de cada endpoint.
01 / OVERVIEW
SINAL AO VIVO
O sistema em uma leitura
RPS, latência, erros e throughput em quatro janelas de tempo.
RPS1.24kP95184msERROR0.42%
02 / TOPOLOGY
Topologia por telemetria
Gateway, rotas e fluxo entre serviços.
03 / RESPONSE
Do limite ao incidente
Regras, severidade e notificações.
Latency p95FIRING · 08:42Error rateRESOLVED · 08:31
02 / JORNADA DA TELEMETRIA
O caminho de um sinal.
A ingestão permanece rápida porque valida e enfileira. O trabalho pesado acontece de forma assíncrona.
DEPLOYMENT / CURRENT
Arquitetura de produção
VERCEL + VPSFrontend distribuído na edge; backend e dados operados como serviços isolados na VPS.
01
PUBLIC EDGEVercel
WebNext.js · React
LIVEtRPCRESTSSE
02
PRIVATE RUNTIMEVPS / Docker
ENTRYCaddyTLS · Proxy APIFastify
ASYNCRedisQueue · Cache WorkerAsync jobs
DATATimescaleDBTelemetry SimulatorLive traffic
DELIVERYGitHub ActionsOBSERVABILITYSentryNOTIFYResendRECOVERYOffsite backup
03 / ENGENHARIA
Decisões antes de tecnologias.
Cada escolha responde a uma restrição real.
ADR / 0007
Percentis não fazem média.
O NetSphere combina sketches antes de extrair o p95 da janela.
ABORDAGEM INGÊNUA(p95 + p95) / 2× estatisticamente incorreto
ABORDAGEM NETSPHEREsketch → rollup → p95✓ aproximação com erro limitado
Dois contratos, dois públicos
REST para ingestão externa; tRPC para o produto.
Sessões auditáveis
Tokens aleatórios, hashes persistidos e cookies protegidos.
MONOREPO / TURBOREPO
Organizado para explicar — e para crescer.
Aplicações publicáveis e pacotes compartilhados deixam as fronteiras do sistema visíveis.
04 / DESIGN SYSTEM
Interface como instrumento.
A identidade visual traduz estados operacionais sem competir com os dados.
COLOR / SIGNAL
#070A0F#151A22#E3A339#3BBE9C#E45C68
TYPE / DATAp95 184.32ms
IBM Plex Mono · operational precision
COMPONENT / STATES
SYSTEM HEALTHYTHRESHOLD NEARINCIDENT FIRING
NIGHT OPSDark / Default
DAY SHIFTLight / Focused
DESIGN PRINCIPLE / 01
Explorar o arquivo de designFluxos, telas, componentes e decisões visuais do NetSphere.“Cor deve comunicar estado, não decorar superfície.”
Elevação, tipografia e ritmo criam hierarquia; cores semânticas ficam reservadas para os sinais que exigem atenção.
05 / OPERAÇÃO
Produção não termina no deploy.
Saúde, releases e backups tratados como parte do sistema.
PRODUCTION READINESSRUNBOOK / ACTIVE
WEBVercel edgeDOCUMENTED
APIHealth + readinessDOCUMENTED
WORKERHeartbeat monitoredDOCUMENTED
DATABASENightly backupDOCUMENTED
OBSERVABILITYSentry releasesDOCUMENTED
QUALITY GATE / CI
01FORMAT✓
02LINT✓
03TYPES✓
04UNIT✓
05INTEGRATION✓
06BUILD✓
Cada mudança passa pelos mesmos controles.
06 / DOCUMENTAÇÃO
Decisões que podem ser auditadas.
ADRs, contratos e runbooks ligados ao código.
ARTEFATOS DO CASE
Continue pela evidência.
Design, código e produto em produção.