Google Chrome

Using a Web Browser is the easiest way to profile web applications. Blackfire supports Google Chrome and Firefox.

Installing the Chrome Extension

Install the Blackfire Extension from the Google Chrome Web Store:

Install the Extension

If you are using Blackfire On-Premises, setup the Extension Collector:

  1. Once the extension is installed, right click on the Extension icon in Chrome Menu and choose Options;
  2. Change the Collector option to your Blackfire instance then click Save.

Upgrading the Extension

The Google Chrome extension should be automatically updated by the Google Chrome Scheduler. However, if a new version is available and your browser doesn’t update it, please follow these steps to force the update:

  • Open chrome://extensions in a new browser tab;
  • Check the Developer mode at the top right of the screen;
  • Click the Update extensions now button.

Content Security Policy

The browser extension injects a toolbar in the profiled webpage and uses an <iframe> to communicate with the probe.

In case the web page declares a Content Security Policy regarding frames usages, the communication may be broken and you would be informed in the toolbar.

In this case, you can declare Blackfire domain as trusted by adding the blackfire.io domain in your application’s headers:

1
Content-Security-Policy: frame-src 'self' blackfire.io