effect-patterns-observability

Implement structured logging, metrics, and tracing in Effect-TS workflows.

Updated Jan 24, 2026
One-click install
npx skills add https://github.com/scotttrinh/nook --skill effect-patterns-observability-scotttrinh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: effect-patterns-observability
Source: https://github.com/scotttrinh/nook/tree/main/.agents/skills/effect-patterns-observability
Command: npx skills add https://github.com/scotttrinh/nook --skill effect-patterns-observability-scotttrinh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Developers often struggle to implement observable software patterns consistently across Effect-TS codebases, leading to gaps in logging, metrics, and traces.

Core Features & Use Cases

  • Structured logging with Effect.log and levels for context-rich traces.
  • Built-in observability patterns like Effect.fn instrumentation and Effect.withSpan tracing across async workflows.
  • Metrics integration with Effect's Metric primitives to quantify reliability and performance.
  • Use Case: instrumenting a data pipeline to capture step timing, error rates, and user impact.

Quick Start

Install and import Effect-TS, then start applying patterns: wrap functions with Effect.fn to add instrumentation, annotate code with Effect.withSpan around core operations, emit logs with Effect.log, and define metrics via Metric to monitor throughput and latency.

Frequently Asked Questions about effect-patterns-observability

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

FAQPage Schema
How do I add tracing and logging to Effect-TS workflows?

You can implement observability in Effect-TS by wrapping functions with Effect.fn for instrumentation, annotating operations with Effect.withSpan for tracing, and emitting structured logs via Effect.log to capture context-rich execution traces.

How does Effect.withSpan work for tracing async operations?

Effect.withSpan works by annotating specific operations within your Effect-TS workflows to create tracing spans. These spans capture timing and execution context across asynchronous boundaries, enabling detailed performance monitoring and distributed tracing.

What is the best way to measure throughput and latency in Effect-TS?

The best way to measure throughput and latency in Effect-TS is by defining metrics via the Metric API. You can quantify reliability and performance by integrating these Metric primitives directly into your workflows to monitor operational rates.

Can I instrument an Effect-TS data pipeline to capture step timing and error rates?

Yes, you can instrument an Effect-TS data pipeline to capture step timing and error rates by combining Effect.fn instrumentation, Effect.withSpan tracing, and Metric primitives. This allows you to quantify reliability, performance, and user impact.

Do I need external dependencies to implement structured logging in Effect-TS?

No, you do not need external dependencies to implement structured logging in Effect-TS. You can use the built-in Effect.log function and log levels to generate context-rich traces natively within your Effect workflows without additional libraries.