Scout Laravel APM Agent
Monitor the performance of PHP Laravel applications with Scout's PHP APM Agent. Detailed performance metrics and transaction traces are collected once the scout-apm package is installed and configured.
Requirements
- PHP Version: PHP 7.1+
- Laravel Version: 5.5+
Quick Start
A Scout account is required. Signup for Scout.
composer require scoutapp/scout-apm-laravel
Then use Laravel's artisan vendor:publish to ensure configuration can be cached:
php artisan vendor:publish --provider="Scoutapm\Laravel\Providers\ScoutApmServiceProvider"
Composer 2 and PHP 7.1-7.3 support
If you are using PHP 7.1, 7.2, or 7.3, and you have started using Composer v2, please read this. scoutapp/scout-apm-php depends on a package called ocramius/package-versions. However, this package only provides support for the new Composer 2 series in version 1.8 or above, which requires PHP 7.4 as a minimum. If you are using PHP 7.1-7.3, and you would like to use Composer 2, you have the following options:
- Upgrade to PHP 7.4 (this is the recommended approach!)
- Don't use Composer 2 (stick to Composer 1)
- Require the polyfill
composer/package-versions-deprecated(provides support for Composer 2 in PHP 7.1-7.3)
If you opt to use the polyfill, you would install both packages, for example:
composer require scoutapp/scout-apm-laravel composer/package-versions-deprecated
Configuration
In your .env file, make sure you set a few configuration variables:
SCOUT_KEY=ABC0ZABCDEFGHIJKLMNOP
SCOUT_NAME="My Laravel App"
SCOUT_MONITOR=true
Your key can be found in the Scout organization settings page.
Logging Verbosity
Once you have set up Scout and are happy everything is working, you can reduce the verbosity of the library's logging system. The library is intentionally very noisy by default, which gives us more information to support our customers if something is broken. However, if everything is working as expected, these logs can be reduced by setting the log_level configuration key to a higher Psr\Log\LogLevel. For example, if you are using .env configuration:
SCOUT_LOG_LEVEL=error
Or if you are using config/scout_apm.php:
$config[\Scoutapm\Config\ConfigKey::LOG_LEVEL] = \Psr\Log\LogLevel::ERROR;
Any of the constants defined in \Psr\Log\LogLevel are acceptable values for this configuration option.
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.
Capabilities
The Laravel library:
- Registers a service
\Scoutapm\ScoutApmAgent::classinto the container (useful for dependency injection) - Provides a Facade
\Scoutapm\Laravel\Facades\ScoutApm - Wraps view engines to monitor view rendering times
- Injects several middleware for monitoring controllers and sending statistics to the Scout Core Agent
- Adds a listener to the database connection to instrument SQL queries
Custom Instrumentation
In order to perform custom instrumentation, you can wrap your code in a call to the instrument method. For example, given some code to be monitored:
$request = new ServiceRequest();
$request->setApiVersion($version);
Using the provided Facade for Laravel, you can wrap the call and it will be monitored.
// At top, with other imports
use Scoutapm\Events\Span\Span;
use Scoutapm\Laravel\Facades\ScoutApm;
// Replacing the above code
$request = ScoutApm::instrument(
'Custom',
'Building Service Request',
static function (Span $span) use ($version) {
$request = new ServiceRequest();
$request->setApiVersion($version);
return $request;
}
);
362 Jan 4, 2023
240 Nov 25, 2022
1.3k Jan 4, 2023
511 Dec 31, 2022
354 Nov 16, 2022
1k Dec 27, 2022
1.3k Dec 31, 2022
533 Nov 25, 2022
197 Dec 19, 2022
171 Jan 4, 2023
592 Dec 25, 2022
215 Sep 8, 2022
844 Dec 25, 2022
6 Mar 18, 2022
2 Jan 14, 2022
1.1k Dec 31, 2022
197 Jan 1, 2023
6 Nov 2, 2022