wide-events-logging

Emit one structured wide event per request at service boundaries.

2|Updated Feb 23, 2026
One-click install
npx skills add https://github.com/jonmumm/skills --skill wide-events-logging
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wide-events-logging
Source: https://github.com/jonmumm/skills/tree/main/wide-events-logging
Command: npx skills add https://github.com/jonmumm/skills --skill wide-events-logging

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Traditional logging scatters contextual data across many statements, making it hard to correlate incidents and understand a complete request path. Wide Events offer a single, highly-dimensional log line per service boundary, consolidating high-cardinality context for efficient querying and incident analysis.

Core Features & Use Cases

  • Canonical log line per request: Emit one structured event at the service boundary containing routing, identity, and outcomes.
  • Context enrichment: Attach user, feature flags, cart, error, and business metrics across the request lifecycle.
  • Intelligent sampling: Prefer tail sampling to preserve critical traces (errors, latency outliers, VIPs) over naive random sampling.
  • Operational guidance: Useful in distributed systems, microservices, and API gateways for end-to-end traceability.

Quick Start

Instrument your app by creating a middleware that initializes a wide event at request start, enriches it throughout processing, and emits one canonical log line at the end.

Frequently Asked Questions about wide-events-logging

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

FAQPage Schema
What is a wide event and how does structured logging with canonical log lines work?

A wide event is a single, highly-dimensional structured log line emitted per request at service boundaries. It consolidates routing, identity, and high-cardinality context into one canonical log line for efficient querying and incident analysis.

How do I consolidate scattered request logs into one structured event per service boundary?

You consolidate request logs by creating middleware that initializes a wide event at request start, enriches it with context like user and feature flags during processing, and emits one canonical log line in a finally block at the end.

When do I need canonical log lines for microservices observability?

You need canonical log lines in distributed systems and microservices when traditional logging scatters context across statements, making it hard to correlate incidents and understand the complete request path across service boundaries.

What's the best way to handle log volume and retain critical traces in distributed systems?

The best way to handle log volume is using tail sampling to decide which wide events to retain. This approach preserves critical traces like errors, latency outliers, and VIP requests over naive random sampling.

Does wide event logging work with high-cardinality context like feature flags and user identity?

Yes, wide event logging specifically supports high-cardinality context. You enrich the event throughout the request lifecycle by attaching user details, feature flags, cart data, errors, and business metrics before emitting the final log line.