configure-nightwatch

This skill helps configure Laravel Nightwatch data collection to balance observability, performance, and privacy. Covers sampling strategies, filtering rules, and redaction methods across all event types.

The Nightwatch Documentation is the definitive and up-to-date source of information for all Nightwatch configuration options. This skill provides practical guidance and common patterns, but always consult the official documentation as the primary source of truth for specific details, environment variables, and API behavior. The documentation includes comprehensive coverage of: • Filtering and Configuration - Core concepts for sampling, filtering, and redaction • Individual event type pages with specific configuration options: • Requests - Request sampling, header handling, payload capture • Commands - Command sampling and redaction • Queries - Query filtering and redaction • Cache - Cache event filtering by key or pattern • Jobs - Job filtering and sampling decoupling • Mail - Mail event filtering • Notifications - Notification filtering by channel • Exceptions - Exception sampling and throttling • Outgoing Requests - HTTP request filtering • reference.md - Quick lookup table by event type, production presets, and verification checklist

Nightwatch processes events through three stages: • Sampling - Controls which entry points are captured (requests, commands, scheduled tasks) • Filtering - Excludes specific events after sampling (queries, cache, mail, etc.) • Redaction - Modifies captured data to remove/obfuscate sensitive information ` Request/Command/Scheduled Task | v [Sampling?] ----NO----> Drop entire trace | YES v Events generated | v [Filtering?] ----YES---> Drop specific event | NO v [Redaction] ----------> Store modified data ` ---

Sampling determines which entry points (requests, commands, scheduled tasks) trigger full trace collection. When an entry point is sampled, all related events are captured.