182-java-observability-metrics-micrometer — скилл для Claude Code
Скилл 182-java-observability-metrics-micrometer помогает проектировать и проверять метрики Java-сервисов на Micrometer. Пригодится при добавлении измерений или переработке существующей инструментации.
Apache-2.0 297 установок ★ 465 обновлён 2026-10-21
npx skills add jabrena/plinth --skill 182-java-observability-metrics-micrometer -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/182-java-observability-metrics-micrometer/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/182-java-observability-metrics-micrometer/
1Через Skills CLI (Vercel)
npx skills add jabrena/plinth --skill 182-java-observability-metrics-micrometer -a codex2Вручную: положить файлы
.agents/skills/182-java-observability-metrics-micrometer/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add jabrena/plinth --skill 182-java-observability-metrics-micrometer -a cursor2Вручную: положить файлы
.cursor/skills/182-java-observability-metrics-micrometer/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install jabrena/plinth skills/182-java-observability-metrics-micrometer2Вручную: положить файлы
.github/skills/182-java-observability-metrics-micrometer/SKILL.md1Через Skills CLI (Vercel)
npx skills add jabrena/plinth --skill 182-java-observability-metrics-micrometer -a gemini-cli2Командой платформы
gemini skills install https://github.com/jabrena/plinth --path skills/182-java-observability-metrics-micrometerВручную: положить файлы
.devin/skills/182-java-observability-metrics-micrometer/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add jabrena/plinth --skill 182-java-observability-metrics-micrometer -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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