From b1d5fa0362bd7aa0a8c9706db862878bcadcb52f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=C5=81ukasz=20Bajsarowicz?= Date: Sun, 22 Mar 2026 21:04:10 +0100 Subject: [PATCH 1/2] docs: add browser profiling section to Blackfire guide Document how to use Blackfire browser extensions for profiling, including the Chrome Manifest V3 limitation that disables "Profile all requests" and the recommendation to use Firefox for full session profiling support. --- configuration/blackfire.md | 21 ++++++++++++++++++++- 1 file changed, 20 insertions(+), 1 deletion(-) diff --git a/configuration/blackfire.md b/configuration/blackfire.md index 6acbea7..69c54d8 100644 --- a/configuration/blackfire.md +++ b/configuration/blackfire.md @@ -19,4 +19,23 @@ Note: You can obtain the IDs and Tokens used in the above from within your Black To use the Blackfire CLI Tool, you can run `warden blackfire [arguments]`. -For more information on the CLI tool, please see [Profiling CLI Commands](https://blackfire.io/docs/cookbooks/profiling-cli) in Blackfire's documentation. +For more information on the CLI tool, please see [Profiling CLI Commands](https://blackfire.io/docs/cookbooks/profiling-cli) in Blackfire's documentation. + +## Browser Profiling + +Blackfire provides browser extensions that let you profile any page directly from the toolbar. Install the extension for your browser, log in to your Blackfire account, navigate to the page you want to profile, and click the **Profile** button in the extension. + +For a full walkthrough, see [Profiling HTTP Requests with a Browser](https://docs.blackfire.io/profiling-cookbooks/profiling-http-via-browser) in Blackfire's documentation. + +### Browser extensions + + * [Firefox extension](https://docs.blackfire.io/integrations/browsers/firefox) — **recommended**, supports all profiling features including **Profile all requests** (POST, Ajax, API calls) + * [Chrome extension](https://docs.blackfire.io/integrations/browsers/chrome) — single-page profiling works, but **Profile all requests** is unavailable (see below) + +### Chrome limitation + +Chrome's Manifest V3 restricts extensions from modifying outgoing request headers, which breaks the **Profile all requests** feature. This means Chrome can only profile the initial page load — it cannot capture follow-up POST requests, Ajax calls, or API requests within a session. + +Single-page profiling (clicking **Profile** on a specific URL) still works normally in Chrome. + +If your workflow relies on profiling all requests in a session, **use Firefox** where this feature remains fully supported. For more details, see [Announcing changes to the "Profile all requests" feature on Chrome](https://blog.blackfire.io/announcing-changes-to-the-profile-all-requests-feature-on-chrome.html) on the Blackfire blog. From eca3af36fe23b3d0edd9e0bf7bb700dd5b96b69c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=C5=81ukasz=20Bajsarowicz?= Date: Sun, 22 Mar 2026 21:07:11 +0100 Subject: [PATCH 2/2] docs: wrap Chrome limitation in warning admonition box --- configuration/blackfire.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/configuration/blackfire.md b/configuration/blackfire.md index 69c54d8..59a067b 100644 --- a/configuration/blackfire.md +++ b/configuration/blackfire.md @@ -34,8 +34,8 @@ For a full walkthrough, see [Profiling HTTP Requests with a Browser](https://doc ### Chrome limitation -Chrome's Manifest V3 restricts extensions from modifying outgoing request headers, which breaks the **Profile all requests** feature. This means Chrome can only profile the initial page load — it cannot capture follow-up POST requests, Ajax calls, or API requests within a session. - -Single-page profiling (clicking **Profile** on a specific URL) still works normally in Chrome. +:::{warning} +Chrome's Manifest V3 restricts extensions from modifying outgoing request headers, which breaks the **Profile all requests** feature. Chrome can only profile the initial page load — it cannot capture follow-up POST requests, Ajax calls, or API requests within a session. Single-page profiling still works normally. If your workflow relies on profiling all requests in a session, **use Firefox** where this feature remains fully supported. For more details, see [Announcing changes to the "Profile all requests" feature on Chrome](https://blog.blackfire.io/announcing-changes-to-the-profile-all-requests-feature-on-chrome.html) on the Blackfire blog. +:::