PHPackages entensy/filament-tracer - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Logging & Monitoring](/categories/logging) 4. / 5. entensy/filament-tracer ActiveLibrary[Logging & Monitoring](/categories/logging) entensy/filament-tracer ======================= Filament Tracer is a versatile package to report exceptions and traces. Table schemas are compatible with any language of choice. 0.1.7(1y ago)4401MITPHPPHP ^8.1|^8.2|^8.3 Since Dec 3Pushed 1y ago1 watchersCompare [ Source](https://github.com/Entensy/filament-tracer)[ Packagist](https://packagist.org/packages/entensy/filament-tracer)[ Docs](https://github.com/entensy/filament-tracer)[ RSS](/packages/entensy-filament-tracer/feed)WikiDiscussions main Synced 1mo ago READMEChangelogDependencies (9)Versions (9)Used By (0) filament-tracer =============== [](#filament-tracer) [![Latest Version on Packagist](https://camo.githubusercontent.com/f8e5a42f2a6dec4f15b698757f91e4b84aad93bdddec6e20055dcc6907561207/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f656e74656e73792f66696c616d656e742d7472616365722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/entensy/filament-tracer)[![GitHub Tests Action Status](https://camo.githubusercontent.com/49820d2d1043f945e1d235b6075499621d97b4630f4d7700126105a601c0621c/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f656e74656e73792f66696c616d656e742d7472616365722f72756e2d74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/entensy/filament-tracer/actions?query=workflow%3Arun-tests+branch%3Amain)[![GitHub Code Style Action Status](https://camo.githubusercontent.com/65b8a6192ecd346897feb3856deb9df3d11a6e23b8b3687419d3cc10bd50d8b3/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f656e74656e73792f66696c616d656e742d7472616365722f6669782d7068702d636f64652d7374796c652d6973737565732e796d6c3f6272616e63683d6d61696e266c6162656c3d636f64652532307374796c65267374796c653d666c61742d737175617265)](https://github.com/entensy/filament-tracer/actions?query=workflow%3A%22Fix+PHP+code+style+issues%22+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/79ccd8988f1e47c84d919f5ba8c35fcc71ff3ad0d874166ac9902e514ade7e18/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f656e74656e73792f66696c616d656e742d7472616365722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/entensy/filament-tracer) Filament tracer is a flexible filament plugin to report and view exceptions and traces with a generic table schema to be able to store traces from other programming languages. The purpose of this package is to have a common tables to report/log errors throughout your applications, independent of what programming language you use so long as your application has a connection to the database, you can store the traces then later view them in filament dashboard. Installation ------------ [](#installation) This plugin requires Filament v3.0+, it does not work in older version! Install the package via composer: ``` composer require entensy/filament-tracer ``` You could also use direct repository url in your `composer.json`: ``` "require": { "entensy/filament-tracer": "dev-main" } "repositories": [ { "type": "git", "url": "https://github.com/entensy/filament-tracer.git" } ] ``` Usage ----- [](#usage) Register the plugin in your desired filament panel: ``` public function panel(Panel $panel): Panel { return $panel ... ->plugins([ FilamentTracerPlugin::make() // You may define how you would like to get tab badge numbers, these must return int type ->tracesCounterUsing(fn($record) => count( explode(PHP_EOL, $record->traces) ) ?? 0) ->queriesCounterUsing(fn($record) => /** return int value */) ->bodyCounterUsing(fn($record) => /** return int value */) ->headersCounterUsing(fn($record) => /** return int value */) ->cookiesCounterUsing(fn($record) => /** return int value */) ]); } ``` To register capturing exceptions and errors, go to your `app\Exceptions\Handler.php` file and put the following snippet into `register`method: ``` $this->reportable(function (Throwable $e) { if ($this->shouldReport($e)) { \Entensy\FilamentTracer\FilamentTracer::capture($e, request()); } }); ``` ### Theme [](#theme) You may change the palette colors in your **Filament Panel Service Provider**: ``` $panel ->colors([ 'danger' => Color::Rose, 'primary' => Color::Red, 'success' => Color::Green, 'warning' => Color::Yellow, 'gray' => Color::Gray, 'info' => Color::Blue, ]) ``` ### Configuration [](#configuration) You may publish configuration using Laravel's publish command: ``` # Publish config file php artisan vendor:publish --tag=filament-tracer-config # Publish views php artisan vendor:publish --tag=filament-tracer-views # Publish translations php artisan vendor:publish --tag=filament-tracer-translations # Publish migrations php artisan vendor:publish --tag=filament-tracer-migrations ``` ### Custom Tracer Class [](#custom-tracer-class) You may write your own tracer class by changing the default class in the plugin config file. If you don't have this file, you may publish it with `php artisan vendor:publish --tag=filament-tracer-config` file: ``` [ ... // You may implement your own tracer by implementing Tracerable interface 'tracer' => \Entensy\FilamentTracer\DefaultTracer::class, ... ] ``` Defining a custom Tracer class has to implement `Tracerable` interface. ``` use Entensy\FilamentTracer\Contracts\Tracerable; class MyCustomTracer implements Tracerable { // } ``` If you would like to change how an error being stored, you may overwrite this implementation by implementing `HasStore` interface in your custom tracer class then add your implementation in `store` method ``` use Entensy\FilamentTracer\Contracts\HasStore; use Entensy\FilamentTracer\Contracts\Tracerable; class MyCustomTracer implements Tracerable, HasStore { public function store(): mixed { $err = $this->getThrowable(): // just log the trace and don't store it in database logger()->error($err); return true; } } ``` ### Testing [](#testing) ``` composer test ``` ### Changelog [](#changelog) Please see [CHANGELOG](CHANGELOG.md) for more information what has changed recently. Contributing ------------ [](#contributing) Please see [CONTRIBUTING](CONTRIBUTING.md) for details. ### Security [](#security) Please email `security@entensy.com` for any security issues. Credits ------- [](#credits) - [AlanD20](https://github.com/AlanD20) - [Entensy](https://github.com/entensy) - [RawanD201](https://github.com/RawanD201) License ------- [](#license) This repository is under [MIT License (MIT)](LICENSE). ### Health Score 31 — LowBetter than 68% of packages Maintenance38 Infrequent updates — may be unmaintained Popularity13 Limited adoption so far Community10 Small or concentrated contributor base Maturity53 Maturing project, gaining track record Bus Factor1 Top contributor holds 94.4% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~51 days Recently: every ~59 days Total 8 Last Release 535d ago PHP version history (2 changes)v0.1.0PHP ^8.1|^8.2 v0.1.6PHP ^8.1|^8.2|^8.3 ### Community Maintainers ![](https://www.gravatar.com/avatar/75eacd727e88d4e945ed8acefc37e7ee232eff8037f79c5a790910564a90e796?d=identicon)[entensy](/maintainers/entensy) --- Top Contributors [![AlanD20](https://avatars.githubusercontent.com/u/30084112?v=4)](https://github.com/AlanD20 "AlanD20 (17 commits)")[![RawanD201](https://avatars.githubusercontent.com/u/73317192?v=4)](https://github.com/RawanD201 "RawanD201 (1 commits)") --- Tags entensyfilament-tracer ### Code Quality TestsPest Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/entensy-filament-tracer/health.svg) ``` [![Health](https://phpackages.com/badges/entensy-filament-tracer/health.svg)](https://phpackages.com/packages/entensy-filament-tracer) ``` ### Alternatives [spatie/laravel-activitylog A very simple activity logger to monitor the users of your website or application 5.8k45.4M309](/packages/spatie-laravel-activitylog)[spatie/laravel-health Monitor the health of a Laravel application 85810.0M83](/packages/spatie-laravel-health)[yadahan/laravel-authentication-log Laravel Authentication Log provides authentication logger and notification for Laravel. 416632.8k5](/packages/yadahan-laravel-authentication-log)[kirschbaum-development/commentions A package to allow you to create comments, tag users and more 12369.2k](/packages/kirschbaum-development-commentions)[directorytree/metrics Record metrics in your Laravel application 26027.8k](/packages/directorytree-metrics)[tapp/filament-authentication-log Filament authentication log plugin. 51143.5k3](/packages/tapp-filament-authentication-log) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)