Installation

Requirements

From the package's composer.json:

• PHP ^8.4
• Laravel 11, 12, or 13

1. Install the package

composer require ranetrace/ranetrace-laravel

The service provider and Ranetrace facade alias are auto-discovered.

2. Add your key to .env

Both are required: RANETRACE_ENABLED is the master switch and defaults to false. RANETRACE_KEY is read by the package to authenticate with the API.

3. Publish the config (optional)

php artisan vendor:publish --tag=ranetrace-config

This creates config/ranetrace.php. The defaults are usable as-is; publish only if you want to customize buffer sizes, queue names, per-feature timeouts, or the lists of ignored JS errors / excluded log channels / excluded analytics paths.

4. Verify the connection

php artisan ranetrace:status

Status output shows which features are enabled, buffer sizes, and any active pauses.

What's enabled by default

Defaults straight from config/ranetrace.php:

Next step

Schedule the worker — without it, buffered data never reaches the API.