Blackfire provides an official buildpack for Heroku. This buildpack lets you configure and use the Blackfire Agent and the Blackfire CLI Tool. It is complementary to other builpacks, such as official language support buildpacks provided by Heroku.
Configure the Blackfire credentials from your project root directory:
You may use your Blackfire personal server credentials or environment server credentials.
Add the Blackfire buildpack to your project:
1
Blackfire being part of the default PHP buildpack, if you are using PHP you don't need to add the Blackfire buildpack. Read more details below.
As documented in Heroku devcenter, when using multiple buildpacks, the buildpack for the primary language of your app should be the last one added.
PHP
Blackfire is part of the default Heroku PHP buildpack.
To enable Blackfire when using the PHP official Heroku buildpack, add it as a
requirement in the project's composer.json file:
1
Python
Install the Blackfire Probe by referring blackfire as dependency in your
requirements.txt file, e.g.:
1 2 3 4
blackfire
django
jinja2
gunicornTo set your config vars, you may use heroku config:set command.
You may also define them in your app dashboard, in the Settings tab.
Each time you set or update a config var, you must
redeploy your app on Heroku, using a git push heroku master.
The following configuration vars must be set:
BLACKFIRE_SERVER_IDBLACKFIRE_SERVER_TOKENBLACKFIRE_CLIENT_IDBLACKFIRE_CLIENT_TOKENBLACKFIRE_LOG_LEVELBLACKFIRE_COLLECTORBLACKFIRE_AGENT_SOCKETFind more details in Blackfire Agent configuration documentation.
Log files are located in your app at /app/.blackfire/var/log.
Profile using the regular Blackfire CLI tools or a browser (Firefox or Chrome).