achyutn/filament-log-viewer

A Filament package to view and manage Laravel logs.

v1.2.1 2025-08-08 20:08 UTC

README

Filament Log Viewer

Packagist Version Packagist Downloads Packagist Stars Quality Gate Status Lint & Test PR Bump version

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

Refer to version compatibility table below to ensure you are using the correct version of this package with your Filament installation.

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.

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

Table Preview

Click the view action to inspect stack traces.

Stack Tracing

Mail Preview

If your logs contain mail messages, you can preview them directly from the table. You can click on Mail tab which is visible only if mail are present.

Mail Preview

Filters

Log Levels

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

Log level Filters

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.

Date Filter

Toggle Columns

You can toggle the visibility of the Environment and File columns by clicking the eye icon in the top right corner of the table.

Toggle Columns

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

Filament Compatibility

Version Filament Version
^1.x Filament v4
^0.x Filament v3

Make sure you're using the appropriate version of this package for your Filament installation.

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.