PHPackages obd/logtracker - 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. [Caching](/categories/caching) 4. / 5. obd/logtracker ActivePackage[Caching](/categories/caching) obd/logtracker ============== User activity log manager. All kind of database activity will be tracked v1.1.9(3mo ago)248MITJavaScript Since Dec 15Pushed 3mo ago1 watchersCompare [ Source](https://github.com/RonyKader/logtracker)[ Packagist](https://packagist.org/packages/obd/logtracker)[ RSS](/packages/obd-logtracker/feed)WikiDiscussions main Synced 1w ago READMEChangelogDependenciesVersions (14)Used By (0) Logtracker - Modern Audit Logging for Laravel ============================================= [](#logtracker---modern-audit-logging-for-laravel) A high-performance, internationalized activity log manager for Laravel applications. This package tracks all database activities and provides a premium, animated audit panel. Features -------- [](#features) - **Premium UI**: Glassmorphic, React-powered dashboard with **30-Day Activity Heatmaps** and interactive **Date Range Picker**. - **Log Management**: Full-featured **System Log Viewer** with support for multiple files (daily logs), entry deletion, and bulk clearing. - **Universal SPA**: Works in full-stack Laravel apps, API-only backends, and even as a standalone UI hosted separately. - **i18n Ready**: Full support for English and Bengali locales. - **Granular Security**: Access control via User ID whitelisting. - **Performance**: Asynchronous logging support via Laravel Queues and **Optimized Batch Pruning**. - **NoSQL Backup**: Background synchronization of logs to MongoDB. - **Privacy**: Automatically masks sensitive `$hidden` attributes. --- Installation ------------ [](#installation) ### Option A: Full-Stack Laravel Project (Blade + Auth) [](#option-a-full-stack-laravel-project-blade--auth) For projects like `mofa-education` where Laravel handles both frontend and backend. #### 1. Add the Package [](#1-add-the-package) **Local Development:** ``` // composer.json "repositories": [ { "type": "path", "url": "./Packages/logtracker" } ] ``` ``` composer require obd/logtracker:dev-dev ``` **Production (via GitHub/Packagist):** ``` composer require obd/logtracker ``` #### 2. Publish & Migrate [](#2-publish--migrate) ``` php artisan vendor:publish --tag=logtracker-config php artisan vendor:publish --tag=logtracker-assets --force php artisan migrate ``` #### 3. Add Trait to Models [](#3-add-trait-to-models) Automatically add the tracking trait to all your models: ``` php artisan logtracker:install-trait ``` *Alternatively, manually add to specific models:* ``` use Obd\Logtracker\Traits\Logtrackerable; class Project extends Model { use Logtrackerable; } ``` #### 4. Configure `.env` [](#4-configure-env) ``` LOGTRACKER_ALLOWED_IDS=1,2,5 ``` #### 5. Access [](#5-access) Visit `/audit-panel` in your browser. Done! --- ### Option B: API-Only Laravel Project (Sanctum / No Blade Auth) [](#option-b-api-only-laravel-project-sanctum--no-blade-auth) For projects like `e-ticketing-api` where Laravel serves only APIs and has no web login route. #### 1. Add the Package [](#1-add-the-package-1) ``` // composer.json "repositories": [ { "type": "path", "url": "../Packages/logtracker" } ], "minimum-stability": "dev", "prefer-stable": true ``` ``` composer require obd/logtracker:dev-dev ``` #### 2. Publish & Migrate [](#2-publish--migrate-1) ``` php artisan vendor:publish --tag=logtracker-config php artisan vendor:publish --tag=logtracker-assets --force php artisan migrate ``` #### 3. Configure Middleware & Security (Critical!) [](#3-configure-middleware--security-critical) Open `config/obd_tracker.php` and configure for API use: ``` 'ui_middleware' => ['web'], // Remove 'auth' to prevent 'login route not found' 'api_middleware' => ['web'], 'access_secret' => env('LOGTRACKER_ACCESS_SECRET'), // Use this to secure the panel ``` #### 4. Add Trait & Configure .env [](#4-add-trait--configure-env) ``` php artisan logtracker:install-trait ``` ``` # .env LOGTRACKER_ACCESS_SECRET=your-secure-random-key ``` #### 5. Access [](#5-access-1) Visit `http://your-api.test/audit-panel` and enter your secret key, or go directly to `http://your-api.test/audit-panel?secret=your-secure-random-key`. --- ### Option C: Standalone / Headless Mode [](#option-c-standalone--headless-mode) Host the Logtracker UI on a completely separate domain (e.g., `audit.example.com`) and connect it to any Laravel backend. #### 1. Install the package on your Laravel backend (Option A or B above). [](#1-install-the-package-on-your-laravel-backend-option-a-or-b-above) #### 2. Export Assets [](#2-export-assets) Copy the `dist/` folder from the package to your static server or CDN. #### 3. Create a Mount Page [](#3-create-a-mount-page) ``` > window.LOGTRACKER_API_URL = "https://api.yourbackend.com/audit-panel/ui-config"; ``` #### 4. Enable CORS [](#4-enable-cors) Ensure your Laravel `config/cors.php` allows requests from the standalone UI domain. --- Configuration (`config/obd_tracker.php`) ---------------------------------------- [](#configuration-configobd_trackerphp) KeyDefaultDescription`route_prefix``audit-panel`URL prefix for the UI panel`api_prefix``api/audit-panel-data`URL prefix for the data API`ui_middleware``['web', 'auth']`Middleware for UI routes`api_middleware``['web', 'auth']`Middleware for API routes`allowed_user_ids``[]`Comma-separated User IDs allowed to access the panel (empty = all)`queue_enabled``false`Dispatch logging to a background queue`queue_name``default`Queue connection name`access_secret``null`Secret key for non-auth projects (prevents public access)`retention_days``90`Days to keep logs before pruning### Environment Variables [](#environment-variables) ``` # Authorization LOGTRACKER_ALLOWED_IDS=1,2,5 LOGTRACKER_ACCESS_SECRET=your-secret-key-gate # Performance LOGTRACKER_QUEUE_ENABLED=true # MongoDB Sync LOGTRACKER_MONGO_ENABLED=true LOGTRACKER_MONGO_CONNECTION=mongodb # Data Retention LOGTRACKER_RETENTION_DAYS=90 ``` --- Commands -------- [](#commands) CommandDescription`logtracker:install-trait`Automatically add audit trait to all Eloquent models`logtracker:install-trait --dry-run`Preview which models would be updated`logtracker:install-trait --dir=app/Models`Specify a custom scan directory`logtracker:prune`Remove logs older than retention period`logtracker:prune --days=30`Override default retention`logtracker:sync-mongo`Mirror logs to MongoDB### Automated Maintenance [](#automated-maintenance) ``` $schedule->command('logtracker:prune')->daily(); ``` --- Updating -------- [](#updating) When updating to a new version, always run: ``` composer update obd/logtracker php artisan vendor:publish --tag=logtracker-assets --force php artisan optimize:clear ``` --- Security -------- [](#security) - **Path Traversal Protection**: System log viewer uses `basename()` + `realpath()` validation to prevent directory traversal attacks. - **Extension Enforcement**: Only `.log` files can be accessed through the system log viewer. - **User Whitelisting**: Access can be restricted to specific user IDs via environment configuration. - **Privacy**: Model `$hidden` attributes (e.g., passwords) are automatically excluded from audit logs. - **CSRF Protection**: All POST routes (clear/delete) are protected by Laravel's CSRF middleware. --- *© 2026 Logtracker Audit System - Premium Enterprise Edition* ### Health Score 42 — FairBetter than 88% of packages Maintenance79 Regular maintenance activity Popularity11 Limited adoption so far Community7 Small or concentrated contributor base Maturity58 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% 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 ~144 days Recently: every ~0 days Total 12 Last Release 118d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/8412631?v=4)[w3zones](/maintainers/w3zones)[@w3zones](https://github.com/w3zones) --- Top Contributors [![ronykader](https://avatars.githubusercontent.com/u/8412614?v=4)](https://github.com/ronykader "ronykader (17 commits)") --- Tags bootstrap5laravelmysqlredis ### Embed Badge ![Health badge](/badges/obd-logtracker/health.svg) ``` [![Health](https://phpackages.com/badges/obd-logtracker/health.svg)](https://phpackages.com/packages/obd-logtracker) ``` ### Alternatives [iazaran/smart-cache Smart Cache is a caching optimization package designed to enhance the way your Laravel application handles data caching. It intelligently manages large data sets by compressing, chunking, or applying other optimization strategies to keep your application performant and efficient. 21114.2k](/packages/iazaran-smart-cache)[phpfastcache/phpssdb PHP SSDB Driver for phpFastCache 14736.9k1](/packages/phpfastcache-phpssdb)[rapidwebltd/rw-file-cache RW File Cache is a PHP File-based Caching Library. Its syntax is designed to closely resemble the PHP memcache extension. 15196.8k7](/packages/rapidwebltd-rw-file-cache)[yuzuru-s/redis-recommend Wrapping Redis's sorted set APIs for specializing recommending operations. 392.9k](/packages/yuzuru-s-redis-recommend)[ichhabrecht/intcache Turn uncachable page objects into cacheable links 193.9k](/packages/ichhabrecht-intcache) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)