How can we help you today?

How to use Blackfire on Hypernode to find performance issues

Created by: Lianne van Looij

Modified on: Thu, 6 Aug, 2020 at 2:44 PM

All Hypernodes (except the Magento Start plan) support Blackfire, an amazing tool to find performance bottlenecks in Magento. It is similar to New Relic, but much better suited for troubleshooting.

Hypernode customers can get a 20% discount on the Premium plan. Contact for a coupon code.


How to activate Blackfire

First, signup for an account. Start with the free version, which includes a wealth of information. In your account tab, you will see this:

Activate via the hypernode-systemctl tool

You can activate Blackfire via the hypernode-systemctl tool. First you need to enable it, then add your Server ID and Server Token.

  • blackfire_enabled: boolean – Indicates whether BlackFire is enabled on your node.
  • blackfire_server_id: string – The BlackFire Server ID for your Blackfire setup.
  • blackfire_server_token: string – The BlackFire Server Token for your Blackfire setup.

Activate via your Service Panel (for Customers)

To connect your Hypernode to Blackfire, login on our Service Panel and select Instellingen -> Blackfire.

From this page, select Enable, insert your Server ID and Server Token.

Next, save the input by clicking Opslaan and wait a few minutes until the credentials are active on the Hypernode:

Activate via your Control Panel (for Customers)

  1. Log in on the Control Panel
  2. Select your Hypernode ( under My Hypernodes and click on the Go button
  3. Go to Monitoring in the side menu
  4. Click on the Blackfire option.
  5. Enter your Blackfire Server ID and Blackfire Server Token in your Control Panel and click save
  6. Now select Enable Blackfire to enable Blackfire

Please take into account that it takes a most 10 minutes for our system to actually create the account. Grab a cup of coffee and relax!

How is it different from New Relic?

New Relic is an Application Performance Monitoring utility. It is made to track real traffic, and to provide alerts and a first level of insight to business managers and developers. Analyzing the performance of an application’s code requires to instrument the code, which generates an overhead.

The more precise data is gathered, the slowest the app gets.

Therefore, analyzing all of the traffic makes it impossible to get pin-point information on the code’s resources consumption.

Blackfire works in a very different manner, and is therefore very complementary. End users requests are not instrumented; only the requests triggered by the developer or tool requiring performance information are. Blackfire’s profiling technology thereby provides and unequaled code introspection, and enables developers to understand the behavior of their code and identify optimization possibilities very fast. Blackfire is usable in production, just like New Relic, but provides an even better value-add in development in staging, through the use of performance tests, which proactively validate the code, before any go-live.

For more information, check the Blackfire documentation.

Using Blackfire with Varnish

If you want to use Varnish in combination with Blackfire, some additional configuration in your VCL is required.

This is quite an expert level change and requires enough experience with varnish to manually edit your VCL.

acl profile {
sub vcl_recv {
  if (req.http.X-Blackfire-Query && client.ip ~ profile) {
    if (req.esi_level > 0) {
        # ESI request should not be included in the profile.
        # Instead you should profile them separately, each one
        # in their dedicated profile.
        # Removing the Blackfire header avoids to trigger the profiling.
        # Not returning let it go trough your usual workflow as a regular
        # ESI request without distinction.
        unset req.http.X-Blackfire-Query;
    } else {
        return (pass);

You can find the extended instructions in the Blackfire documentation

Lianne is the author of this solution article.

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.