observability

Implement structured logging and distributed tracing for TypeScript/Node.js microservices with OpenTelemetry.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/aitchwhy/dotfiles --skill observability-aitchwhy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: observability
Source: https://github.com/aitchwhy/dotfiles/tree/main/config/quality/generated/skills/observability
Command: npx skills add https://github.com/aitchwhy/dotfiles --skill observability-aitchwhy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Brings distributed tracing and structured logging to applications.

Core Features & Use Cases

  • OpenTelemetry integration
  • Structured logs and spans
  • OTEL exporter setup

Quick Start

Hook up OTEL Node SDK and emit spans.

Frequently Asked Questions about observability

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

FAQPage Schema
How do I add distributed tracing to my Node.js microservices?

Distributed tracing captures request flows across services using OpenTelemetry. Integrate the OTEL Node SDK, instrument your code with spans using Effect's withSpan, and export traces to an OTLP collector for centralized visibility into latency and errors.

Can I replace console.log with structured logging in TypeScript?

Yes. Effect provides structured logging that replaces console.log with type-safe, context-aware logs. Combined with OpenTelemetry integration, you emit logs with metadata and trace correlation, enabling better searchability and debugging.

What's the best way to set up OpenTelemetry exporters for my application?

Configure the OTEL Node SDK to export spans and metrics to an OTLP-compatible collector. This Skill provides end-to-end setup guidance for Effect-based applications, connecting instrumentation to centralized observability backends.

How do I correlate logs and traces in a microservices architecture?

Structured logging with trace context links logs to spans automatically. Effect's logging layer integrates with OpenTelemetry spans, so each log entry carries trace IDs, enabling you to follow a request through multiple services.

Does OpenTelemetry work with the Effect library?

Yes. Effect provides native support for OpenTelemetry through withSpan for creating nested spans and structured logging. This Skill demonstrates the integration pattern for instrumenting Effect-based TypeScript applications with OTEL.

What observability gaps does structured tracing solve that logging alone cannot?

Tracing captures request flow timing, service dependencies, and span hierarchy across async operations. Structured logging alone lacks this distributed context. Together, they provide complete visibility into performance bottlenecks and failure paths in microservices.