README

📜 Laravel Log Tracker

Laravel Log Tracker is a powerful, user-friendly package for tracking, analyzing, and managing application logs effortlessly. It provides a real-time dashboard with filtering, insights, and visualization of your log files.

🏢 Proudly Supported by Business Automation Ltd

This open-source package is maintained by Sadi and supported by Business Automation Ltd
Building enterprise-grade e-governance and automation solutions across Bangladesh

🚀 Key Features

✅ Interactive Dashboard – Comprehensive log analytics with charts and real-time insights
✅ Dual Theme System – Choose between LiteFlow (minimal) and GlowStack (modern) themes
✅ Zero-Dependency Exports – Export logs in CSV, Excel, PDF, JSON without external libraries
✅ Error Pattern Analysis – Identify top error types and peak error hours
✅ Advanced Filtering – Filter logs by level, date range, or custom keywords
✅ Log File Management – View, download, delete, and manage log files effortlessly
✅ Smart File Pagination – Efficiently handle large numbers of log files with pagination
✅ Dynamic Log Levels – Laravel log levels with dynamic colors and icons
✅ Max File Size Protection – Intelligent file size checking to prevent memory issues
✅ Real-time Statistics – Live log counts and performance metrics
✅ Stack Trace Viewer – Detailed error stack traces with syntax highlighting
✅ Responsive Design – Works perfectly on desktop, tablet, and mobile devices
✅ Customizable Configuration – Tailor log levels, colors, icons, and behavior to your needs
✅ Performance Optimized – Handles large log files efficiently with enhanced pagination ✅ Secure Access – Built-in authentication and authorization middleware

Installation
Configuration
Usage
Themes
Author

🖥️ System Requirements

Supported PHP and Laravel Versions

Laravel Version	Supported PHP Versions
12.x	8.1 - 8.4
11.x	8.1 - 8.3
10.x	8.0 - 8.2
9.x	8.0 - 8.1
8.x	7.3 - 8.0
7.x	7.2 - 7.4
6.x	7.2 - 7.4
5.8	7.1 - 7.3
5.7	7.1 - 7.2
5.6	7.0 - 7.2
5.5	7.0 - 7.2

✅ Checked Versions

Laravel Version	PHP Version	Status
12.x	8.2, 8.4	✅ Working
11.x	8.2, 8.3	✅ Working
10.x	8.1, 8.2	✅ Working
9.x	8.0, 8.1	⚠️ Not Tested
8.x	7.4, 8.0	⚠️ Not Tested

Note: If you encounter issues with a specific version, feel free to report them in the issues section.

Installation

Install the package via Composer:
```
composer require kssadi/log-tracker
```
Publish the configuration file:
```
php artisan vendor:publish --provider="Kssadi\LogTracker\LogTrackerServiceProvider" --tag="config"
```
This will publish the log-tracker.php configuration file to your config directory.

Configuration

Basic Configuration

After publishing the config, customize your config/log-tracker.php file:

<?php

return [
    /*
    |--------------------------------------------------------------------------
    | Route Configuration
    |--------------------------------------------------------------------------
    */
    'route_prefix' => 'log-tracker',
    'middleware' => ['web', 'auth'],

    /*
    |--------------------------------------------------------------------------
    | Theme Selection
    |--------------------------------------------------------------------------
    */
    'theme' => 'GlowStack', // Options: 'LiteFlow', 'GlowStack'

    /*
    |--------------------------------------------------------------------------
    | Display Settings
    |--------------------------------------------------------------------------
    */
    'log_per_page' => 50,
    'log_files_per_page' => 10,
    'max_file_size' => 50, // MB

    /*
    |--------------------------------------------------------------------------
    | Feature Permissions
    |--------------------------------------------------------------------------
    */
    'allow_delete' => true,
    'allow_download' => true,

    /*
    |--------------------------------------------------------------------------
    | Export Configuration
    |--------------------------------------------------------------------------
    */
    'export' => [
        'enabled' => true,
        'formats' => [
            'csv' => [
                'enabled' => true,
                'description' => 'Excel-compatible CSV format'
            ],
            'json' => [
                'enabled' => true,
                'description' => 'Structured JSON with metadata'
            ],
            'excel' => [
                'enabled' => true,
                'description' => 'Native Excel XML format'
            ],
            'pdf' => [
                'enabled' => true,
                'description' => 'Print-ready HTML report'
            ],
        ],
        'limits' => [
            'max_entries' => 50000,
            'max_file_size_mb' => 50,
            'timeout_seconds' => 300,
        ],
        'storage' => [
            'cleanup_after_days' => 7,
        ],
    ],
];

