README

Laravel package for sending errors to Xiloryx Log — real-time error monitoring for Laravel applications.

Installation

composer require xiloryx/log-collector

That's it. The package auto-registers itself via Laravel's package discovery.

Configuration

1. Add your API key

Add the following to your .env file:

XILORYX_LOG_API_KEY=your_project_api_key_here

You can find your API key in your project settings on log.xiloryx.fr.

2. (Optional) Publish the config file

php artisan vendor:publish --tag=xiloryx-log-config

This gives you access to the full config at config/xiloryx-log.php.

Available environment variables

Features

Error reporting

All unhandled exceptions are automatically captured and sent to your dashboard — no code changes required. The package hooks into Laravel's exception handler on boot.

Each error includes:

• Exception message, file, and line
• Full stack trace
• Request URL, method, and IP
• Authenticated user ID (if available)
• PHP version and environment

Project Health (premium)

When XILORYX_LOG_HEARTBEAT=true, the package tracks your total request count using a local cache buffer. Requests are batched and sent to Xiloryx Log every 100 hits — zero performance impact on your app.

This powers the Project Health dashboard: total requests, total errors, and error rate over 30 days.

Silent by design

The package will never throw an exception or slow down your application:

• All HTTP calls to Xiloryx Log have a 2-second timeout
• Every failure is caught and silently ignored
• Heartbeat runs in the terminate() phase, after the response is sent

Requirements

• PHP 8.1 or higher
• Laravel 10, 11, or 12
• Guzzle HTTP client (included with Laravel)

Support

For support: contact@xiloryx.com