New Relic APM monitoring of Swoole web-server

1.4.0 2019-05-28 17:43 UTC

This package is not auto-updated.

Last update: 2020-01-07 20:45:45 UTC


This library enables monitoring of PHP applications powered by Swoole web-server via New Relic products.


  • New Relic APM integration
  • New Relic Browser integration


New Relic APM dashboard


The library is to be installed via Composer as a dependency:

composer require upscale/swoole-newrelic


Monitoring of all incoming requests from start to finish can be activated via a few lines of code in the server entry point. The monitoring instrumentation is by design completely transparent to an application running on the server.

Install the monitoring instrumentation for all requests:

use Upscale\Swoole\Newrelic;

$page = <<<HTML
<!DOCTYPE html>
<html lang="en">
    <meta charset="UTF-8">
    <title>Example page</title>
    Served by Swoole server


$server = new \Swoole\Http\Server('', 8080);
$server->on('request', function ($request, $response) use ($page) {
    // PHP processing within request boundary...
    usleep(1000 * rand(100, 300));
    // Send response
    // PHP processing outside of request boundary...
    usleep(1000 * rand(50, 150));

// Real user monitoring (RUM)
$rum = new Newrelic\Browser(new Newrelic\Browser\TransactionFactory());

// Application performnce monitoring (APM)
$apm = new Newrelic\Apm(new Newrelic\Apm\TransactionFactory());

unset($rum, $apm);


APM instrumentation can be used standalone or in conjunction with the Browser. Browser must be instrumented first.

Browser instrumentation is applied to non-AJAX requests having text/html response MIME type (Swoole default).


Concurrent requests subject to coroutine multi-tasking are reported as part of the first in-flight transaction.


Pull Requests with fixes and improvements are welcome!


Copyright © Upscale Software. All rights reserved.

Licensed under the Apache License, Version 2.0.