production-observability
/production-observability
Use when adding service-wide Spring Boot 4 Actuator, Micrometer Observation and Tracing, OpenTelemetry or OTLP export, structured logging, health probes, dashboards, or alerts. Combine with ai-observability only for Spring AI-specific token, prompt, and model telemetry.
- Author
- rrezartprebreza ↗
- Repository
- spring-boot-skills ↗
- Licence
- MIT
- Last repository change
- 22.10.2026
Assessment and security
- Files in this package
- 5
- Scripts
- 2
- HTML comments
- 0
- URLs in SKILL.md
- 3
No signals detected. Repository changed on 22.10.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
- 2 scripts in this package. Review them before installing, as Claude may execute them.
Scripts: examples/bad-observation.java, examples/good-observation.java
What it does and when to use it
Use when adding service-wide Spring Boot 4 Actuator, Micrometer Observation and Tracing, OpenTelemetry or OTLP export, structured logging, health probes, dashboards, or alerts. Combine with ai-observability only for Spring AI-specific token, prompt, and model telemetry.
Original author description
Use when adding service-wide Spring Boot 4 Actuator, Micrometer Observation and Tracing, OpenTelemetry or OTLP export, structured logging, health probes, dashboards, or alerts. Combine with ai-observability only for Spring AI-specific token, prompt, and model telemetry.
How it works
- Baseline
- Observation conventions
- Health and readiness
- Logging and alerts
- Examples
- Official sources
- Gotchas
SKILL.md preview
--- name: production-observability description: > Use when adding service-wide Spring Boot 4 Actuator, Micrometer Observation and Tracing, OpenTelemetry or OTLP export, structured logging, health probes, dashboards, or alerts. Combine with ai-observability only for Spring AI-specific token, prompt, and model telemetry. --- # Production Observability Instrument user-visible operations and operational boundaries, not every method. ## Baseline - Add the Boot 4 Actuator starter and one metrics registry selected by the platform. - For OpenTelemetry tracing over OTLP, use `spring-boot-starter-opentelemetry` and Boot's `management.opentelemetry.tracing.export.otlp.*` properties. - Use Micrometer Observation for application metrics and traces. - Prefer Micrometer APIs over direct OpenTelemetry APIs in application code. - Export metrics and traces through OTLP when an OpenTelemetry collector is the platform boundary. - Expose only required actuator endpoints and secure non-public endpoints. ## Observation conventions - Name observations by stable operation, such as `orders.create`. - Use low-cardinality key values for metrics and high-cardinality values only for traces. - Never tag metrics with user IDs, entity IDs, URLs containing IDs, or exception messages. - Register a `ContextPropagatingTaskDecorator` for async executor boundaries. - Enable Reactor automatic context propagation only deliberately and test it. - Avoid annotating already instrumented MVC controllers or repositories with `@Observed`. ## Health and readiness - Keep liveness independent from remote dependencies. - Put traffic-critical dependencies in readiness groups. - Give custom health checks strict timeouts and stable detail keys. - Keep sensitive health details hidden from unauthenticated callers. ## Logging and alerts - Emit structured logs correlated with trace and span IDs. - Redact credentials, tokens, personal data, prompts, and request bodies by default. - Alert on service-objective symptoms: error ratio, latency, saturation, or queue lag. - Include a runbook and service/dependency identity in every actionable alert. ## Examples - See `examples/good-observation.java`, `examples/good-observability.yml`, and `examples/bad-observation.java`. ## Official sources - Boot observability: https://docs.spring.io/spring-boot/reference/actuator/observability.html - Boot tracing: https://docs.spring.io/spring-boot/reference/actuator/tracing.html - Boot structured logging: https://docs.spring.io/spring-boot/reference/features/logging.html#features.logging.structured ## Gotchas - Agent uses high-cardinality IDs as metric tags - reserve them for traces or logs. - Agent directly configures an OpenTelemetry SDK and disables Boot integration accidentally - prefer Boot and Micrometer support. - Agent exposes all actuator endpoints - expose the minimum and secure them. - Agent ties liveness to a database or broker - dependency outages can trigger restart loops. - Agent loses trace context in `@Async` work - register context propagation explicitly.
Files in this package (5)
- SKILL.md 3 KB
- agents/openai.yaml 1 KB
- examples/bad-observation.java 1 KB
- examples/good-observability.yml 1 KB
- examples/good-observation.java 1 KB
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · rrezartprebreza/spring-boot-skills | 100 | MIT |
| rrezartprebreza/spring-boot-skills | 100 | MIT |
Database snapshot: 13.11.2026 · package version 72a9eb95d68d (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100spring-observability
Add and review observability in Spring Boot 3/4 apps: Actuator exposure and health probes, Micrometer metrics, Observation API, OpenTelemetry tracing and OTLP/Prometheus export, structured logging with correlation ids, and safe use of heapdump/threaddump. Use when instrumenting,… - 100spring-boot-observability
Spring Boot 4 observability with Actuator, Micrometer, and OpenTelemetry. Use when configuring health indicators, health checks, custom metrics, distributed tracing, production endpoint exposure, Kubernetes probes, Cloud Run probes, logging, or monitoring. Covers Actuator… - 100spring-boot-observability
Instrument Spring Boot with Micrometer metrics, distributed tracing, and structured logging. Use when adding Micrometer metrics, distributed tracing, or structured logging to Spring Boot. - 100spring-actuator
Spring Boot Actuator for monitoring and management. Covers health indicators, metrics with Micrometer, Prometheus integration, custom endpoints, Kubernetes probes, and endpoint security. USE WHEN: user mentions "actuator", "health endpoint", "metrics", "prometheus",… - 100spring-boot-actuator
Provides patterns to configure Spring Boot Actuator for production-grade monitoring, health probes, secured management endpoints, and Micrometer metrics across JVM services. Use when setting up monitoring, health checks, or metrics for Spring Boot applications. - 100ai-observability
Use when adding Spring AI-specific model observations, token usage, latency, externally configured cost attribution, advisor telemetry, or protected prompt and completion logging. Use production-observability for general service metrics, health, logs, and OTLP setup.