Introduction

Ranetrace is a Laravel package that bundles application monitoring features behind a single installation and a single dashboard. Each feature has its own enable flag, so you can adopt them one at a time.

Features

The package ships these features, each toggleable via an environment variable in config/ranetrace.php:

Feature Config key Default
Error Tracking errors.enabled On
Event Tracking events.enabled On
Centralized Logging logging.enabled Off
Website Analytics website_analytics.enabled Off
JavaScript Errors javascript_errors.enabled Off

How data is sent

Each feature buffers its data in cache (Redis by default — RANETRACE_BATCH_CACHE_DRIVER). A scheduled command, ranetrace:work, picks the buffer up and dispatches batch jobs to your queue. A regular Laravel queue worker processes the jobs and posts the batches to the Ranetrace API.

Two moving parts must be running for data to actually leave your application:

  1. ranetrace:work scheduled to run regularly (every minute is recommended).
  2. A queue worker processing the queue defined by RANETRACE_BATCH_QUEUE_NAME (default: default).

Both are covered in The Worker.

Where to next

  • Installation — install the Laravel package and verify the connection.
  • The Worker — schedule ranetrace:work and run a queue worker.