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

monitoring-observability · rohitg00 — скилл для Claude Code

Скилл monitoring-observability для Claude Code добавляет в Node.js-сервис трассировки, метрики, структурированные логи и правила оповещений. Связывает сигналы приложения с дашбордами и SLO.

Apache-2.0 ★ 2 858 обновлён 2026-05-12

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

Что делает monitoring-observability

В примерах есть настройка OpenTelemetry для HTTP и PostgreSQL, пользовательские спаны и метрики для создания заказа, а также сбор метрик Prometheus. Скилл показывает, как записывать длительность запросов и передавать трассировочный ID в логах.

Для логирования используется Pino с маскированием паролей и токенов; для Prometheus приведены конфигурация сбора и правила оповещения о доле ошибок и задержке. Также описаны дашборды с метриками Rate, Errors и Duration и ограничения меток, чтобы их кардинальность оставалась ограниченной. Без настройки экспорта в ваш OpenTelemetry Collector примеры трассировок не будут отправлять данные по указанным адресам.

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

  • добавить трассировки HTTP-запросов и операций PostgreSQL
  • создать спаны и метрики для бизнес-операции
  • собирать длительность запросов через Prometheus
  • записывать структурированные логи с маскированием секретов
  • настроить оповещения по доле ошибок и задержке

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

  • Настрой OpenTelemetry для HTTP и PostgreSQL в моём Node.js-сервисе.
  • Добавь метрики Prometheus для длительности HTTP-запросов и маршрут /metrics.
  • Настрой структурированное логирование запросов с маскированием паролей и токенов.

Как установить monitoring-observability

1Через Skills CLI (Vercel)

npx skills add rohitg00/awesome-claude-code-toolkit --skill monitoring-observability -a claude-code

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

~/.claude/skills/monitoring-observability/SKILL.md

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

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

Вопросы о monitoring-observability

Как установить monitoring-observability в Claude Code?

Выполните npx skills add rohitg00/awesome-claude-code-toolkit --skill monitoring-observability -a claude-code. Файл скилла находится по пути ~/.claude/skills/monitoring-observability/SKILL.md.

Что делает monitoring-observability?

Помогает настроить трассировки и метрики через OpenTelemetry и Prometheus, структурированные логи и оповещения для сервисов.

Какие секреты маскируются в примере логирования?

Пример Pino скрывает req.headers.authorization, password и token. Также скилл советует не помещать идентификаторы пользователей в метки метрик.

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

SKILL.md · Apache-2.0
---
name: monitoring-observability
description: Monitoring and observability with OpenTelemetry, Prometheus, Grafana dashboards, and structured logging
---

# Monitoring & Observability

## OpenTelemetry Setup

```typescript
import { NodeSDK } from "@opentelemetry/sdk-node";
import { OTLPTraceExporter } from "@opentelemetry/exporter-trace-otlp-http";
import { OTLPMetricExporter } from "@opentelemetry/exporter-metrics-otlp-http";
import { HttpInstrumentation } from "@opentelemetry/instrumentation-http";
import { PgInstrumentation } from "@opentelemetry/instrumentation-pg";
import { PeriodicExportingMetricReader } from "@opentelemetry/sdk-metrics";

const sdk = new NodeSDK({
  serviceName: "order-service",
  traceExporter: new OTLPTraceExporter({
    url: "http://otel-collector:4318/v1/traces",
  }),
  metricReader: new PeriodicExportingMetricReader({
    exporter: new OTLPMetricExporter({
      url: "http://otel-collector:4318/v1/metrics",
    }),
    exportIntervalMillis: 15000,
  }),
  instrumentations: [
    new HttpInstrumentation(),
    new PgInstrumentation(),
  ],
});

sdk.start();
process.on("SIGTERM", () => sdk.shutdown());
```

## Custom Spans and Metrics

```typescript
import { trace, metrics, SpanStatusCode } from "@opentelemetry/api";

const tracer = trace.getTracer("order-service");
const meter = metrics.getMeter("order-service");

const orderCounter = meter.createCounter("orders.created", {
  description: "Number of orders created",
});

const orderDuration = meter.createHistogram("orders.processing_duration_ms", {
  description: "Order processing duration in milliseconds",
  unit: "ms",
});

async function createOrder(input: CreateOrderInput) {
  return tracer.startActiveSpan("createOrder", async (span) => {
    try {
      span.setAttributes({
        "order.customer_id": input.customerId,
        "order.item_count": input.items.length,
      });

      const start = performance.now();
      const order = await db.order.create({ data: input });

      orderCounter.add(1, { status: "success" });
      orderDuration.record(performance.now() - start);

      span.setStatus({ code: SpanStatusCode.OK });
      return order;
    } catch (error) {
      span.setStatus({ code: SpanStatusCode.ERROR, message: error.message });
      orderCounter.add(1, { status: "error" });
      throw error;
    } finally {
      span.end();
    }
  });
}
```

