observability-and-instrumentation

Instrument application code with structured logging, RED/USE metrics, and distributed tracing.

Updated Jul 31, 2026
One-click install
npx skills add https://github.com/fsolla/teqo --skill observability-and-instrumentation-fsolla
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: observability-and-instrumentation
Source: https://github.com/fsolla/teqo/tree/main/.agents/skills/observability-and-instrumentation
Command: npx skills add https://github.com/fsolla/teqo --skill observability-and-instrumentation-fsolla

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @opentelemetry/sdk-node, @opentelemetry/auto-instrumentations-node, prom-client, and includes references (resource) components.

What problem does it solve?

This skill addresses the challenge of operating software in production by ensuring that code emits the necessary telemetry to diagnose issues, track performance, and understand system behavior without relying on guesswork.

Core Features & Use Cases

  • Structured Logging: Implements JSON-based logging with correlation IDs to ensure logs are queryable and traceable across services.
  • RED/USE Metrics: Provides a framework for tracking Request, Error, and Duration metrics for services, and Utilization, Saturation, and Errors for resources.
  • Distributed Tracing: Guides the integration of OpenTelemetry to visualize request flows across service boundaries.
  • Use Case: When a production incident occurs, this skill ensures you have the structured logs and traces required to identify exactly which service failed and why, rather than manually parsing unstructured text files.

Quick Start

Use the observability-and-instrumentation skill to review my current service logging implementation and suggest improvements for structured event tracking.

Frequently Asked Questions about observability-and-instrumentation

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

FAQPage Schema
How do I implement distributed tracing with OpenTelemetry in a Node.js microservice?

Implement distributed tracing with OpenTelemetry by integrating the Node SDK to visualize request flows across service boundaries, enabling precise diagnosis of which service failed during an incident without manual log parsing.

What is the difference between RED and USE metrics for production monitoring?

RED metrics track Request, Error, and Duration rates for services, while USE metrics track Utilization, Saturation, and Errors for resources. Both are necessary to establish symptom-based alerting and avoid high-cardinality data points.

How do I add correlation IDs to structured JSON logging?

Add correlation IDs to structured JSON logging by propagating trace context across service boundaries, ensuring logs remain queryable and traceable across distributed components during production incident investigations.

Does auto-instrumentation for Node.js support background jobs and standard endpoints?

Auto-instrumentation for Node.js applies to services, endpoints, and background jobs requiring reliable diagnostic evidence. It automatically captures telemetry without needing manual code changes for standard library integrations.

Why should I avoid high-cardinality labels in Prometheus metrics?

Avoid high-cardinality labels in Prometheus metrics to prevent database bloat and query performance degradation. This skill guides tracking RED/USE metrics while maintaining cardinality limits for symptom-based alerting.

What's the best way to review existing service logging for observability improvements?

Review existing service logging by analyzing structured event tracking implementations against RED/USE metrics and distributed tracing requirements, suggesting improvements to ensure reliable diagnostic evidence for production operations.