# Spring Boot Observability

> Standards for Micrometer, Distributed Tracing, and Structured Logging

- Skill: `fierzone/spring-boot-observability` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add fierzone/spring-boot-observability`
- Raw SKILL.md: https://api.skillmd.com/api/skills/fierzone/spring-boot-observability/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: fierzone (https://skillmd.com/u/fierzone)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/fierzone/spring-boot-observability

---


# Spring Boot Observability

## **Priority: P0**

## Implementation Guidelines

### Distributed Tracing

- **Correlation IDs**: Enable trace/span ID injection.
- **Propagation**: Propagate context across threads (`@Async`) and clients.
- **OpenTelemetry**: Use OTel bridge (`micrometer-tracing-bridge-otel`).

### Structured Logging

- **Format**: Use JSON logging (`logstash-logback-encoder`) in production.
- **MDC**: Use MDC for contextual info (userId, tenantId).
- **Output**: Log to stdout only. Let container handle shipping.

### Actuator

- **Security**: Secure `/actuator/**` with Admin role.
- **Probes**: Enable K8s Liveness/Readiness probes.

## Anti-Patterns

- **System.out**: `**No System.out**: Use Slf4j.`
- **Public Actuator**: `**No Open Actuator**: Secure endpoints.`
- **Custom Tracing**: `**No DIY Tracing**: Use Micrometer.`

## References

- [Implementation Examples](references/implementation.md)