Environment Configuration

Add the following environment variables to your .env file:

LOG_CHANNEL=daily  # Recommended for structured logging
LOG_LEVEL=debug    # Set the minimum log level to be recorded

Log Channel Configuration

Update your config/logging.php file to use the daily log channel:

'daily' => [
    'driver' => 'daily',
    'path' => storage_path('logs/laravel.log'),
    'level' => env('LOG_LEVEL', 'debug'),
    'days' => 30, // Keep logs for the last 30 days
],

Usage

🏠 Dashboard Access

Navigate to the main dashboard to get an overview of your logs:

https://your-domain.com/log-tracker

Dashboard Features:

Real-time log statistics
Error pattern analysis
Peak error hours visualization
Recent log entries
Daily log trends (last 7 days)

📁 Log File Management

View and manage individual log files:

https://your-domain.com/log-tracker/log-file

Available Actions:

👁️ View - Browse log entries with pagination
📥 Download - Download original log files
📊 Export - Export logs in various formats
🗑️ Delete - Remove log files (if enabled)

🔍 Advanced Filtering

Filter by Log Level:

Emergency, Alert, Critical
Error, Warning, Notice
Info, Debug

Filter by Time:

Last hour
Today
Last 7 days
Custom date range

Search Features:

Keyword search in log messages
Multiple search terms support

📝 Generating Log Examples

To test and populate your logs with different types of entries, you can use Laravel's built-in Log facade. Here are some practical examples:

<?php

use Illuminate\Support\Facades\Log;

// Basic log levels
Log::info('User logged in successfully', ['user_id' => 123]);
Log::warning('Disk space is running low', ['disk_usage' => '85%']);
Log::error('Payment processing failed', ['order_id' => 'ORD-12345', 'error' => 'Gateway timeout']);

// Emergency and Critical logs
Log::emergency('Database connection lost completely');
Log::critical('Memory limit exceeded', ['memory_usage' => '512MB']);
Log::alert('Security breach detected', ['ip_address' => '192.168.1.100']);

// Debug and Notice logs
Log::debug('API response received', ['response_time' => '250ms', 'endpoint' => '/api/users']);
Log::notice('User password changed', ['user_id' => 456]);

// Logs with context data
Log::error('File upload failed', [
    'file_name' => 'document.pdf',
    'file_size' => '5MB',
    'user_id' => 789,
    'error_code' => 'UPLOAD_TIMEOUT'
]);

// Exception logging
try {
    // Some risky operation
    throw new \Exception('Sample exception for testing');
} catch (\Exception $e) {
    Log::error('Exception caught: ' . $e->getMessage(), [
        'file' => $e->getFile(),
        'line' => $e->getLine(),
        'trace' => $e->getTraceAsString()
    ]);
}

📊 View Generated Logs: After running these examples in your Laravel application (via tinker, controllers, or artisan commands), visit your log tracker dashboard to see them categorized and displayed beautifully!

Themes

Laravel Log Tracker offers two distinct themes to match your workflow and preferences:

Available Themes

Theme	Description	Features
🌊 LiteFlow	Minimal, clean log view with streamlined interface	Clean design, fast loading, excellent readability
✨ GlowStack	Modern, colorful, enhanced visual log view	Rich colors, advanced styling, enhanced user experience

Theme Configuration

Set your preferred theme in config/log-tracker.php:

'theme' => 'GlowStack', // Options: 'LiteFlow', 'GlowStack'

🎨 Theme Management via Artisan Commands

Laravel Log Tracker provides convenient Artisan commands to manage themes without editing configuration files:

List Available Themes

php artisan log-tracker:theme list

Output:

Available Log Tracker Themes:

  • GlowStack
  • LiteFlow ← Current

Check Current Theme

php artisan log-tracker:theme current

Output:

Current Theme: LiteFlow

Switch Theme

