AgentSkillsCN

Spring Boot Observability

Micrometer、分布式追踪与结构化日志的规范

SKILL.md
--- frontmatter
name: Spring Boot Observability
description: Standards for Micrometer, Distributed Tracing, and Structured Logging
metadata:
  labels: [spring-boot, observability, tracing, logs]
  triggers:
    files: ['logback-spring.xml', 'application.properties']
    keywords: [micrometer, tracing, correlation-id, mdc]

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