К основному содержанию
скилл CX Codex

182-java-observability-metrics-micrometer — скилл для Claude Code

Скилл 182-java-observability-metrics-micrometer помогает проектировать и проверять метрики Java-сервисов на Micrometer. Пригодится при добавлении измерений или переработке существующей инструментации.

Apache-2.0 297 установок ★ 465 обновлён 2026-10-21

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add jabrena/plinth --skill 182-java-observability-metrics-micrometer -a claude-code
Открыть на GitHub

Что делает 182-java-observability-metrics-micrometer

Скилл помогает определить метрики сервиса, подобрать тип счётчика и задать имена с тегами. Он охватывает Counter, Timer, Gauge, DistributionSummary и LongTaskTimer, а также настройку гистограмм и перцентилей. Для экспорта рассматриваются Actuator, Prometheus и OpenTelemetry.

Отдельный акцент — на низкой кардинальности: в теги не следует помещать userId, UUID, динамические URL и полные сообщения исключений. Иначе поток временных рядов разрастается и может ухудшить работу систем наблюдаемости. После изменений скилл предлагает проверить регистрацию и значения метрик тестами, а затем запустить ./mvnw clean verify или mvn clean verify.

Какие задачи решает

  • подобрать тип метрики для события, задержки или состояния
  • задать стабильные имена метрик и теги с низкой кардинальностью
  • настроить гистограммы и перцентили для метрик сервиса
  • проверить регистрацию метрик и их значения в тестах

Примеры запросов агенту

  • Добавь метрики Micrometer для задержки и числа ошибок в Java-сервисе.
  • Проверь теги метрик и убери значения с высокой кардинальностью.
  • Настрой гистограммы для метрик и проверь их тестами.

Как установить 182-java-observability-metrics-micrometer

1Через Skills CLI (Vercel)

npx skills add jabrena/plinth --skill 182-java-observability-metrics-micrometer -a claude-code

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

~/.claude/skills/182-java-observability-metrics-micrometer/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/182-java-observability-metrics-micrometer/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о 182-java-observability-metrics-micrometer

Как установить 182-java-observability-metrics-micrometer в Claude Code?

Выполните npx skills add jabrena/plinth --skill 182-java-observability-metrics-micrometer -a claude-code. Файл скилла находится по пути ~/.claude/skills/182-java-observability-metrics-micrometer/SKILL.md.

Что делает 182-java-observability-metrics-micrometer?

Помогает внедрять метрики Micrometer в Java-сервисы: выбирать типы измерений, задавать имена и теги, контролировать кардинальность и проверять результат.

Какие значения нельзя использовать в тегах метрик?

Скилл предостерегает от неограниченных значений, например userId, UUID, полного URL и полного текста исключения: они могут резко увеличить число временных рядов.

Исходный текст

SKILL.md · Apache-2.0
---
name: 182-java-observability-metrics-micrometer
description: Use when you need to implement or improve Java metrics observability with Micrometer — including meter design, naming/tag conventions, cardinality control, timers/counters/gauges/distribution summaries, percentiles/histograms, Actuator/Prometheus integration, and metrics validation through tests. This should trigger for requests such as Improve metrics; Apply Micrometer; Add metrics observability; Refactor Micrometer instrumentation; Add Micrometer timers counters or gauges to Java services. Part of Plinth Toolkit
license: Apache-2.0
metadata:
  author: Juan Antonio Breña Moral
  version: 0.19.0
---
# Java Metrics Observability with Micrometer

Implement effective Java metrics instrumentation with Micrometer by defining meaningful service-level metrics, controlling cardinality, selecting the right meter type, and exposing production-ready telemetry for dashboards and alerting.

**What is covered in this Skill?**

- Metrics-first observability with Micrometer in Java applications
- Meter selection: Counter, Timer, DistributionSummary, Gauge, LongTaskTimer
- Naming and tagging conventions with low-cardinality dimensions
- Cardinality and meter lifecycle safeguards to prevent time-series explosion
- Histogram/percentile strategy and SLO-oriented metrics design
- Integration guidance for Actuator + Prometheus/OpenTelemetry pipelines
- Testing and verification of metrics registration and values

**Scope:** Application-level metrics design and instrumentation quality for Java services, with emphasis on operationally useful and cost-efficient telemetry.

## Constraints

Metrics instrumentation must be operationally safe, low-cardinality, and validated. Poor tag design or excessive meter creation can degrade observability systems and increase costs.

- **LOW CARDINALITY FIRST**: Never tag metrics with unbounded values (userId, UUID, raw URL, full exception message)
- **RIGHT METER TYPE**: Use Counter for monotonically increasing events, Timer for latency, Gauge for point-in-time state, and DistributionSummary for sampled values
- **BEFORE APPLYING**: Read the reference for good/bad instrumentation examples and anti-patterns
- **VERIFY**: Run `./mvnw clean verify` or `mvn clean verify` after changes

