К основному содержанию
скилл CX Codex официальный · GitHub

spring-observability — скилл для GitHub Copilot: как установить

Скилл spring-observability для GitHub Copilot настраивает наблюдаемость в сервисах на Spring Boot 3 и 4. Включается при добавлении метрик Micrometer, трассировки OpenTelemetry и структурированных логов с Actuator.

MIT ★ 41 430 обновлён 2026-10-23

Установить в GitHub Copilot · GitHub CLI Все способы и платформы ↓
gh skill install github/awesome-copilot skills/spring-observability
Открыть на GitHub

Что делает 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-observability

2Вручную: положить файлы

.github/skills/spring-observability/SKILL.md

По шагам, с командами для каждой платформы: Как установить скилл в 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

Похожие скиллы

Все скиллы по теме «Бэкенд и API» →
spring-boot-actuator giuseppe-trisciuoglio Скилл помогает настроить Spring Boot Actuator: добавить пробы жизнеспособности для оркестраторов, защитить служебные эндпоинты и экспортировать метрики Micrometer в Prometheus. CX Codex +1 4 000установок java-spring-boot pluginagentmarketplace Скилл java-spring-boot помогает создавать бэкенд на Spring Boot 3: настраивать REST API, аутентификацию через Spring Security, доступ к базам через Spring Data и мониторинг Actuator. CX Codex +1 11 800установок spring-boot-resilience4j giuseppe-trisciuoglio Скилл spring-boot-resilience4j добавляет паттерны отказоустойчивости Resilience4j в Spring Boot 3.x. Он помогает настроить размыкатели цепи и повторные вызовы при сбоях внешних сервисов. CX Codex +1 4 000установок observability-and-instrumentation addyosmani Скилл observability-and-instrumentation для Claude Code учит ИИ добавлять в код логи, метрики, трейсинг и корреляционные ID. Включается при добавлении фич в продакшн для наблюдения за поведением системы. CX Codex +1 70 700установок golang-observability samber Скилл golang-observability для Claude Code: инструментирует Go-сервисы логами, метриками, трейсами, профилированием и RUM. Накрывает прод наблюдаемостью по пяти сигналам. CX Codex +1 42 300установок observability-guidelines Mindrally Скилл observability-guidelines учит агента внедрять OpenTelemetry, трассировку и структурированные логи в распределённые сервисы. Пригодится при настройке мониторинга и метрик. CX Codex +1 826установок

Из того же набора993

Весь набор →
java-testcontainers Скилл java-testcontainers помогает писать интеграционные тесты на Java с Testcontainers 2.x и JUnit Jupiter, поднимая базы данных и очереди в Docker. Пригодится при настройке тестов или миграции с ветки 1.x. CX Codex +1 1установок java-debugging Скилл java-debugging для GitHub Copilot ведёт агента по методике поиска причины бага в Java: воспроизвести, сузить, проверить гипотезу, подключить отладчик. Использует логи и логпоинты вместо брейкпоинтов. CX Codex +1 1установок supabase-rls-policies Скилл supabase-rls-policies для GitHub Copilot помогает писать, проверять и тестировать политики Row Level Security в Supabase. Запускается при создании таблиц, правке миграций и настройке изоляции пользователей. CX Codex +1 ★ 41 430звёзд репо spring-security Помогает настраивать, тестировать и проверять Spring Security. Подключается при добавлении или аудите аутентификации и авторизации в приложении Spring Boot. CX Codex +1 ★ 41 430звёзд репо spring-boot-4-migration Скилл spring-boot-4-migration для GitHub Copilot переносит приложение со Spring Boot 3.x на 4.0. Запускается для миграции, разбора вызванных ею ошибок сборки и тестов или проверки уже выполненного перехода. CX Codex +1 ★ 41 430звёзд репо skill-distribution-audit Скилл skill-distribution-audit для GitHub Copilot проверяет репозитории со скиллами перед релизом. Сверяет исходные файлы с манифестом дистрибуции и реальной поисковой выдачей клиента. CX Codex +1 ★ 41 430звёзд репо scout-issue Скилл scout-issue для GitHub Copilot подбирает GitHub issues для вклада в открытые проекты. Он спрашивает об опыте, навыках, времени и типе вклада, затем ранжирует подходящие задачи. CX Codex +1 ★ 41 430звёзд репо sap-cloud-integration Помогает писать и разбирать iFlow в SAP Cloud Integration. Срабатывает при работе с CPI-скриптами Groovy, настройками обмена и ошибками адаптеров. CX Codex +1 ★ 41 430звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой