Profiling your project with Blackfire

When we are working on a project and this project start experiencing performance issues, we often need to do some profiling procedure to try to find the problem that is affecting our project. The configuration of profiling tools frequently consume a lot of our time so, what if we improve that setup time and have understandable profiling results? That's what we did when Blackfire was included to this project.

Blackfire is a profiling tool that allows us to profile in a really easy way, if you want to know more about blackfire you could visit the Blackfire documentation.

Configuring Blackfire

  • First of all, you need to create a new Blackfire account.
  • Go to your settings page and find the Credentials page (
  • Once you're on the credentials page, as you can see, there are some keys for different purposes, in this case you only need the server related keys, specifically the Server ID and the Server Token.
  • Copy the server ID and the server token and assign those values to environment variables BLACKFIRE_SERVER_ID and BLACKFIRE_SERVER_TOKEN into the .env file in the root path of your project.
  • If you already have the humpback environment up, please turn it off using ahoy stop and then start it again using ahoy up, this is because the environment variables are loaded only during the ahoy up process.
  • Now install the Companion browser plugin, if you use Google Chrome use the Chrome Companion guide and if you use Firefox, then use the Firefox Companion guide.
  • Once the browser plugin is installed, you should be able to execute the profiling process over any page of your project just by pressing the Blackfire profile button in the toolbar of your browser.

Enjoy your profiling!!!