## Prometheus Metrics

```yaml
# prometheus.yml
global:
  scrape_interval: 15s

scrape_configs:
  - job_name: "api-servers"
    static_configs:
      - targets: ["api-1:9090", "api-2:9090"]
    metrics_path: /metrics

  - job_name: "node-exporter"
    static_configs:
      - targets: ["node-exporter:9100"]
```

```typescript
import { collectDefaultMetrics, Counter, Histogram, Registry } from "prom-client";

const registry = new Registry();
collectDefaultMetrics({ register: registry });

const httpRequestDuration = new Histogram({
  name: "http_request_duration_seconds",
  help: "HTTP request duration in seconds",
  labelNames: ["method", "route", "status"],
  buckets: [0.01, 0.05, 0.1, 0.5, 1, 5],
  registers: [registry],
});

app.use((req, res, next) => {
  const end = httpRequestDuration.startTimer();
  res.on("finish", () => {
    end({ method: req.method, route: req.route?.path ?? req.path, status: res.statusCode });
  });
  next();
});

app.get("/metrics", async (req, res) => {
  res.set("Content-Type", registry.contentType);
  res.end(await registry.metrics());
});
```

## Structured Logging

```typescript
import pino from "pino";

const logger = pino({
  level: process.env.LOG_LEVEL ?? "info",
  formatters: {
    level: (label) => ({ level: label }),
  },
  redact: ["req.headers.authorization", "password", "token"],
});

function requestLogger(req, res, next) {
  const start = Date.now();
  res.on("finish", () => {
    logger.info({
      method: req.method,
      url: req.url,
      status: res.statusCode,
      duration_ms: Date.now() - start,
      trace_id: req.headers["x-trace-id"],
    });
  });
  next();
}
```

## Alerting Rules

```yaml
groups:
  - name: api-alerts
    rules:
      - alert: HighErrorRate
        expr: rate(http_request_duration_seconds_count{status=~"5.."}[5m]) / rate(http_request_duration_seconds_count[5m]) > 0.05
        for: 5m
        labels:
          severity: critical
        annotations:
          summary: "Error rate above 5% for {{ $labels.route }}"

      - alert: HighLatency
        expr: histogram_quantile(0.99, rate(http_request_duration_seconds_bucket[5m])) > 2
        for: 10m
        labels:
          severity: warning
```

## Anti-Patterns

- Logging sensitive data (passwords, tokens, PII) without redaction
- Using string interpolation in log messages instead of structured fields
- Creating unbounded cardinality in metric labels (e.g., user IDs as labels)
- Not correlating logs and traces with a shared trace ID
- Alerting on symptoms (high CPU) without understanding root cause
- Missing SLO definitions before building dashboards

## Checklist

- [ ] OpenTelemetry SDK initialized with auto-instrumentation for HTTP, DB, and messaging
- [ ] Custom spans added for business-critical operations
- [ ] Metrics use bounded label cardinality
- [ ] Structured logging with JSON output and secret redaction
- [ ] Trace context propagated across service boundaries
- [ ] Alerting rules based on SLOs (error rate, latency percentiles)
- [ ] Dashboards show RED metrics (Rate, Errors, Duration) per service
- [ ] Log retention and rotation policies configured

© rohitg00 · Apache-2.0 · rohitg00/awesome-claude-code-toolkit

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

Все скиллы по теме «DevOps и инфраструктура» →

Сначала — monitoring-observability от других авторов.

