Przejdź do treści
Biblioteka skilli
DevOps i chmura · Budowanie i kod

spring-observability

/spring-observability

Dodaje i przegląda obserwowalność w aplikacjach Spring Boot 3 i 4: Actuator, metryki Micrometer, tracing OpenTelemetry i logi z identyfikatorami.

Licencja
MIT
Ostatnia zmiana repozytorium
13.11.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
6
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
4
Przestarzałość

Brak sygnałów. Repozytorium zmienione 13.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Dodaje i przegląda obserwowalność w aplikacjach Spring Boot 3 i 4: Actuator, metryki Micrometer, tracing OpenTelemetry i logi z identyfikatorami.

Oryginalny opis (EN)

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, monitoring or troubleshooting a Spring Boot service.

Jak działa

  1. Safety rules
  2. Detect first
  3. Quick start
  4. Topics
  5. Checklist
  6. Local runtime insights (optional)
Sekcje z nagłówków SKILL.md, w oryginale · 65 linii, 388 słów
Podgląd SKILL.md
---
name: spring-observability
description: '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, monitoring or troubleshooting a Spring Boot service.'
---

# Spring Boot observability

Covers Actuator, Micrometer, the Observation API, tracing, and logging. Details in `references/`. For JDK-level diagnosis (thread dumps, JFR, heap analysis) see the `java-diagnostics` skill; for securing endpoints see `spring-security`.

## Safety rules

- Never read or print secrets (`.env`, credentials, tokens) while inspecting configuration or `/actuator/env`.
- Never expose `heapdump` or `threaddump` over public HTTP. The only exception is a temporary, user-consented window with authentication, TLS and network restriction, removed afterwards (same policy in `java-diagnostics`).
- Never expose `env`, `configprops`, `loggers`, or `shutdown` in production without authentication and network restrictions.
- Pin dependency versions via the Boot BOM; do not add explicit versions for Boot-managed artifacts.

## Detect first

Check the Boot version (3.x or 4.x) and what is already present (`spring-boot-starter-actuator`, `micrometer-registry-*`, tracing/OTel dependencies, `logback-spring.xml`). Boot 4 modularized observability (`spring-boot-micrometer-*`, `spring-boot-opentelemetry`) but starters still bring them in.

## Quick start

```xml
<dependency>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-starter-actuator</artifactId>
</dependency>
```

```yaml
management:
  endpoints:
    web:
      exposure:
        include: health,info,prometheus   # allow-list, never "*" in production
  endpoint:
    health:
      probes:
        enabled: true                     # /actuator/health/liveness and /readiness
      show-details: when-authorized
```

## Topics

- [Actuator, health groups and probes, endpoint exposure](references/actuator.md)
- [Micrometer metrics and Prometheus/OTLP export](references/metrics.md)
- [Observation API and tracing with OpenTelemetry](references/tracing-observation.md)
- [Structured logging and correlation ids](references/logging.md)
- [Heapdump/threaddump caveats and runtime diagnosis](references/dumps-and-diagnostics.md)

## Checklist

- [ ] Only needed endpoints exposed and secured; separate management port if possible.
- [ ] Liveness/readiness probes configured for the platform (Kubernetes); readiness group includes critical dependencies only.
- [ ] Metrics exported to the chosen backend; common tags (`application`, `env`) set; no high-cardinality tags (user ids, URLs with ids).
- [ ] Tracing sampling probability set deliberately (Boot default 10%).
- [ ] Logs carry trace/span ids; JSON structured logs in production.
- [ ] Custom observations/metrics have tests.

## Local runtime insights (optional)

For a local-only developer console (and an opt-in MCP server) that shows a running Spring Boot or Quarkus app's runtime state, see BootUI: https://github.com/jdubois/boot-ui and https://www.julien-dubois.com/boot-ui/. Its agent skill can be installed with `gh skill install jdubois/boot-ui skills/bootui`.

- Ask the user for consent before adding any dependency.
- Use it only in a dev/local profile (for example a Maven/Gradle profile or `developmentOnly` configuration); never ship it to production.
- Follow BootUI's own documentation for coordinates and setup rather than copying them here.

See also: <https://docs.spring.io/spring-boot/reference/actuator/observability.html> and <https://docs.micrometer.io/micrometer/reference/>.
Pliki w paczce (6)
  • SKILL.md 4 KB
  • references/actuator.md 2 KB
  • references/dumps-and-diagnostics.md 1 KB
  • references/logging.md 2 KB
  • references/metrics.md 2 KB
  • references/tracing-observation.md 3 KB

Wersje

W bazie nie ma innych skilli o nazwie spring-observability.

Migawka bazy z 13.11.2026 · wersja paczki 2ca34c58ec75 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100production-observability
    Konfiguruje w Spring Boot 4 Actuator, Micrometer Observation i Tracing, eksport OTLP, logi strukturalne, health probes i alerty.
  • 100production-observability
    Dodaje do aplikacji Spring Boot 3 Actuator, metryki Micrometer, śledzenie OpenTelemetry, logi strukturalne, health checks i alerty.
  • 100spring-boot-observability
    Wspiera obserwowalność Spring Boot 4 z Actuator, Micrometer i OpenTelemetry: health checki, metryki własne, tracing, sondy Kubernetes i Cloud Run, logowanie i zabezpieczenie endpointów.
  • 100spring-boot-observability
    Instrumentuje Spring Boot metrykami Micrometer, rozproszonym śledzeniem i logowaniem strukturalnym.
  • 100spring-actuator
    Konfiguruje Spring Boot Actuator do monitoringu: health indicators, metryki Micrometer, integrację z Prometheus, własne endpointy, sondy Kubernetes i zabezpieczenie endpointów.
  • 100spring-boot-actuator
    Konfiguruje Spring Boot Actuator do monitoringu produkcyjnego: sondy zdrowia, zabezpieczone endpointy zarządzania i metryki Micrometer w usługach JVM.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.