ranetrace-laravel

Ranetrace Laravel 是一个 Composer 包，将 Laravel 应用与 Ranetrace 平台集成，以实现全面的 Web 应用监控。它提供四大主要能力：错误追踪、网站分析、集中日志记录以及监控。 错误追踪接入 Laravel 的异常处理器，用于上报未处理的异常并支持手动捕获错误。通过 Blade 指令可实现 JavaScript 错误追踪，能够捕获窗口错误、Promise 拒绝和控制台错误，并附带导航面包屑。事件追踪支持自定义事件及电商购买行为，并采用隐私优先的数据处理方式。 网站分析使用自动注册的中间件来追踪页面访问，并提供广泛的机器人和网络爬虫过滤。无需客户端脚本或 Cookie；访客仅通过加盐单向哈希进行识别。 集中日志记录注册了一个 ranetrace 日志通道，可与现有的 Laravel 日志通道叠加使用，捕获通知级别及以上的日志。 该包附带一个计划的 Artisan 命令（ranetrace:work），用于在本地缓冲捕获到的遥测数据，并以批次方式发送至 Ranetrace。 Ranetrace 托管的 MCP 服务器允许 AI 代理直接从编辑器中调查错误并读取监控判定结果。连接采用 OAuth 授权而非静态令牌，且限制在单个网站范围内。分别支持只读连接和可写连接。 本地诊断面板可通过 /ranetrace 路径访问，用于检查缓冲健康状态、配置状态和管道状态。默认仅允许本地环境访问，可通过 Gate 定义进行扩展。