mcpField
O
observability

observability

github.com/thebeardedbearsasCloud & DevOps108113 installsUpdated 2d ago
Repository

About observability

A skill for engineers working on observability, covering OpenTelemetry instrumentation, metrics, traces, structured logs, and SLI/SLO concepts. It also directs users to invoke `@observability-engineer` for stack-specific instrumentation guidance.

Key features

  1. 01OpenTelemetry instrumentation patterns
  2. 02Metrics, traces, and structured logs
  3. 03Golden Signals and RED/USE metrics
  4. 04SLI, SLO, and SLA concepts

Use cases

  1. 01Planning service instrumentation
  2. 02Correlating logs with distributed traces
  3. 03Defining service-level indicators and objectives

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/thebeardedbearsas/claude-craft --skill observability

After installing, type/observabilityin Claude Code to confirm it loaded.

Details

From the project README

Observability — OpenTelemetry & Distributed Tracing

Instrumentation moderne avec OpenTelemetry pour métriques, traces et logs structurés.

Piliers de l'Observabilité

PilierTechnologiesMétriques clés
MetricsPrometheus, Grafana, DatadogRED (Rate, Errors, Duration), USE (Utilization, Saturation, Errors)
TracesOpenTelemetry, Jaeger, TempoP95 latency, span duration, error rate
LogsLoki, ElasticSearch, DatadogStructured JSON, correlation IDs

OpenTelemetry (OTel) Stack

// Node.js — Auto-instrumentation
const { NodeSDK } = require('@opentelemetry/sdk-node');
const { getNodeAutoInstrumentations } = require('@opentelemetry/auto-instrumentations-node');

const sdk = new NodeSDK({
  traceExporter: new OTLPTraceExporter(),
  instrumentations: [getNodeAutoInstrumentations()],
});

sdk.start();

Golden Signals (Google SRE)

SignalDescriptionSeuil typique
LatencyP50, P95, P99 response timeP95 < 200ms
TrafficRequests per secondBaseline + alerting
ErrorsError rate (5xx, exceptions)< 0.1%
SaturationCPU, Memory, Disk< 80% sustained

Structured Logging (JSON)

{
  "timestamp": "2026-04-17T10:30:00Z",
  "level": "error",
  "message": "Payment processing failed",
  "trace_id": "4bf92f3577b34da6a3ce929d0e0e4736",
  "span_id": "00f067aa0ba902b7",
  "service.name": "payment-api",
  "error.type": "PaymentGatewayTimeout"
}

SLI / SLO / SLA

ConceptExemple
SLI (Indicator)99.5% requests < 200ms
SLO (Objective)99.9% uptime mensuel
SLA (Agreement)99.95% uptime + pénalités

Pour instrumentation détaillée par stack : invoquer @observability-engineer

Comments

Markdown supported