Not seeing data? Email firstname.lastname@example.org with:
- A link to your app within Scout (if applicable)
- Your PHP version
- The name of the framework and version you are trying to instrument, e.g. Laravel 5.8
- Scout debug logs
We typically respond within a couple of hours during the business day.
Common issues while getting started:
Unable to launch the core agent
The Scout PHP agent attempts to automatically download and launch the
core-agent binary. The most common issue with the core agent is that the default directory the Scout agent uses does not have the correct permissions for downloading and launching the core agent. The solution for this is to create or identify an appropriate directory that the PHP agent can use to download and execure the core agent, and indicate that in the core_agent_dir configuration directive.
All of the core agent configuration options can be found here
You can find more in-depth information on the core agent here
Additional Instrumentation with the PHP Extension
The Scout APM PHP Extension allows instrumentation of internal PHP functions that can’t be done in regular PHP. While it is optional, in order to get the full amount of instrumnted library support out of the box, you may want to install the Scout PHP Extension. The Scout PHP Extension adds instrumentation for:
- Core functions:
- Curl functions:
- PDO methods:
- Predis PHP library methods
- phpredis PHP extension methods
- Memcached PHP extension methods
- Elasticsearch PHP library methods
Compiling cURL support (Scout PHP Extension)
You will need the correct cURL libraries installed prior to compiling the Scout PHP Extension. Please refer to the extension’s Readme for details.
In order to assist in troubleshooting and installation, the Scout PHP agent is extremely verbose by default. Once you have the Scout PHP agent working, you will likely want to reduce the log verbosity levels. Instructions can be found here
To set Scout’s log level to debug, set the log_level configuration to
Scout’s log level defaults to the same log level as the LoggerInterface provided, if you aren’t seeing debug log levels from Scout, you will need to lower your LoggerInterface’s log level as well.
In some cases, debug level logs from the PHP agent may not be enough, and trace level core-agent logs may be needed.
In certain cases, knowing the payload that is being sent to the core agent is useful for debugging. To capture the payload (the request), set