# Switch to GlowStack theme
php artisan log-tracker:theme set GlowStack

# Switch to LiteFlow theme  
php artisan log-tracker:theme set LiteFlow

Example Usage:

# Check what themes are available
php artisan log-tracker:theme list

# Switch to the modern GlowStack theme
php artisan log-tracker:theme set GlowStack

# Verify the change
php artisan log-tracker:theme current

💡 Pro Tip: Theme changes take effect immediately - no cache clearing or server restart required!

Theme Features

🌊 LiteFlow Theme:

Minimalist design philosophy
Faster page loads with reduced styling
Perfect for high-frequency log monitoring
Clean, distraction-free interface
Optimized for performance

✨ GlowStack Theme (Default):

Modern, vibrant color scheme
Enhanced visual hierarchy
Rich animations and transitions
Advanced styling elements
Improved user engagement

📤 Export Features

Export your logs in multiple formats for external analysis and reporting with zero external dependencies:

Supported Export Formats

Format	Extension	Description	Features
📊 CSV	`.csv`	Excel-compatible CSV format	Universal compatibility, easy data analysis
📈 Excel	`.xlsx`	Native Excel XML format	Rich formatting, ready for spreadsheet analysis
📄 PDF	`.pdf`	Print-ready HTML report	Professional reports, easy sharing
🔗 JSON	`.json`	Structured JSON with metadata	API integration, programmatic processing

Export Configuration

Configure export settings in config/log-tracker.php:

'export' => [
    'enabled' => true,
    'formats' => [
        'csv' => [
            'enabled' => true,
            'description' => 'Excel-compatible CSV format'
        ],
        'json' => [
            'enabled' => true,
            'description' => 'Structured JSON with metadata'
        ],
        'excel' => [
            'enabled' => true,
            'description' => 'Native Excel XML format'
        ],
        'pdf' => [
            'enabled' => true,
            'description' => 'Print-ready HTML report'
        ],
    ],
    'limits' => [
        'max_entries' => 50000,        // Maximum records per export
        'max_file_size_mb' => 50,      // Max file size for processing
        'timeout_seconds' => 300,       // Export timeout
    ],
    'storage' => [
        'cleanup_after_days' => 7,     // Auto-cleanup exported files
    ],
],

Export Features

✅ No External Dependencies - All export formats work out of the box
✅ Large File Support - Handle up to 50,000 log entries per export
✅ Smart Filtering - Export only filtered/searched results
✅ Auto Cleanup - Exported files are automatically cleaned up after 7 days
✅ Format Flexibility - Enable/disable specific export formats as needed

How to Export

Navigate to any log file view
Click the "Export" button
Select your preferred format
Choose date range and filters
Download the generated file

Screenshots

📚 API Documentation

Available Routes

// Dashboard
GET /log-tracker

// Log file list
GET /log-tracker/log-file

// View specific log file
GET /log-tracker/{logName}

// Download log file
GET /log-tracker/download/{logName}

// Export log file
POST /log-tracker/export/{logName}

// Delete log file (if enabled)
POST /log-tracker/delete/{logName}

Middleware

Default middleware can be customized in configuration:

'middleware' => ['web', 'auth'],

📝 Changelog

Check out the CHANGELOG for the latest updates and features.

🆘 Support

📞 Get Help

🐛 Bug Reports: GitHub Issues
💬 Feature Requests: GitHub Discussions
📖 Documentation: Wiki
💌 Email Support: mdsadi4@gmail.com

⭐ Show Your Support

If Laravel Log Tracker helps your project:

⭐ Star the repository on GitHub
🍵 Buy me a coffee to fuel development
📢 Share with the Laravel community
📝 Write a review or blog post

❤️ Supported by Business Automation Ltd

This package is maintained by Sadi and supported by
Business Automation Ltd — building large-scale e-gov & enterprise solutions in Bangladesh.

Author

Khaled Saifullah Sadi
Full Stack Developer & Laravel Enthusiast

🌐 Connect With Me

📄 License

This package is open-source software licensed under the MIT License.

MIT License

Copyright (c) 2025 Khaled Saifullah Sadi

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

⭐ If you find this package useful, please consider giving it a star! ⭐

Made with ❤️ for the Laravel Community

kssadi / log-tracker

Maintainers

Details