## When to use this skill

- Improve metrics
- Apply Micrometer
- Add metrics observability
- Refactor Micrometer instrumentation
- Add Micrometer timers counters or gauges to Java services

## Workflow

1. **Define measurement goals and meter contract**

Identify key service indicators (throughput, latency, error ratio, saturation) and map each to stable metric names, units, and low-cardinality tags.

2. **Select meter types and instrument code paths**

Apply Counter/Timer/Gauge/DistributionSummary/LongTaskTimer where appropriate, ensuring consistent naming conventions and reusable tags.

3. **Harden instrumentation for production**

Control cardinality, avoid dynamic meter churn, configure histogram/percentile strategy only where needed, and align export settings with the telemetry backend.

4. **Validate and operationalize metrics**

Verify metrics in tests and runtime endpoints, confirm expected labels/units, and ensure dashboards/alerts can consume the emitted series.

## Reference

For detailed guidance, examples, and constraints, see [references/182-java-observability-metrics-micrometer.md](references/182-java-observability-metrics-micrometer.md).

© Juan Antonio Breña Moral · Apache-2.0 · jabrena/plinth

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

Все скиллы по теме «DevOps и инфраструктура» →
golang-observability samber Скилл golang-observability для Claude Code: инструментирует Go-сервисы логами, метриками, трейсами, профилированием и RUM. Накрывает прод наблюдаемостью по пяти сигналам. CX Codex +1 42 300установок python-observability Seth Hobson Скилл python-observability для Claude Code: настраивает структурные логи, метрики Prometheus и распределённый трейсинг в Python-проектах. Помогает разобраться в проблемах боевых систем через корреляцию логов, метрик и трейсов. CX Codex +1 11 547установок golang-observability-opentelemetry Claude MPM Team Скилл golang-observability-opentelemetry для Claude Code, Codex, Cursor и других платформ, который обучает агента инструментировать Go-сервисы через OpenTelemetry, Prometheus и slog. CX Codex +1 430установок java-add-graalvm-native-image-support официальный github Скилл java-add-graalvm-native-image-support для GitHub Copilot добавляет GraalVM Native Image в Java-проект, собирает исполняемый файл и помогает разбирать ошибки сборки. Запускает приложение без JVM. CX Codex +1 8 700установок java-maven pluginagentmarketplace Скилл java-maven помогает настраивать pom.xml и управлять зависимостями через BOM в проектах на Apache Maven. CX Codex +1 917установок java-performance pluginagentmarketplace Скилл java-performance для настройки JVM: подбор сборщика мусора, профилирование CPU, разбор утечек памяти и бенчмарки на JMH. CX Codex +1 490установок

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

Весь набор →
043-planning-github-issues Скилл 043-planning-github-issues помогает настроить GitHub CLI и выстроить трассировку задач по документам в репозитории без загрузки текста issue в контекст модели. CX Codex +1 312установок 126-java-exception-handling Скилл 126-java-exception-handling для Claude Code помогает применять правила обработки исключений в Java. Подключается к запросам на проверку типов исключений, ресурсов и передачи ошибок. CX Codex +1 307установок 703-technologies-fuzzing-testing Скилл 703-technologies-fuzzing-testing для Claude Code настраивает fuzz-тестирование Java API с CATS по OpenAPI-контракту и проверяет некорректные данные и граничные значения. CX Codex +1 304установок 314-frameworks-spring-kafka Скилл 314-frameworks-spring-kafka настраивает обмен сообщениями Kafka в Spring Boot: продюсеры, консьюмеры, DLT и тесты с Testcontainers. CX Codex +1 297установок 403-frameworks-quarkus-validation Скилл 403-frameworks-quarkus-validation помогает добавлять и проверять валидацию Quarkus: от DTO и REST-ресурсов до настроек и обработки ошибок. CX Codex +1 296установок 404-frameworks-quarkus-security Скилл 404-frameworks-quarkus-security помогает проектировать и проверять безопасность приложений Quarkus: настраивать аутентификацию, права доступа и защиту логов. CX Codex +1 294установок 315-frameworks-spring-mongodb Скилл 315-frameworks-spring-mongodb для проектирования и реализации доступа к MongoDB в Spring Boot. Помогает с моделированием документов, репозиториями, индексами, оптимистичными блокировками и обработкой ошибок. CX Codex +1 284установок 504-frameworks-micronaut-security Скилл 504-frameworks-micronaut-security помогает проектировать и проверять безопасность Micronaut-приложений: аутентификацию, права доступа, JWT, CORS и защиту данных в логах. CX Codex +1 282установок

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

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