spring-observability — скилл для GitHub Copilot: как установить
Скилл spring-observability для GitHub Copilot настраивает наблюдаемость в сервисах на Spring Boot 3 и 4. Включается при добавлении метрик Micrometer, трассировки OpenTelemetry и структурированных логов с Actuator.
MIT ★ 41 430 обновлён 2026-10-23
gh skill install github/awesome-copilot skills/spring-observabilityЧто делает spring-observability
Скилл помогает внедрять и проверять наблюдаемость в проектах на Spring Boot 3 и 4. Он определяет версию фреймворка, проверяет наличие стартеров Actuator, реестров Micrometer и конфигураций Logback, а затем формирует настройки для сбора метрик, трассировки через Observation API и передачи данных в Prometheus или OTLP.
Инструмент соблюдает правила изоляции данных. Он запрещает выводить секреты из конфигураций и конечной точки /actuator/env, а эндпоинты heapdump, threaddump, env, loggers и shutdown блокирует для публичного доступа без авторизации и сетевых ограничений. Все версии библиотек фиксируются через Spring Boot BOM без явного указания номеров для управляемых зависимостей.
Какие задачи решает
- настроить безопасное открытие эндпоинтов Actuator
- включить экспорт метрик Micrometer в Prometheus или OTLP
- добавить трассировку OpenTelemetry через Observation API
- организовать структурированное логирование с идентификаторами корреляции
Примеры запросов агенту
- Настрой проверки живучести и готовности контейнера в Actuator для Kubernetes внутри
application.yaml. - Сконфигурируй экспорт метрик Micrometer в Prometheus и включи трассировку через Observation API.
- Добавь идентификаторы сквозной корреляции в структурированные логи Logback.
Как установить spring-observability
1GitHub CLI
gh skill install github/awesome-copilot skills/spring-observability2Вручную: положить файлы
.github/skills/spring-observability/SKILL.md1Через Skills CLI (Vercel)
npx skills add github/awesome-copilot --skill spring-observability -a claude-code2Вручную: положить файлы
~/.claude/skills/spring-observability/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/spring-observability/
1Через Skills CLI (Vercel)
npx skills add github/awesome-copilot --skill spring-observability -a codex2Вручную: положить файлы
.agents/skills/spring-observability/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add github/awesome-copilot --skill spring-observability -a cursor2Вручную: положить файлы
.cursor/skills/spring-observability/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1Через Skills CLI (Vercel)
npx skills add github/awesome-copilot --skill spring-observability -a gemini-cli2Командой платформы
gemini skills install https://github.com/github/awesome-copilot --path skills/spring-observabilityВручную: положить файлы
.devin/skills/spring-observability/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о spring-observability
Как установить spring-observability в GitHub Copilot?
Выполните команду gh skill install github/awesome-copilot skills/spring-observability. Файл скилла сохранится по пути .github/skills/spring-observability/SKILL.md.
Что делает скилл spring-observability?
Он помогает внедрять инструменты мониторинга в Spring Boot 3 и 4, генерируя конфигурации для Actuator, Micrometer, OpenTelemetry и структурированного логирования.
Какие ограничения безопасности соблюдает этот скилл?
Он блокирует чтение секретов из окружения, запрещает открывать дампы памяти и потоков без авторизации, а также требует управлять версиями библиотек через BOM фреймворка.
Исходный текст
SKILL.md · MIT
---
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/>.
© github · MIT · github/awesome-copilot