Download the PHP package scoutapp/scout-apm-php without Composer

Scout PHP APM Agent

Email us at [email protected] to get on the beta invite list!

Monitor the performance of PHP apps with Scout's PHP APM Agent.

Detailed performance metrics and transaction traces are collected once the agent is installed and configured.

Requirements

PHP Versions: 7.2+

Quick Start

This package is the base library for the various framework-specific packages.

Laravel, Lumen, Symfony support

To install the ScoutAPM Agent for a specific framework, use the specific package instead.

• Laravel
• Lumen
• Symfony

Using the base library directly

Default log level

By default, the library is very noisy in logging by design - this is to help us figure out what is going wrong if you need assistance. If you are confident everything is working, and you can see data in your Scout dashboard, then you can increase the minimum log level by adding the following configuration to set the "minimum" log level (which only applies to Scout's logging):

Monitoring of PHP internal functions

You can enable additional monitoring of internal PHP function executions to measure time taken there. To do so, you need to install and enable the scoutapm PHP extension from PECL, for example:

You may need to add zend_extension=scoutapm.so into your php.ini to enable the extension.

With the extension enabled, specific IO-bound functions in PHP are monitored, for example file_get_contents, file_put_contents, PDO->exec and so on.

Alternatively, you can install from source.

Enable caching for Scout

Due to PHP's stateless and "shared-nothing" architecture, the Scout library performs some checks (such as sending some metadata about the running system) on every request. These can be eliminated by giving Scout a PSR-16 (Simple Cache) implementation when creating the agent:

Using the PSR-15 Middleware provided

Since scoutapp/scout-apm-php release version 8.1.0, a PSR-15 compatible middleware is included out the box, which may be used in a PSR-15 middleware-compatible framework, such as Slim or Mezzio. For example, in Slim framework:

You will very likely need to define \Scoutapm\Middleware\ScoutApmMiddleware::class in your container. For example, if your container is Laminas ServiceManager, you could define a factory like:

Documentation

For full installation and troubleshooting documentation, visit our help site.

Support

Please contact us at [email protected] or create an issue in this repo.