PHPackages shipsaas/shipsaas-logger - 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. shipsaas/shipsaas-logger ActiveLibrary[Logging & Monitoring](/categories/logging) shipsaas/shipsaas-logger ======================== Laravel ShipSaasLogger enables the tracing of requests across servers by marking each request with a unique ID. Skyrocket the production debugging. 1.0.0(2y ago)14591[1 issues](https://github.com/shipsaas/shipsaas-logger/issues)MITPHPPHP ^8.1|^8.2 Since Oct 25Pushed 2y ago1 watchersCompare [ Source](https://github.com/shipsaas/shipsaas-logger)[ Packagist](https://packagist.org/packages/shipsaas/shipsaas-logger)[ RSS](/packages/shipsaas-shipsaas-logger/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (1)Dependencies (7)Versions (2)Used By (0) ShipSaaS Logger - Laravel Unique Request ID Logger ================================================== [](#shipsaas-logger---laravel-unique-request-id-logger) [![Build & Test (PHP 8.2)](https://github.com/shipsaas/shipsaas-logger/actions/workflows/build.yml/badge.svg)](https://github.com/shipsaas/shipsaas-logger/actions/workflows/build.yml)[![codecov](https://camo.githubusercontent.com/e81511d5b4116c27169a9c3783a3d204484a70462b8594c47beabe54ba5c9082/68747470733a2f2f636f6465636f762e696f2f67682f73686970736161732f73686970736161732d6c6f676765722f67726170682f62616467652e7376673f746f6b656e3d31635766573855655568)](https://codecov.io/gh/shipsaas/shipsaas-logger) Laravel ShipSaasLogger enables the tracing of requests across servers by marking each request with a unique ID 🆔 for every log record of the given request. Skyrocket your production debugging ⚒️. Additionally, ShipSaasLogger solves the **missing logs** problem when you have a huge amount of traffic 😎. Making production logs more reliable and engineers won't have to scream "I can't find the logs" 🔥. [![ShipSaaS Logger](.github%2Fshipsaas-logger.png)](.github%2Fshipsaas-logger.png) Supports -------- [](#supports) - Laravel 10+ - PHP 8.2+ Installation ------------ [](#installation) Install the library: ``` composer require shipsaas/shipsaas-logger ``` Usage ----- [](#usage) We ship a new Logger driver called `shipsaas-logger` which handles: - Create log file based on the requestId, e.g.: `7a559daf-f1fe-4a97-8eb8-40d0907c986b.log` - Write request-based logs there - A fallback to the default log file, if `requestId` is not presented Thus, it fixes the missing logs issue because we have **independent log files** and not yolo-write into 1 file (which will mess up the logs when having high traffic) 🚀 Nowadays, we can just tell Sumologic (or Cloudwatch, DataDog, etc.) to sync your log folder (a whole folder) 🔥. All your logs will be synced on the cloud. ### Set up `config/logging.php` [](#set-up-configloggingphp) Add a new channel called `shipsaas-logger` and change the configuration based on your needs ``` 'shipsaas-logger' => [ 'driver' => 'shipsaas-logger', 'path' => storage_path('logs/requests/laravel.log'), // can change to your desired path 'default_log_file' => storage_path('logs/laravel.log'), // can change to your desired path 'id-type' => 'ulid', // uuid, orderedUuid, ulid 'use_json_format' => false, // set to true to write log as JSON ], ``` ### Update .env [](#update-env) Change the `LOG_CHANNEL` to `shipsaas-logger` ``` LOG_CHANNEL=shipsaas-logger ``` ### Play [](#play) Now that you have everything, hit some requests and try it out 😎. ``` class TransferController extends BaseController { public function transfer(): JsonResponse { Log::info('begin transfer', [ 'amount' => ..., 'recipient' => ..., ]); // this log will have uniqueRequestId // ... Log::info('transferred', [ 'amount' => ..., 'recipient' => ..., 'trasaction_id' => ..., ]); // this log will have uniqueRequestId } } ``` And also congrats, no more "missing logs" pain for your app 😉. Usage (Minimalism) ------------------ [](#usage-minimalism) ### Inject Unique Request Id Logger Processor [](#inject-unique-request-id-logger-processor) By simply putting this piece of code into your `AppServiceProvider`: ``` // AppServiceProvider.php use ShipSaasUniqueRequestLogger\UniqueRequestIdLoggerInitiator; public function boot(): void { $this->app->booted(fn () => UniqueRequestIdLoggerInitiator::init()); } ``` ### Play [](#play-1) Now that you have injected ShipSaaS Logger, hit some requests and try it out 😎. Note: The Minimalism way only injects the UniqueRequestID generation into your application, it **won't have any** improvement for missing logs issue. Testing ------- [](#testing) Run `composer test` 😆 Contributors ------------ [](#contributors) - Seth Phat Contributions & Support the Project --------------------------------------- [](#contributions--support-the-project) Feel free to submit any PR, please follow PSR-1/PSR-12 coding conventions and testing is a must. If this package is helpful, please give it a ⭐️⭐️⭐️. Thank you! License ------- [](#license) MIT License ### Health Score 27 — LowBetter than 49% of packages Maintenance19 Infrequent updates — may be unmaintained Popularity16 Limited adoption so far Community8 Small or concentrated contributor base Maturity55 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 Unknown Total 1 Last Release 931d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/ac3f098d85bb371388a3ad370678da627a3cbc53c3b107f4fd6bf46f1ce583e3?d=identicon)[sethsandaru](/maintainers/sethsandaru) --- Top Contributors [![sethsandaru](https://avatars.githubusercontent.com/u/23478115?v=4)](https://github.com/sethsandaru "sethsandaru (12 commits)") --- Tags laravellaravel-librarylaravel-loggerlaravel-packageloggershipsaasunique-request-loggerlaraveldebuggingdevelopmentlaravel-librarylaravel unique request id loggerlaravel shipsaas logger ### Code Quality TestsPHPUnit Code StylePHP CS Fixer ### Embed Badge ![Health badge](/badges/shipsaas-shipsaas-logger/health.svg) ``` [![Health](https://phpackages.com/badges/shipsaas-shipsaas-logger/health.svg)](https://phpackages.com/packages/shipsaas-shipsaas-logger) ``` ### Alternatives [binarybuilds/laravel-mail-manager A Laravel mail manager to record and re-send all outgoing emails. 2440.2k1](/packages/binarybuilds-laravel-mail-manager)[lucianotonet/laravel-telescope-mcp MCP Server extension for Laravel Telescope 198.6k](/packages/lucianotonet-laravel-telescope-mcp) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)