Filament Log Viewer

A Filament plugin to read and display Laravel log files in a clean, searchable table with stack traces and filtering.

Installation

composer require achyutn/filament-log-viewer

Register the plugin inside your Filament panel:

use AchyutN\FilamentLogViewer\FilamentLogViewer;

return $panel
    ->plugins([
        FilamentLogViewer::make(),
    ]);

Usage

After installation, visit /logs in your Filament panel. You will see a table of log entries.

Configuration

You can configure the maximum file size limit for log files to be loaded and displayed. This helps prevent performance issues with very large log files.

The default file size limit is set to 2 MB:

// config/filament-log-viewer.php

return [
    'max_log_file_size' => env('LOG_MAX_SIZE_KB', 2048),
];

To override this setting, you can set the LOG_MAX_SIZE_KB environment variable in your .env file:

LOG_MAX_SIZE_KB=20480

Or, you can publish the configuration file and update the max_log_file_size value as needed:

php artisan vendor:publish --tag=filament-log-viewer-config

Then, in your published config/filament-log-viewer.php file:

return [
    // Set max file size to 20 MB
    'max_log_file_size' => env('LOG_MAX_SIZE_KB', 20480),
];

Table Columns

• Log Level – Badge with color mapped from log level
• Environment (Toggleable) – Application environment (local, production, etc.)
• File (Toggleable) – Log file name (e.g., laravel.log)
• Message – Short summary of the log
• Occurred – Human-readable date/time

Click the view action to inspect stack traces.

Filters

Log Levels

You can filter the logs according to log level. The filters are available as tabs above the table:

Date

You can filter logs by date using the date picker in the top right corner of the table. This allows you to select a specific date range to view logs.

Extending

You can customize navigation label, icon, sort, etc. using:

use AchyutN\FilamentLogViewer\FilamentLogViewer;

FilamentLogViewer::make()
    ->authorize(fn () => auth()->check())
    ->navigationGroup('System')
    ->navigationIcon('heroicon-o-document-text')
    ->navigationLabel('Log Viewer')
    ->navigationSort(10)
    ->navigationUrl('/logs')
    ->pollingTime(null); // Set to null to disable polling

Laravel Compatibility

The plugin fully supports Laravel 11 and newer. Older versions, such as Laravel 10, may have limitations due to differences in JSON/array casting behavior, which can affect how log stack traces are processed and displayed.

Filament Compatibility

| Version | Filament Version | |---------|------------------| | ^0.x | Filament v3 | | ^1.0 | Filament v4 |

License

This package is open-sourced software licensed under the MIT license.

Changelog

See the CHANGELOG for details on changes made in each version.

Contributing

Contributions are welcome! Please create a pull request or open an issue if you find any bugs or have feature requests.

Support

If you find this package useful, please consider starring the repository on GitHub to show your support.