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 (https://blackfire.io/my/settings/credentials)
- 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
andBLACKFIRE_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 usingahoy up
, this is because the environment variables are loaded only during theahoy 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!!!