PHPackages                             flightphp/apm - 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. flightphp/apm

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

flightphp/apm
=============

High-Performance Application Performance Monitoring (APM) for Flight PHP for better observability in your applications.

v0.5.1(2mo ago)4566↓77.1%1MITPHPPHP >=7.4

Since Mar 14Pushed 2mo ago2 watchersCompare

[ Source](https://github.com/flightphp/apm)[ Packagist](https://packagist.org/packages/flightphp/apm)[ Docs](https://docs.flightphp.com/awesome-plugins/apm)[ RSS](/packages/flightphp-apm/feed)WikiDiscussions master Synced 2d ago

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

FlightPHP APM
=============

[](#flightphp-apm)

[![Latest Stable Version](https://camo.githubusercontent.com/99d955057af4cbf42a549d0c269ae5c767d21276162ef594c94e09f50a120391/687474703a2f2f706f7365722e707567782e6f72672f666c696768747068702f61706d2f76)](https://packagist.org/packages/flightphp/apm)[![License](https://camo.githubusercontent.com/02f4b02aa9a17a93e0cb844d4d943a4cfe7849fe7c07d5ec8099a25af1c7e0aa/68747470733a2f2f706f7365722e707567782e6f72672f666c696768747068702f61706d2f6c6963656e7365)](https://packagist.org/packages/flightphp/apm)[![PHP Version Require](https://camo.githubusercontent.com/ace36d5c2f3131074811713c2c175d351c846e422f05162db786050d93ec3f03/687474703a2f2f706f7365722e707567782e6f72672f666c696768747068702f61706d2f726571756972652f706870)](https://packagist.org/packages/flightphp/apm)[![Dependencies](https://camo.githubusercontent.com/bdd9265b44ace52610c56236bbea388bf180e9ae26cb681a7054799a2570da53/687474703a2f2f706f7365722e707567782e6f72672f666c696768747068702f61706d2f646570656e64656e7473)](https://packagist.org/packages/flightphp/apm)

A lightweight Application Performance Monitoring (APM) library for the [FlightPHP](https://github.com/flightphp/core) framework. Keep your app fast, spot bottlenecks, and sleep better at night!

What is FlightPHP APM?
----------------------

[](#what-is-flightphp-apm)

FlightPHP APM helps you track how your app performs in real-time—think of it as a fitness tracker for your code! It logs metrics like request times, memory usage, database queries, and custom events, then gives you a slick dashboard to see it all. Why care? Because slow apps lose users, and finding performance hiccups *before* they bite saves you headaches (and maybe a few angry emails).

Built to be fast and simple, it slots right into your FlightPHP project with minimal fuss.

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

[](#installation)

Grab it with Composer:

```
composer require flightphp/apm
```

Quick Start
-----------

[](#quick-start)

1. **Log APM Metrics**
    Add this to your `index.php` or services file to start tracking:

    ```
    use flight\apm\logger\LoggerFactory;
    use flight\Apm;

    $ApmLogger = LoggerFactory::create(__DIR__ . '/../../.runway-config.json');
    $Apm = new Apm($ApmLogger);
    $Apm->bindEventsToFlightInstance($app);
    ```
2. **Set Up Config**
    Run this to create your `.runway-config.json`:

    ```
    php vendor/bin/runway apm:init
    ```
3. **Process Metrics**
    Fire up the worker to crunch those metrics (runs once by default):

    ```
    php vendor/bin/runway apm:worker
    ```

    Want it continuous? Try `--daemon`:

    ```
    php vendor/bin/runway apm:worker --daemon
    ```
4. **View Your Dashboard**
    Launch the dashboard to see your app’s pulse:

    ```
    php vendor/bin/runway apm:dashboard --host localhost --port 8001
    ```

Keeping the Worker Running
--------------------------

[](#keeping-the-worker-running)

The worker processes your metrics—here’s how to keep it humming:

- **Daemon Mode**: `php vendor/bin/runway apm:worker --daemon` (runs forever!)
- **Crontab**: `* * * * * php /path/to/project/vendor/bin/runway apm:worker` (runs every minute)
- **Tmux/Screen**: Start it in a detachable session with `tmux` or `screen` for easy monitoring.

Requirements
------------

[](#requirements)

- PHP 7.4 or higher
- [FlightPHP Core](https://github.com/flightphp/core) v3.15+

Supported Databases
-------------------

[](#supported-databases)

FlightPHP APM currently supports the following databases for storing metrics:

- **SQLite3**
- **MySQL/MariaDB**

Documentation
-------------

[](#documentation)

Want the full scoop? Check out the [FlightPHP APM Documentation](https://docs.flightphp.com/awesome-plugins/apm) for setup details, worker options, dashboard tricks, and more!

Community
---------

[](#community)

Join us on [Matrix IRC #flight-php-framework:matrix.org](https://matrix.to/#/#flight-php-framework:matrix.org) to chat, ask questions, or share your APM wins!

[![](https://camo.githubusercontent.com/b9224d186635fc3ca4179e68b13cbc04b00a742ca8e025045c0adfdef37fcb1e/68747470733a2f2f646362616467652e6c696d65732e70696e6b2f6170692f7365727665722f68747470733a2f2f646973636f72642e67672f597372347a7148666258)](https://discord.gg/Ysr4zqHfbX)

License
-------

[](#license)

MIT—free and open for all!

###  Health Score

40

—

FairBetter than 86% of packages

Maintenance83

Actively maintained with recent releases

Popularity23

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity36

Early-stage or recently created project

 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 ~28 days

Recently: every ~55 days

Total

15

Last Release

86d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/2322095?v=4)[n0nag0n](/maintainers/n0nag0n)[@n0nag0n](https://github.com/n0nag0n)

---

Top Contributors

[![n0nag0n](https://avatars.githubusercontent.com/u/2322095?v=4)](https://github.com/n0nag0n "n0nag0n (56 commits)")

---

Tags

apmapplication-performance-monitoringflightphpmariadbmysqlphpsqlitephpmonitoringperformanceapmSimpleflightapplicationlightweightmonitorobservabilityperformance-monitoringapplication performanceApplication performance monitorapplication performance monitoring

###  Code Quality

TestsPHPUnit

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/flightphp-apm/health.svg)

```
[![Health](https://phpackages.com/badges/flightphp-apm/health.svg)](https://phpackages.com/packages/flightphp-apm)
```

###  Alternatives

[inspector-apm/inspector-php

Inspector monitoring for PHP applications.

353.0M31](/packages/inspector-apm-inspector-php)[scoutapp/scout-apm-php

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

17888.4k5](/packages/scoutapp-scout-apm-php)[tobiasdierich/gauge

An easy to use application performance monitor.

14413.1k](/packages/tobiasdierich-gauge)

PHPackages © 2026

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