java-observability
Installation
SKILL.md
Observabilidade Java / Spring Boot
Esta skill trata dos sinais operacionais e da instrumentação. O gate agregado de release fica em
java-production-readiness; performance e cache ficam em java-performance.
Regras normativas
- Logs devem ser JSON estruturado com
timestamp,level,message,service.namee, quando disponíveis,trace_id/span_id. - Use SLF4J placeholders e MDC para contexto; nunca registre senhas, tokens, cartões, CPF, dados médicos ou outras informações sensíveis.
- Use OpenTelemetry/Jaeger para tracing, spans em operações críticas e propagação de correlation IDs; registre atributos e exceções com segurança.
- Use Actuator para endpoints de health, info, metrics e Prometheus quando aplicável.
- Separe liveness, readiness e startup; readiness pode verificar dependências, liveness não deve derrubar instâncias saudáveis por dependência externa.
- Use Micrometer para counters, timers, gauges e percentis alinhados a perguntas operacionais.
- Ajuste Logback, níveis e exportadores por profile; não copie configuração de desenvolvimento para produção sem revisão.