Guia de Projeto Spring Boot

Use este guia para serviços Spring Boot onde controllers, serviços e repositórios precisam ser diagnosticáveis.

Escopo de Arquitetura

• Controllers e cadeia de filtros servlet.
• Camadas de serviço e repositório.
• Clientes outbound (HTTP, mensageria, DB).

Setup Recomendado

1. Inicialize SDK no startup da aplicação.
2. Instrumente requisições HTTP de entrada.
3. Capture exceções com vínculo de trace.
4. Instrumente DB e chamadas externas.

Contrato Mínimo de Dados

• Tags service, env, version em todos os sinais.
• Metadata de release para correlação com deploy.
• Erros com stack e rota.

Lista de Verificação

• Boot emite sinal de startup.
• Respostas 5xx ligadas a trace.
• Queries lentas aparecem na timeline de spans.

Fortalecimento de Produção

1. Flush em hooks de shutdown.
2. Retry limitado para evitar cascata.
3. Alertas para erros de ingestão/auth.
4. Revalidação após upgrades de dependência/JDK.

Solução de Problemas

• Sem dados após refactor: valide caminho de init do bean.
• Sem spans DB: instrumente fronteiras de driver/repo.
• Cardinalidade alta: normalize tags dinâmicas.