Blackfire has built-in support for Adobe Commerce Cloud projects.
The Blackfire Agent is already installed and enabled by default on all Adobe Commerce Cloud accounts.
To activate the Blackfire Probe on integration branches, add the blackfire
PHP extension in your .magento.app.yaml project file:
1 2 3runtime: extensions: - blackfireThe Blackfire Probe can be installed and enabled by developers on any branch in the Starter architecture and only integration branches on Pro architecture.
To install it on dedicated Staging and Production environments on Pro architecture submit a request to Adobe Commerce help center.
Set the Blackfire server credentials as environment variables, for each branch on which you want to configure Blackfire.
To verify performance on each deployment, run
Blackfire Player with the
--report option from your Adobe Commerce Cloud deploy hook or CI pipeline.
Point Player at the deployed environment with --endpoint so it profiles your
scenarios after every push, merge, or redeploy event, and gate the
job on its exit code.
For any issue related to Adobe Commerce Cloud, please check our dedicated support documentation.