About this project

Ranetrace Laravel is a composer package that integrates Laravel applications with the Ranetrace platform for comprehensive web application monitoring. It provides four main capabilities: error tracking, website analytics, centralized logging, and monitoring. Error Tracking wires into Laravel's exception handler to report unhandled exceptions and supports manual error capture. JavaScript error tracking is available via a Blade directive that captures window errors, promise rejections, and console errors with navigation breadcrumbs. Event tracking supports custom events and e-commerce purchases with privacy-first data handling. Website Analytics uses an automatically registered middleware to track page visits with extensive bot and crawler filtering. No client-side scripts or cookies are required; visitors are identified only by salted one-way hashes. Centralized Logging registers a ranetrace log channel that can be stacked alongside existing Laravel log channels, capturing notices and above. The package ships with a scheduled artisan command (ranetrace:work) that buffers captured telemetry locally and sends it in batches to Ranetrace. An MCP server hosted by Ranetrace allows AI agents to investigate errors and read monitor verdicts directly from the editor. Connections use OAuth approval rather than static tokens, and are scoped to a single website. Read-only and write-capable connections are supported separately. A local diagnostics dashboard is available at /ranetrace for inspecting buffer health, configuration status, and pipeline state. Access is restricted to local environments by default and can be extended via a Gate definition.