PHPackages ricardosierra/larametrics - 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. ricardosierra/larametrics ActiveLibrary[Logging & Monitoring](/categories/logging) ricardosierra/larametrics ========================= A self-hosted metrics and notifications platform for Laravel apps v1.2.4(5y ago)24801MITCSSPHP ^7.0 Since Oct 22Pushed 5y agoCompare [ Source](https://github.com/ricardosierra/larametrics)[ Packagist](https://packagist.org/packages/ricardosierra/larametrics)[ GitHub Sponsors](https://github.com/aschmelyun)[ RSS](/packages/ricardosierra-larametrics/feed)WikiDiscussions master Synced 2d ago READMEChangelogDependencies (3)Versions (15)Used By (1) Larametrics =========== [](#larametrics) [![Current Version](https://camo.githubusercontent.com/e85bc3e0d4db26462707bd34213d02336593935e97d744a9589e6b50e5c880b3/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f617363686d656c79756e2f6c6172616d6574726963732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/aschmelyun/larametrics)[![License](https://camo.githubusercontent.com/fe140c4d6dab1a6ceb27cee71f1e88b4b6981af60bb9069856ce09e8f59eb83b/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f617363686d656c79756e2f6c6172616d6574726963732e7376673f7374796c653d666c61742d737175617265)](https://camo.githubusercontent.com/fe140c4d6dab1a6ceb27cee71f1e88b4b6981af60bb9069856ce09e8f59eb83b/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f617363686d656c79756e2f6c6172616d6574726963732e7376673f7374796c653d666c61742d737175617265)[![Build Status](https://camo.githubusercontent.com/30705e9e0705d0f363c1ebb74546a1b33d5f83671f1d5b38625e02db56027c86/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f617363686d656c79756e2f6c6172616d6574726963732f6d61737465722e7376673f7374796c653d666c61742d737175617265)](https://travis-ci.org/aschmelyun/larametrics)[![Total Downloads](https://camo.githubusercontent.com/993f69e54e08dede3a8cf0fb72e7c9252e53ef131b28ec19ca021161d1cbd2d6/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f617363686d656c79756e2f6c6172616d6574726963732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/aschmelyun/larametrics) A self-hosted metrics and notifications platform for Laravel apps, Larametrics records and notifies you of changes made to models, incoming requests, and messages written to the log. A full version of the docs can be found [here](https://larametrics.com/docs), below you'll find a quick 'Getting Started' guide. [![Screenshot of Larametrics Dashboard](https://camo.githubusercontent.com/3ffd682db0a0b745f30474ed7ca66122802b64512baa19e169745b00684de405/68747470733a2f2f692e696d6775722e636f6d2f49734145734b6e2e706e67)](https://camo.githubusercontent.com/3ffd682db0a0b745f30474ed7ca66122802b64512baa19e169745b00684de405/68747470733a2f2f692e696d6775722e636f6d2f49734145734b6e2e706e67) Requirements ------------ [](#requirements) - PHP 5.6.4 or higher - Laravel 5.2 or higher - guzzlehttp/guzzle (if notifications enabled) Installation ------------ [](#installation) Larametrics is installed as a standalone package through Composer: ``` composer require aschmelyun/larametrics ``` After Composer finishes up, you'll have to add the following line to your `config/app.php` file if you're not on Laravel 5.5 or higher: ``` Aschmelyun\Larametrics\LarametricsServiceProvider::class ``` Additionally, you'll want to get the config file copied over and add in the necessary database structure with: ``` php artisan vendor:publish --provider="Aschmelyun\Larametrics\LarametricsServiceProvider" php artisan migrate ``` **Note:** Notifications use queued jobs when available to prevent delays in app response time. If you don't have this database table set up already for queues, run `php artisan queue:table && php artisan migrate`. Displaying the Dashboard ------------------------ [](#displaying-the-dashboard) Once you have the package tied in to your Laravel app, it starts collecting data based off of the default config file and storing it in your database. In order to view the dashboard associated with Larametrics and analyse your metrics and notifications, you'll need to add in a helper method to your routes file of choice. ``` \Aschmelyun\Larametrics\Larametrics::routes(); ``` Include that where (and how) you want the dashboard to appear. For reference, all Larametrics routes are wrapped under a `/metrics` prefix, but you can adjust where you want the routes to appear. In the following example, the Larametrics dashboard will only be viewable to people who are signed into the application, and visit `/admin/metrics`: ``` // routes/web.php Route::group(['middleware' => 'auth', 'prefix' => 'admin'], function() { \Aschmelyun\Larametrics\Larametrics::routes(); }); ``` Configuration ------------- [](#configuration) Configuring Larametrics for use within your Laravel app takes place mainly in the `config/larametrics.php` file. Each item is broken down in the comment lines above it, describing what that item does and what value(s) it's anticipating. There are also two .env variables you'll need to set depending on if you use notifications: - **LARAMETRICS\_NOTIFICATION\_EMAIL**, the address that all email notifications will be routed to - **LARAMETRICS\_NOTIFICATION\_SLACK\_WEBHOOK**, a Slack webhook configured for receiving requests and adding messages to a specified channel. More info [here](https://get.slack.help/hc/en-us/articles/115005265063-Incoming-WebHooks-for-Slack). Additionally, there's a few other niche variables that you can set specifically for notifications. See a brief description of each below, or a more details on the documentation site. - **LARAMETRICS\_FROM\_EMAIL**, the email address that notifications will appear to be sent from - **LARAMETRICS\_FROM\_NAME**, the name that will appear alongside associated email notifications - **LARAMETRICS\_MODEL\_SUBJECT**, the subject of notification emails that arrive when models are created/updated/deleted - **LARAMETRICS\_LOG\_SUBJECT**, the subject of notification emails that arrive when an application log event is recorded - **LARAMETRICS\_ROUTE\_SUBJECT**, the subject of notification emails that arrive when a route has been visited Roadmap ------- [](#roadmap) Larametrics is still in development, constantly being optimized and attempting to be made compatible for older Laravel versions. Here's what's on the path ahead: - Add the ability to ignore specific request paths - Integrate custom webhooks as a notification option - Move listeners out of root directory and into their own namespace - Optimize front-end for mobile devices - Expand on the notification filter options - Integrate Twilio for text message notifications - Optimize database querying for expired models to improve performance - Add Artisan commands for displaying Larametrics data - Add watcher for Queues - Add watcher for Scheduled Tasks - Compatibility for Laravel 4.2+ Difference to Laravel Telescope ------------------------------- [](#difference-to-laravel-telescope) In October 2018, Taylor Otwell announced `Laravel Telescope`, which acts as a debugging tool for Laravel applications. For a distinction between `Larametrics` and `Telescope`, please see [this discussion here](https://github.com/aschmelyun/larametrics/issues/11). Contact Info ------------ [](#contact-info) Have an issue? Submit it here! Want to get in touch? Feel free to reach out to me on [Twitter](https://twitter.com/aschmelyun) for any kind of general questions or comments. License ------- [](#license) The MIT License (MIT). See [LICENSE.md](https://github.com/aschmelyun/larametrics/blob/master/LICENSE.md) for more details. ### Health Score 32 — LowBetter than 69% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity15 Limited adoption so far Community17 Small or concentrated contributor base Maturity65 Established project with proven stability Bus Factor1 Top contributor holds 74.5% 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 ~57 days Total 13 Last Release 2166d ago Major Versions 1.1.5 → v2.x-dev2020-01-12 PHP version history (2 changes)1.0.0PHP >=5.6.4 v2.x-devPHP ^7.0 ### Community Maintainers ![](https://www.gravatar.com/avatar/c0a11577f9e4f7db7533432c22786439b3155ec7bc06be9760be7260c4ce1e0d?d=identicon)[ricardosierra](/maintainers/ricardosierra) --- Top Contributors [![aschmelyun](https://avatars.githubusercontent.com/u/3395980?v=4)](https://github.com/aschmelyun "aschmelyun (73 commits)")[![nowendwell](https://avatars.githubusercontent.com/u/5315824?v=4)](https://github.com/nowendwell "nowendwell (9 commits)")[![ricardosierra](https://avatars.githubusercontent.com/u/5499444?v=4)](https://github.com/ricardosierra "ricardosierra (4 commits)")[![skadimoolam](https://avatars.githubusercontent.com/u/6323063?v=4)](https://github.com/skadimoolam "skadimoolam (3 commits)")[![bmillertitul](https://avatars.githubusercontent.com/u/54295408?v=4)](https://github.com/bmillertitul "bmillertitul (2 commits)")[![algm](https://avatars.githubusercontent.com/u/146385?v=4)](https://github.com/algm "algm (2 commits)")[![tanmuhittin](https://avatars.githubusercontent.com/u/7202383?v=4)](https://github.com/tanmuhittin "tanmuhittin (1 commits)")[![dellow](https://avatars.githubusercontent.com/u/1047476?v=4)](https://github.com/dellow "dellow (1 commits)")[![johannesschobel](https://avatars.githubusercontent.com/u/9431350?v=4)](https://github.com/johannesschobel "johannesschobel (1 commits)")[![namnv609](https://avatars.githubusercontent.com/u/8691772?v=4)](https://github.com/namnv609 "namnv609 (1 commits)")[![0xK4d1r](https://avatars.githubusercontent.com/u/15370532?v=4)](https://github.com/0xK4d1r "0xK4d1r (1 commits)") ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/ricardosierra-larametrics/health.svg) ``` [![Health](https://phpackages.com/badges/ricardosierra-larametrics/health.svg)](https://phpackages.com/packages/ricardosierra-larametrics) ``` ### Alternatives [aws/aws-sdk-php AWS SDK for PHP - Use Amazon Web Services in your PHP project 6.2k555.0M2.8k](/packages/aws-aws-sdk-php)[neuron-core/neuron-ai The PHP Agentic Framework. 2.0k832.6k55](/packages/neuron-core-neuron-ai)[spatie/laravel-health Monitor the health of a Laravel application 88212.7M189](/packages/spatie-laravel-health)[spatie/flare-client-php Send PHP errors to Flare 178166.2M24](/packages/spatie-flare-client-php)[tencentcloud/tencentcloud-sdk-php TencentCloudApi php sdk 3661.3M49](/packages/tencentcloud-tencentcloud-sdk-php)[eslazarev/wildberries-sdk Wildberries OpenAPI clients (generated). 353.6k](/packages/eslazarev-wildberries-sdk) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)