Laravel缓存监控告警需分三步：一、用Debugbar收集器设命中率与慢写入阈值并定时检查；二、直连Redis检测键TTL、内存占用及访问频次；三、集成Stats Tracker采集指标并配置告警阈值与异常白名单。
如果您在 Laravel 应用中发现缓存命中率骤降、缓存写入延迟升高或出现大量缓存穿透现象，则可能是缓存层异常导致性能劣化。以下是配置缓存监控告警规则的具体方法：
一、启用 Debugbar 缓存收集器并设置阈值告警
Debugbar 提供了实时缓存操作追踪能力，通过启用其 cache collector 并结合自定义脚本可实现基础告警逻辑。该方式适用于开发与预发布环境，具备低侵入性和可视化调试优势。
1、确认 config/debugbar.php 中已启用缓存收集器：将 'cache' => true 添加至 'collectors' 数组内。
2、在 'options' 配置块中启用缓存值采集（仅限非生产环境）：设置 'collect_cache_values' => true。
3、创建 Artisan 命令 php artisan make:command CheckCacheMetrics，在 handle() 方法中读取 Debugbar 的缓存统计快照：使用 CacheCollector::getStats() 获取 hits、misses、writes 及 slowest 键信息。
4、设定告警阈值：当 hits / (hits + misses) 0.75 或 slowest 操作耗时 > 300ms 时，触发 Notification::route('mail', config('admin.email'))->notify(new CachePerformanceAlert());。
5、将该命令加入 crontab 每 2 分钟执行一次：添加 */2 * * * * cd /var/www/project && php artisan cache:metrics:check >> /dev/null 2>&1。
二、基于 Redis 直连的缓存键级健康检查告警
绕过应用层中间件，直接访问 Redis 实例获取缓存键 TTL、内存占用及访问频次，可规避 Debugbar 性能开销与采样延迟，适用于高流量生产环境的细粒度监控。
1、确认 Redis 连接参数：从 .env 文件提取 REDIS_HOST、REDIS_PORT、REDIS_PASSWORD，并验证 redis-cli -h $REDIS_HOST -p $REDIS_PORT PING 返回 PONG。
2、编写 shell 脚本检查关键缓存键存活状态：使用 redis-cli -h $REDIS_HOST -p $REDIS_PORT TTL users:summary 获取 TTL 值，若返回 -2 表示键不存在，-1 表示无过期时间。
Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。
3、检测大缓存键内存占用：运行 redis-cli -h $REDIS_HOST -p $REDIS_PORT MEMORY USAGE config.menu，若返回值 > 524288（512KB），则判定为潜在风险键。
4、触发多通道告警：当任一关键键 TTL 60 秒或 MEMORY USAGE 超限时，调用 curl 向钉钉机器人发送含键名与指标值的 JSON 消息。
5、配置 systemd timer 每 45 秒执行一次脚本，避免与业务请求争抢 Redis 连接资源。
三、集成 Laravel Stats Tracker 的自动缓存异常捕获告警
Laravel Stats Tracker 支持对 CacheHit、CacheMissed、KeyWritten 等事件进行埋点监听，并内置异常模式识别引擎，可自动发现缓存雪崩、击穿等典型故障场景。
1、在 composer.json 中引入 laravel-stats-tracker 包并执行 composer install。
2、发布配置文件：运行 php artisan vendor:publish --provider="LaravelStatsTracker\ServiceProvider" --tag=config。
3、编辑 config/stats-tracker.php，在 'monitors' → 'cache' 节点下启用 'enabled' => true，并设置 'alert_thresholds' → 'miss_rate_5m' => 0.9（5 分钟内未命中率超 90% 即告警）。
4、配置异常事件白名单：在 'exceptions' → 'cache' 中添加 Illuminate\Cache\RateLimiting\TooManyRequestsException 和 Illuminate\Contracts\Cache\LockTimeoutException。
5、确保 Stats Tracker 的守护进程正在运行：执行 php artisan stats:watch --daemon，并确认其日志中出现 "Cache monitor started" 标识。
