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

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

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

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

v1.2.0(2mo ago)52.4k↓31%2[8 issues](https://github.com/nivseb/lara-monitor/issues)[1 PRs](https://github.com/nivseb/lara-monitor/pulls)MITPHPPHP ^8.2CI failing

Since Dec 31Pushed 3w 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 3d ago

READMEChangelog (10)Dependencies (28)Versions (40)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

47

—

FairBetter than 93% of packages

Maintenance71

Regular maintenance activity

Popularity27

Limited adoption so far

Community15

Small or concentrated contributor base

Maturity63

Established project with proven stability

 Bus Factor1

Top contributor holds 76.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 ~29 days

Total

17

Last Release

70d 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 (65 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (17 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

[psalm/plugin-laravel

Psalm plugin for Laravel

3355.3M346](/packages/psalm-plugin-laravel)[laravel/ai

The official AI SDK for Laravel.

1.0k3.2M201](/packages/laravel-ai)[spatie/laravel-health

Monitor the health of a Laravel application

87512.0M167](/packages/spatie-laravel-health)[moonshine/moonshine

Laravel administration panel

1.3k253.1k81](/packages/moonshine-moonshine)[inspector-apm/inspector-laravel

Code Execution Monitoring, built for developers.

2382.1M5](/packages/inspector-apm-inspector-laravel)[illuminate/log

The Illuminate Log package.

6225.3M625](/packages/illuminate-log)

PHPackages © 2026

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