observability

Implement OpenTelemetry-based observability with metrics, tracing, logging, and SLO alerting.

16|Updated Apr 30, 2026
One-click install
npx skills add https://github.com/JCETools-Petra/JCE-Opencode-Tools --skill observability-jcetools-petra
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: observability
Source: https://github.com/JCETools-Petra/JCE-Opencode-Tools/tree/main/config/skills/observability
Command: npx skills add https://github.com/JCETools-Petra/JCE-Opencode-Tools --skill observability-jcetools-petra

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Observability tooling can be fragmented across logs, metrics, and distributed traces, making it hard to understand incidents and prove system health with evidence.

Core Features & Use Cases

  • OpenTelemetry end-to-end setup: instrumentation, trace/metric/log export, and correlation so request flows can be followed across services.
  • Decision-ready observability workflows: helps you route tasks to the right signal (logs for discrete events, metrics for aggregated measurements, traces for request flow).
  • SLO/SLI-informed alerting guidance: implements alert strategy using burn-rate concepts and enforces runbooks for page-level alerts.
  • Dashboard design with RED/USE: structures dashboards to explain what matters (service health and resource health) using consistent layout principles.
  • Production safety checks: emphasizes avoiding high-cardinality metrics, preventing PII/secrets in logs, and ensuring trace-log correlation.

Quick Start

Ask an AI to design an OpenTelemetry-based observability plan for your Node.js service that exports traces, metrics, and logs, then proposes RED/USE dashboards and SLO burn-rate alert rules with required runbook links.

Frequently Asked Questions about observability

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

FAQPage Schema
How do I set up OpenTelemetry to correlate logs, metrics, and distributed traces?

OpenTelemetry setup requires trace-context propagation across services to correlate logs, metrics, and distributed traces. You must instrument your application to export structured logs and metrics alongside traces, ensuring request flows can be followed end-to-end.

What is the best way to design dashboards using RED and USE principles?

Dashboard design using RED and USE principles structures panels to explain service health and resource health. RED focuses on Rate, Errors, and Duration for services, while USE tracks Utilization, Saturation, and Errors for resources, creating consistent operational visibility.

How do SLO burn-rate alert rules work for incident response?

SLO burn-rate alert rules trigger pages based on the rate at which your error budget is consumed relative to your service level objectives. This approach ensures runbooks are enforced for page-level alerts, prioritizing actionable incidents over raw threshold breaches.

How do I prevent high-cardinality metrics when instrumenting Prometheus?

Preventing high-cardinality metrics in Prometheus requires avoiding unbounded labels like user IDs or request paths in metric definitions. You must design metric labels carefully to prevent explosive time-series growth that degrades database performance and query efficiency.

When should I use logs, metrics, or traces for debugging?

Logs are for discrete events, metrics are for aggregated measurements, and traces are for request flow. Routing tasks to the right signal ensures decision-ready observability workflows, allowing you to query the most efficient data source for your specific debugging context.

How do I ensure trace-log correlation and prevent PII in logs?

Trace-log correlation requires propagating trace context into structured log entries to link them with distributed traces. Production safety checks must be enforced to actively prevent PII and secrets from being exported into logging pipelines.