monitoring-observability ahmedasmar Скилл monitoring-observability для настройки мониторинга и наблюдаемости: стратегия метрик, алерты, дашборды, SLO и разбор инцидентов. CX Codex +1 504установок monitoring-observability OrchestKit Скилл monitoring-observability для Claude Code настраивает метрики Prometheus, дашборды Grafana и трейсинг Langfuse v4. Включается при добавлении логирования, распределённой трассировки и подсчёта расходов на LLM. CX Codex +1 270установок monitoring-observability akillness Скилл monitoring-observability превращает заметки о сервисе, данных или live-ops в план мониторинга: выбирает режим, сигналы и первый небольшой шаг внедрения. CX Codex +1 371установок monitoring-observability travisjneuman Скилл monitoring-observability помогает внедрить OpenTelemetry, структурированные логи и трейсинг в микросервисах. Он пригодится при настройке алертов по SLO и отладке распределённых систем. CX Codex +1 146установок monitoring-expert https://github.com/Jeffallan Скилл monitoring-expert для Claude Code: настраивает метрики, логи, трейсинг и алерты в сервисе. Выясняет, почему прод тормозит или падает. CX Codex +1 6 200установок implementing-observability ancoleman Скилл implementing-observability для Claude Code настраивает метрики, логи и трейсы через OpenTelemetry и показывает, как запустить Loki, Grafana, Tempo и Mimir у себя. По трейсу ищут ошибки между сервисами. CX Codex +1 1установок setup-monitoring-observability davila7 Команда setup-monitoring-observability настраивает наблюдаемость проекта: метрики, логи, трассировку и оповещения. Укажите нужный тип или запросите полный стек. CX Codex +1 279установок monitoring-specialist davila7 Субагент monitoring-specialist для Claude Code помогает настраивать мониторинг и наблюдаемость. Подключается к задачам со сбором метрик, оповещениями, логами и распределённой трассировкой. CX Codex 1 677установок observability-sre majiayu000 Скилл observability-sre помогает настраивать наблюдаемость, SLO и процессы реагирования на инциденты. Подключайте его при работе с Prometheus, Grafana и OpenTelemetry. CX Codex +1 165установок observability-setup patricio0312rev Скилл observability-setup разворачивает в проекте трейсы OpenTelemetry, метрики Prometheus и структурные логи, добавляя к ним дашборд Grafana и черновики алертов. CX Codex +1 289установок

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

Весь набор →
healthcare-engineer Субагент healthcare-engineer для Claude Code проектирует медицинские сервисы по стандартам HIPAA и HL7 FHIR. Выполняет интеграцию с EHR, маппинг кодов и обезличивание данных пациентов. CX Codex ★ 2 858звёзд репо continuous-learning Скилл continuous-learning для Claude Code фиксирует исправления и удачные решения из сессий и применяет накопленные знания в проекте. Учитывает прошлые правки агента. CX Codex +1 ★ 2 858звёзд репо developer-portal Субагент developer-portal для построения внутренних портальных решений на базе Backstage с каталогом сервисов, шаблонами проектов и самообслуживанием инфраструктуры. Ускоряет поиск сервисов, документации и развёртывание новых проектов. CX Codex ★ 2 858звёзд репо websocket-realtime Скилл websocket-realtime обучает Claude Code архитектуре реального времени: от чистого WebSocket и Socket.io до Server-Sent Events и связки с Redis. CX Codex +1 ★ 2 858звёзд репо database-optimizer Субагент database-optimizer разбирает медленные запросы, строит индексы, настраивает партиционирование и планирует нагрузку для PostgreSQL, MySQL и распределённых баз. CX Codex ★ 2 858звёзд репо accessibility-wcag Скилл accessibility-wcag для Claude Code собирает шаблоны WCAG 2.2 для настройки семантической вёрстки, ARIA-атрибутов, управления с клавиатуры и контрастности. CX Codex +1 ★ 2 858звёзд репо content-strategist Субагент content-strategist планирует SEO-контент, собирает темы в кластеры и помогает связать публикации с метриками. Подходит для технических продуктов и developer-аудитории. CX Codex ★ 2 858звёзд репо authentication-patterns Скилл authentication-patterns для Claude Code содержит паттерны аутентификации и авторизации: JWT, OAuth2 с PKCE, RBAC и middleware. Используйте при разработке защищённого бэкенда. CX Codex +1 ★ 2 858звёзд репо

Ещё в каталоге

market-sizing OrchestKit Скилл market-sizing считает TAM, SAM и SOM двумя методами — top-down и bottom-up — и сверяет их. Запускается при подготовке слайдов для питча или оценке размера рынка. CX Codex +1 124установок stock-historical-index OctagonAI Скилл stock-historical-index для Claude Code и Codex: загружает полную историю дневных цен рыночных индексов через Octagon MCP. Запускается при анализе динамики индекса, расчёте доходности и сравнении акции с рынком. CX Codex +1 259установок contentful-personalization contentful Скилл contentful-personalization помогает настроить, расширить и отладить персонализацию в Contentful. Он пригодится при запуске экспериментов или поиске причины, почему персонализация не работает. CX Codex +1 311установок threejs-skills sickn33 Скилл threejs-skills для создания 3D-сцен, интерактивных опытов и визуальных эффектов на Three.js. Подключите, когда нужно рендерить 3D-графику, WebGL-сцены, анимации или визуализировать данные в трёхмерном пространстве. CX Codex +1 3установок

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

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