wide-event-observability

Emit one structured wide-event per HTTP request for Express/Node.js observability.

Updated Dec 29, 2025
One-click install
npx skills add https://github.com/jayteealao/Aperture --skill wide-event-observability
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wide-event-observability
Source: https://github.com/jayteealao/Aperture/tree/main/.claude/skills/wide-event-observability
Command: npx skills add https://github.com/jayteealao/Aperture --skill wide-event-observability

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a canonical, queryable wide-event for per-request observability by emitting a single structured event per HTTP request that consolidates technical and business context.

Core Features & Use Cases

  • One wide event per request containing correlation IDs, service context, user data, feature flags, and domain-specific context (e.g., cart, payment, order).
  • Tail sampling rules ensure critical signals (errors, slow requests, VIPs, flagged traffic) are always kept while reducing log noise.
  • Use cases include debugging production incidents, replacing scattered logs with canonical events, and cross-service tracing.

Quick Start

Enable the wide-event middleware in your Express app to emit a canonical event for a sample request.

Frequently Asked Questions about wide-event-observability

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

FAQPage Schema
How do I consolidate Express request logs into a single structured event?

You can consolidate Express request logs into a single structured event by using middleware that emits one wide event per request, capturing technical, user, and domain-specific context like cart and payment data.

What is tail sampling in Node.js observability and when do I need it?

Tail sampling in Node.js observability evaluates completed requests to retain critical signals like errors, slow requests, and VIP traffic while dropping noisy logs. You need it to reduce log volume without losing important debugging context.

How do I add correlation IDs and feature flags to Node.js structured logging?

To add correlation IDs and feature flags to Node.js structured logging, you enrich a canonical wide event through middleware and route handlers, ensuring stable schema inclusion of user data and feature-flag context for cross-service tracing.

Can I redact sensitive data in per-request observability events for Express?

Yes, you can redact sensitive data in per-request observability events for Express. The wide-event implementation enforces data redaction rules to ensure canonical structured events remain safe for querying and debugging production.

What is the best way to debug production incidents in Node.js microservices?

The best way to debug production incidents in Node.js microservices is replacing scattered logs with canonical wide events. This provides a queryable, consolidated view of technical and business context per request, enabling cross-service tracing.

Does wide event observability work without external dependencies in Node.js?

Yes, wide event observability works without external dependencies in Node.js. The skill provides middleware and route handler instrumentation to emit structured events directly, requiring no additional libraries to establish the canonical schema.