What log levels are supported?

It follows standard production conventions supporting DEBUG for diagnostics, INFO for milestones, WARN for degraded operations, and ERROR for failures.

Where are the logs stored by default?

Logs are typically stored in the ~/.claude/logs/ directory, named after the specific plugin, ensuring that diagnostic data is persisted outside of the immediate console output.

How do correlation IDs improve debugging in Claude Code?

Correlation IDs allow you to link related log entries across multiple subsystems, making it simple to trace the entire lifecycle of a specific operation using a single grep command.

Can I generate performance reports automatically?

Yes, the skill includes a MetricsCollector that parses JSONL logs to generate Markdown summaries of operation counts, success rates, and average durations.

What logging format does this skill use?

This skill utilizes JSONL (newline-delimited JSON) via the LogTape library, which allows for efficient file rotation and easy programmatic analysis with tools like jq.

Observability & Structured Logging

Name: Observability & Structured Logging
Author: nathanvale

bynathanvale

•

분석 및 모니터링

Implements production-grade structured logging, correlation IDs, and performance metrics for Bun-based Claude Code plugins.

The Observability skill provides a standardized framework for logging and monitoring within the SideQuest ecosystem. By utilizing LogTape and JSONL formatting, it enables developers to implement hierarchical logging categories, trace complex operations via correlation IDs, and automatically aggregate performance metrics. This skill is essential for developers who need to move beyond simple console logs to a machine-parsable, searchable observability stack that simplifies debugging production issues and optimizing application performance.

주요 기능

01Standardized Correlation ID patterns for end-to-end request tracing

02Structured JSONL logging with automatic file rotation and management

03Automated performance metrics collection with Markdown summary generation

041 GitHub stars

05Hierarchical subsystem categories for granular log level control

06Optimized debugging workflows tailored for grep and jq analysis

사용 사례

01Implementing machine-readable audit trails for high-stakes tool executions

02Tracing complex multi-step operations across different plugin subsystems

03Analyzing production performance bottlenecks using automated metrics

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add nathanvale/side-quest-marketplace observability

For use in Claude.ai and ChatGPT

Download Skill