Troubleshooting for Blackfire users on Platform.sh
⚠️ This troubleshooting guide is designed solely for users of Platform.sh. If your code is not hosted on that platform, please refer to our standard troubleshooting guide.
1. Bypassing Reverse Proxy, Cache, and Content Delivery Networks (CDN)
If you are using one of those, you will need them to let Blackfire access your servers. More information on how to configure a bypass.
2. HTTP Cache configuration
If you are using the HTTP cache with cookies , please update in your .platform.app.yaml the cookies that are allowed to go through the cache. You need to allow the __blackfire cookie name.
Something like:
cache:
enabled: true
cookies: [“/SESS.*/“, “__blackfire”]
3. Sending us the Blackfire logs
If the above didn't help, please send us:
-
The output of
platform ssh -- php -d display_startup_errors=on --ri blackfirecommand -
The Blackfire logs
Getting the Blackfire logs
Please execute the following in the environment where you're facing the issue:
-
platform variable:create --name php:blackfire.log_file --value /tmp/blackfire.log -
platform variable:create --name php:blackfire.log_level --value 4 -
start a profile/build again
You will get the logs we need with platform ssh -- cat /tmp/blackfire.log > blackfire.log
Please send them via the chat here, or to support@blackfire.io.
Disabling the Blackfire logs
Once you are done, please disable logging with:
-
platform variable:delete php:blackfire.log_file -
platform variable:delete php:blackfire.log_level