用途:配置 Laravel Nightwatch 的数据采集,平衡可观测性、性能与隐私,覆盖采样、过滤与脱敏三类设置。官方文档是配置选项的权威来源,本技能提供常见模式与实用指引。
数据流:事件依次经过采样(决定哪些入口点触发完整追踪)、过滤(采样后排除特定事件)、脱敏(保留事件但修改敏感数据)三个阶段。
采样:通过环境变量设置全局采样率,如 NIGHTWATCH_REQUEST_SAMPLE_RATE=0.1、NIGHTWATCH_COMMAND_SAMPLE_RATE=1.0、NIGHTWATCH_EXCEPTION_SAMPLE_RATE=1.0。可用 Sample 中间件按路由设置,如 Sample::rate(1.0)、Sample::always()、Sample::never();也可在运行时用 Nightwatch::sample() 动态采样,或用 Nightwatch::dontSample() 排除特定命令。
过滤:用环境变量或回调排除事件,如 NIGHTWATCH_IGNORE_QUERIES、NIGHTWATCH_IGNORE_CACHE_EVENTS、NIGHTWATCH_IGNORE_MAIL、NIGHTWATCH_IGNORE_NOTIFICATIONS、NIGHTWATCH_IGNORE_OUTGOING_REQUESTS;也可用 rejectQueries、rejectCacheKeys、rejectMail、rejectNotifications、rejectOutgoingRequests、rejectQueuedJobs 等方法按条件过滤。
脱敏:修改已采集数据,如设置 NIGHTWATCH_REDACT_HEADERS、NIGHTWATCH_CAPTURE_REQUEST_PAYLOAD、NIGHTWATCH_REDACT_PAYLOAD_FIELDS,或用 redactRequests、redactQueries、redactCacheEvents、redactCommands、redactExceptions、redactMail、redactOutgoingRequests 等回调处理。
限制:具体环境变量、API 行为与细节以官方文档为准;本技能未提供收费、价格或平台信息。