forge-observability

Standardize production observability with correlated traces, metrics, and logs.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/f4rkh4d/forge-skill --skill forge-observability
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: forge-observability
Source: https://github.com/f4rkh4d/forge-skill/tree/main/skills/infra/forge-observability
Command: npx skills add https://github.com/f4rkh4d/forge-skill --skill forge-observability

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Forge-observability prevents “it broke at 3am” situations by ensuring traces, metrics, and logs are correlated and actionable in real production environments.

Core Features & Use Cases

  • Trace/metrics/log correlation: Enforces consistent IDs (trace_id) across spans, log lines, and error responses so incidents are diagnosable end-to-end.
  • OpenTelemetry-first setup: Provides a production-ready OTel SDK initialization approach and span discipline that uses semantic conventions.
  • SLO-driven alerting and cost control: Guides RED/USE metrics selection, sampling strategy, burn-rate SLO alert design, and runbook-required pageability.

Quick Start

Ask your agent to add OpenTelemetry tracing, metrics, and correlated structured logs to your service and implement SLO burn-rate alerts with low-cardinality metric dimensions.

Frequently Asked Questions about forge-observability

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I correlate traces, metrics, and logs for OpenTelemetry API observability?

You correlate traces, metrics, and logs by enforcing a consistent trace_id across spans, structured log lines, and error responses. This correlation ensures incidents are diagnosable end-to-end across request-driven APIs.

What is the best way to design SLO burn-rate alerts that reduce alert fatigue?

Designing SLO burn-rate alerts involves calculating burn rates to page on user pain rather than raw thresholds. This approach requires attaching runbooks to alerts to ensure quick diagnosis and reduce false positives.

How do I set up OpenTelemetry SDK span naming and semantic conventions?

Setting up the OpenTelemetry SDK requires operation-based span naming and adherence to semantic conventions. You must record exceptions directly on spans and propagate trace_id across environments to maintain disciplined observability.

What RED and USE metrics should I implement for production service auditing?

When auditing a production service, implement RED metrics for request-driven APIs and USE metrics for resources. Selecting these metrics with low-cardinality dimensions ensures you capture user pain and resource saturation accurately.

Do I need environment-specific sampling for OpenTelemetry observability?

Yes, you need environment-specific sampling for OpenTelemetry observability to control costs and data volume. Configuring sampling per environment allows you to capture high-fidelity traces in production while reducing overhead in development.