PHPackages                             nivseb/lara-monitor - 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 &amp; Monitoring](/categories/logging)
4. /
5. nivseb/lara-monitor

ActiveLibrary[Logging &amp; Monitoring](/categories/logging)

nivseb/lara-monitor
===================

APM agent for laravel projects to monitor the application with elastic apm tools.

v1.1.9(2mo ago)41.5k↓46.7%2[6 issues](https://github.com/nivseb/lara-monitor/issues)[1 PRs](https://github.com/nivseb/lara-monitor/pulls)MITPHPPHP ^8.2CI passing

Since Dec 31Pushed 1mo ago3 watchersCompare

[ Source](https://github.com/nivseb/lara-monitor)[ Packagist](https://packagist.org/packages/nivseb/lara-monitor)[ RSS](/packages/nivseb-lara-monitor/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (14)Versions (38)Used By (0)

Lara-Monitor
============

[](#lara-monitor)

[![Tests](https://camo.githubusercontent.com/1d4b2e06870a53d5fa47167d4d3b7cfa9fc62d8e070c8d54d4f1eb0783b2bc07/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6e69767365622f6c6172612d6d6f6e69746f722f746573742e796d6c3f6272616e63683d6d61696e266c6162656c3d5465737473)](https://github.com/nivseb/lara-monitor/actions/workflows/tests.yml)[![Supported PHP Version](https://camo.githubusercontent.com/c48449fd15825dbc587bc825791880d9ea77047e719e1b159f675e883d35ff31/68747470733a2f2f62616467656e2e6e65742f7061636b61676973742f7068702f6e69767365622f6c6172612d6d6f6e69746f723f636f6c6f723d383839326266)](https://www.php.net/supported-versions)[![Latest Stable Version](https://camo.githubusercontent.com/ca90c4ce16d90a1ec9daae9524900da499a25439258a0f76893d8985142fe1f4/68747470733a2f2f706f7365722e707567782e6f72672f6e69767365622f6c6172612d6d6f6e69746f722f762f737461626c652e737667)](https://packagist.org/packages/nivseb/lara-monitor)[![Total Downloads](https://camo.githubusercontent.com/c2113ded8d09af4da1db1e8c6742e66ad6295f9d1255b2a3d70708090ac5a9c4/68747470733a2f2f706f7365722e707567782e6f72672f6e69767365622f6c6172612d6d6f6e69746f722f646f776e6c6f6164732e737667)](https://packagist.org/packages/nivseb/lara-monitor)

Lara-Monitor is apm agent package for application that are build with [Laravel Framework](https://laravel.com). The collected data are send to your [Elastic APM Server](https://github.com/elastic/apm-server). That allow you an impressive look to your application via kibana. This package make it easy to connect all needed information from your application in [Elastic Kibana](https://www.elastic.co/de/kibana). This package was developed primarily for container-based environments that use [Laravel Octane](https://laravel.com/docs/master/octane). But it works fine in over environments like plain laravel application as docker container or hostet plain on servers.

Lara-Monitor collect information directly from laravel events and callbacks. That allows a very easy integration, but Lara-Monitor is also designed to be especially customizable, so that you can build that monitoring that is the best for your application.

Feature
-------

[](#feature)

Read more about the collecting process:

- [Recording Transactions from request, commands and jobs](./docs/Collecting/Transactions.md)
- [Collect information about exceptions and errors](./docs/Collecting/Errors.md)
- [Collect database queries from your application](./docs/Collecting/DatabaseQueries.md)
- [Collect http request information against a third-party system](./docs/Collecting/HttpRequests.md)
- [Collect redis commands from your application](./docs/Collecting/RedisCommands.md)
- [Collect information from your rendering processes](./docs/Collecting/Rendering.md)
- [Extend Logging](./docs/Collecting/Logging.md)

At the moment the only agent that is supported, sends the collected data to the [Elastic APM Server](https://github.com/elastic/apm-server). In the feature it would be extended with other agents, or you can build your ownagent. [Read more about the elastic agent](./docs/Agents/ElasticApm.md).

### Octane Support

[](#octane-support)

The request handling in application that use [Laravel Octane](https://laravel.com/docs/master/octane), is a little different to normal laravel request handling. This makes it necessary to collect data for the apm on another way, to get a good look at the performance monitoring.

Only the task worker are not supported. Everything that is done in a task worker will not see in the collected data.

### Customizability

[](#customizability)

All parts are only connected via interfaces, that allows you easily to customize the agent for your requirements. Overwrite the part of the agent, that need to be changed and register your variant. If you think that this also help others, create a pull request and make it possible for everyone to get advantage of it.

Installation
------------

[](#installation)

1. To install Lara-Monitor you can easily use composer.

    ```
    composer require nivseb/lara-monitor
    ```
2. Add `Nivseb\LaraMonitor\Providers\LaraMonitorStartServiceProvider` to your application
3. Add `Nivseb\LaraMonitor\Providers\LaraMonitorEndServiceProvider` to your application
4. Publish and change config or add needed environment variables

The provider should be added manuale to the loaded service provider. This allows you to get the best information from the tracking. The `LaraMonitorStartServiceProvider` Should be loaded as early as possible and the `LaraMonitorEndServiceProvider`should be loaded as late as possible. That include as much as possible other event listeners to monitored for the spans.

Configuration
-------------

[](#configuration)

Lara-Monitor comes with an own config, you can publish it with the following command.

```
php artisan vendor:publish --tag=lara-monitor-config
```

The most configs are set by default laravel environment variables (e.g. `APP_NAME` or `APP_ENV`). For a full documentation see the [Configuration](docs/Configuration.md).

###  Health Score

45

—

FairBetter than 93% of packages

Maintenance66

Regular maintenance activity

Popularity26

Limited adoption so far

Community15

Small or concentrated contributor base

Maturity62

Established project with proven stability

 Bus Factor1

Top contributor holds 76.3% 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 ~27 days

Recently: every ~22 days

Total

16

Last Release

84d ago

Major Versions

v0.8.0 → v1.0.02025-05-31

PHP version history (2 changes)v0.8.0PHP ^8.1

v1.0.0PHP ^8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/5ab68ab2a78069db3160d3194e98b244061024f5cd65389a28e28ecfd430b4c7?d=identicon)[nivseb](/maintainers/nivseb)

---

Top Contributors

[![nivseb](https://avatars.githubusercontent.com/u/1013829?v=4)](https://github.com/nivseb "nivseb (61 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (16 commits)")[![dreadkopp](https://avatars.githubusercontent.com/u/5657840?v=4)](https://github.com/dreadkopp "dreadkopp (1 commits)")[![mbergann](https://avatars.githubusercontent.com/u/19306917?v=4)](https://github.com/mbergann "mbergann (1 commits)")[![xBlack-Shadow](https://avatars.githubusercontent.com/u/10667564?v=4)](https://github.com/xBlack-Shadow "xBlack-Shadow (1 commits)")

---

Tags

apmelasticlaravellaravel-frameworkmonitoringphplaravelmonitoringapmelasticoctane

###  Code Quality

TestsPest

Static AnalysisPHPStan, Rector

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/nivseb-lara-monitor/health.svg)

```
[![Health](https://phpackages.com/badges/nivseb-lara-monitor/health.svg)](https://phpackages.com/packages/nivseb-lara-monitor)
```

###  Alternatives

[inspector-apm/inspector-laravel

Code Execution Monitoring, built for developers.

2332.0M2](/packages/inspector-apm-inspector-laravel)[jackwh/laravel-new-relic

Monitor your Laravel application performance with New Relic

112827.2k](/packages/jackwh-laravel-new-relic)[arkaitzgarro/elastic-apm-laravel

Laravel APM agent for Elastic v2 intake API

84433.6k](/packages/arkaitzgarro-elastic-apm-laravel)[scoutapp/scout-apm-laravel

Scout Application Performance Monitoring Agent - https://scoutapm.com

23831.3k](/packages/scoutapp-scout-apm-laravel)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
