README

Scollio Logger is a Laravel 11-compatible HTTP traffic and exception logger that automatically records incoming requests, responses, and exceptions — complete with a beautiful AJAX-powered dashboard, configurable middleware control, and automatic log rotation.

Package: kz370/scollio-logger

📚 Table of Contents

• Features
• Requirements
• Installation
• Publishing Assets
• Configuration
• Environment Variables Reference
• Middleware
• Request Logging
• Dashboard
• Log Rotation
• Table Schema
• Screenshots
• Troubleshooting
• License

🚀 Features

• 🧠 Automatic request, response, and exception logging
• 💾 Database-backed log storage (scollio_logger table)
• 🖥️ AJAX-powered dashboard with filters and pagination
• 🔐 Middleware alias + optional global registration
• ⚙️ Configurable exclusions, key filtering, and rotation
• 📅 Log retention and automatic cleanup via command
• 🧩 Modular configuration compatible with Laravel 11

🧩 Requirements

📦 Installation

composer require kz370/scollio-logger

Then publish assets and run migrations:

php artisan vendor:publish --tag=scollio-logger-config
php artisan vendor:publish --tag=scollio-logger-migrations
php artisan vendor:publish --tag=scollio-logger-views
php artisan migrate

Once installed, Scollio Logger automatically registers its routes, views, and middleware.

🛠 Publishing Assets

⚙️ Configuration

All configuration values are found in config/scollio-logger.php and can be overridden using .env variables.

Example Core Config

return [
    'enabled' => env('SCOLLIO_ENABLED', true),

    'dashboard' => [
        'enabled' => env('SCOLLIO_LOGGER_DASHBOARD_ENABLED', true),
        'route' => env('SCOLLIO_LOGGER_DASHBOARD_ROUTE', 'scollio-logs/dashboard'),
        'prefix' => 'scollio-logs',
        'middleware' => ['auth:sanctum', 'web'],
        'pagination' => env('SCOLLIO_LOGGER_DASHBOARD_PAGINATION', 25),
    ],

    'middleware' => [
        'global' => env('SCOLLIO_LOGGER_MIDDLEWARE_GLOBAL', true),
    ],

    'paginate' => env('SCOLLIO_PAGINATE', 15),
    'log_web_routes' => env('SCOLLIO_LOG_WEB_ROUTES', true),
    'log_api_routes' => env('SCOLLIO_LOG_API_ROUTES', true),

    'ignore_status_codes' => array_filter(array_map('intval', explode(',', env('SCOLLIO_IGNORE_STATUS_CODES', '302,304,419,429')))),
    'only_status_codes' => array_filter(array_map('intval', explode(',', env('SCOLLIO_ONLY_STATUS_CODES', '')))),

    'retention_days' => env('SCOLLIO_RETENTION_DAYS', 30),
    'rotation_every_minutes' => env('SCOLLIO_ROTATION_EVERY_MINUTES', 1440),
];

⚙️ Environment Variables Reference

✅ Example .env

SCOLLIO_ENABLED=true
SCOLLIO_PAGINATE=15

# Dashboard
SCOLLIO_LOGGER_DASHBOARD_ENABLED=true
SCOLLIO_LOGGER_DASHBOARD_ROUTE=scollio-logs/dashboard
SCOLLIO_LOGGER_DASHBOARD_PAGINATION=25
SCOLLIO_LOGGER_MIDDLEWARE_GLOBAL=true

# Route Logging
SCOLLIO_LOG_WEB_ROUTES=true
SCOLLIO_LOG_API_ROUTES=true
SCOLLIO_IGNORE_STATUS_CODES=302,304,419,429
SCOLLIO_ONLY_STATUS_CODES=

# Rotation & Retention
SCOLLIO_RETENTION_DAYS=30
SCOLLIO_ROTATION_EVERY_MINUTES=1440

🧱 Middleware

Scollio Logger provides both a route middleware alias and an optional global middleware registration.

Example Usage:

Route::middleware(['web', 'scollio-logger'])->group(function () {
    Route::get('/dashboard', [DashboardController::class, 'index']);
});

🛰️ Request Logging

When enabled, Scollio captures each request and response with metadata such as method, URL, status code, controller, and duration.

Example Log Entry:

{
  "method": "GET",
  "url": "https://example.com/api/users/5",
  "status_code": 200,
  "duration_ms": 152,
  "controller_action": "App\\Http\\Controllers\\UserController@show"
}

🚦 Dashboard

Visit your dashboard at:

/scollio-logs/dashboard

Dashboard Features

• Live AJAX search and filtering
• Filter by method, status, or message
• View full request and response payloads
• View exception details and traces
• Delete individual or all logs
• Auto-refresh every few seconds
• Protected by configurable middleware

🧹 Log Rotation

Scollio includes an Artisan command for automatic cleanup:

php artisan scollio:rotate

This deletes logs older than the configured retention period.

SCOLLIO_RETENTION_DAYS=30
SCOLLIO_ROTATION_EVERY_MINUTES=1440

📄 Table Schema

Table name: scollio_logger

🖼️ Screenshots

🧩 Troubleshooting

📜 License

Released under the MIT License.

🧩 Scollio Logger — Smart, structured, and searchable HTTP and exception logging for Laravel.