Where are the log files stored?

By default, logs are stored in a hidden directory within the user's home folder, typically at ~/. /logs/.

Does this skill support log rotation?

Yes, it includes built-in support for rotating logs once they reach a specific size (default 1MB) and retains a configurable number of historical log files.

How do correlation IDs help with debugging?

Correlation IDs allow you to group related log entries across multiple functions or subsystems, making it easy to follow a single operation's lifecycle through a busy log file.

Is this logging skill compatible with MCP servers?

Yes, the skill provides specific implementation patterns for initializing and using loggers within Model Context Protocol (MCP) server environments.

What is JSONL logging?

JSONL (JSON Lines) is a format where each line is a valid JSON object. This makes it ideal for streaming logs and processing them with command-line tools like jq.

Structured Plugin Logging

Name: Structured Plugin Logging
Author: nathanvale

bynathanvale

•

分析と監視

Implements standardized, JSONL-formatted structured logging for SideQuest plugins to simplify debugging and log analysis.

概要

This skill provides a comprehensive framework for implementing high-quality logging in SideQuest plugins using the @sidequest/core/logging factory. It enables developers to create subsystem-specific loggers, manage log rotation automatically, and use correlation IDs to trace operations across complex asynchronous flows. By enforcing a consistent JSONL format, it ensures that plugin logs are easily searchable with tools like jq and ready for production-grade monitoring, helping developers maintain focus by providing clear, structured visibility into their plugin's internal state.

主な機能

Built-in correlation ID support for end-to-end operation tracing
Type-safe template literal syntax for clean and readable logging calls
Standardized JSONL log formatting for easy parsing and analysis
Automatic log rotation and file management to prevent disk bloat
Subsystem-specific loggers for granular debugging and filtering
1 GitHub stars

ユースケース

Debugging complex asynchronous operations in SideQuest plugins
Monitoring production plugin performance and error rates via structured log files
Tracing specific user requests or tool invocations using correlation IDs

概要

主な機能

Built-in correlation ID support for end-to-end operation tracing
Type-safe template literal syntax for clean and readable logging calls
Standardized JSONL log formatting for easy parsing and analysis
Automatic log rotation and file management to prevent disk bloat
Subsystem-specific loggers for granular debugging and filtering
1 GitHub stars

ユースケース

Debugging complex asynchronous operations in SideQuest plugins
Monitoring production plugin performance and error rates via structured log files
Tracing specific user requests or tool invocations using correlation IDs