CLI

Version 2026.4.2

  • Update dependencies
  • Upgrade epoch number for client package
  • Display the current version of the agent in log
  • Display deprecation message about builds

Released by Blackfire on Tue, 21 Apr 2026 16:00:00 +0200

Version 2026.4.1

  • Update links used for displaying the Graph URL

Released by Blackfire on Thu, 09 Apr 2026 06:00:00 +0200

Version 2026.4.0

  • Add `blackfire profile:list` command
  • Internal releasing changes

Released by Blackfire on Tue, 07 Apr 2026 09:00:00 +0200

Version 2026.3.2

  • Add server credentials fallback to `blackfire run` and `blackfire curl`
  • Make self:update and php:install commands atomic
  • Internal releasing changes

Released by Blackfire on Tue, 31 Mar 2026 13:00:00 +0200

Version 2026.3.1

  • Add profile:* commands
  • Update dependencies
  • Internal releasing changes

Released by Blackfire on Mon, 30 Mar 2026 12:00:00 +0200

Version 2026.3.0

  • Update dependencies
  • Internal releasing changes
  • Switch versioning to calver

Released by Blackfire on Tue, 10 Mar 2026 08:00:00 +0200

Version 2.30.3

  • Fix blackfire run command
  • Internal releasing changes

Released by Blackfire on Thu, 26 Feb 2026 08:00:00 +0200

Version 2.30.2

  • Fix profiling for very large organizations
  • Internal releasing changes

Released by Blackfire on Wed, 18 Feb 2026 15:00:00 +0200

Version 2.30.1

  • Internal releasing changes

Released by Blackfire on Tue, 23 Dec 2025 10:00:00 +0200

Version 2.30.0

  • Fix permission issue in distribution packaging
  • Add a command to self-update to the latest available version

Released by Blackfire on Mon, 22 Dec 2025 10:00:00 +0200

Version 2.29.9

  • Update CA certificates

Released by Blackfire on Thu, 11 Dec 2025 14:00:00 +0200

Version 2.29.8

  • Internal releasing changes

Released by Blackfire on Thu, 20 Nov 2025 15:00:00 +0200

Version 2.29.7

  • Internal releasing changes

Released by Blackfire on Thu, 20 Nov 2025 11:00:00 +0200

Version 2.29.6

  • Update dependencies
  • Internal releasing changes

Released by Blackfire on Thu, 20 Nov 2025 08:00:00 +0200

Version 2.29.5

  • Update dependencies
  • Internal releasing changes

Released by Blackfire on Wed, 19 Nov 2025 14:00:00 +0200

Version 2.29.4

  • Update dependencies
  • Internal releasing changes

Released by Blackfire on Wed, 12 Nov 2025 12:00:00 +0200

Version 2.29.3

  • Internal releasing changes
  • Update dependencies

Released by Blackfire on Wed, 05 Nov 2025 15:00:00 +0200

Version 2.29.2

  • Simplify signature of public profilable apps
  • Make the client aware of Profile's ingestion endpoint
  • Update dependencies
  • Add coverage for FPM scan dir
  • Mute startup errors on php probe installation
  • Ensure agents use the same version when printing doctor report
  • Update root CA

Released by Blackfire on Tue, 14 Oct 2025 12:00:00 +0200

Version 2.29.1

  • Update dependencies
  • Add a `agent:log-level` command to change agent log verbosity at runtime
  • Fix agent deprecation warning

Released by Blackfire on Mon, 15 Sep 2025 07:00:00 +0200

Version 2.29.0

  • New blackfire `doctor` command to help troubleshooting configuration issues
  • Improved profiles compression support
  • Update root CA
  • Update dependencies

Released by Blackfire on Wed, 27 Aug 2025 09:00:00 +0200

Version 2.28.31

  • Update dependencies

Released by Blackfire on Mon, 04 Aug 2025 08:00:00 +0200

Version 2.28.30

  • Update dependencies
  • Enable usage telemetry (`BLACKFIRE_ENABLE_TELEMETRY=0` to disable). As per our terms (https://blackfire.io/terms-of-service), we do not collect personal or project-identifying data.

Released by Blackfire on Thu, 31 Jul 2025 09:00:00 +0200

Version 2.28.29

  • Update dependencies
  • Internal releasing change
  • Add ping flag

Released by Blackfire on Tue, 08 Jul 2025 18:00:00 +0200

Version 2.28.28

  • Internal releasing change

Released by Blackfire on Wed, 25 Jun 2025 09:00:00 +0200

Version 2.28.27

  • Internal releasing changes

Released by Blackfire on Wed, 18 Jun 2025 10:00:00 +0200

Version 2.28.26

  • Internal releasing changes

Released by Blackfire on Mon, 02 Jun 2025 12:00:00 +0200

Version 2.28.25

  • Update CA certificates
  • Internal releasing changes
  • Update dependencies

Released by Blackfire on Mon, 02 Jun 2025 07:00:00 +0200

Version 2.28.24

  • Improve the rate limit reached message
  • Update dependencies
  • Update CA certificates

Released by Blackfire on Wed, 14 May 2025 14:00:00 +0200

Version 2.28.23

  • Update dependencies
  • Update CA certificates

Released by Blackfire on Tue, 28 Jan 2025 08:00:00 +0200

Version 2.28.22

  • Update dependencies

Released by Blackfire on Mon, 23 Dec 2024 09:00:00 +0200

Version 2.28.21

  • Update dependencies
  • Update ca-certificate

Released by Blackfire on Wed, 04 Dec 2024 12:00:00 +0200

Version 2.28.20

  • Update dependencies

Released by Blackfire on Mon, 25 Nov 2024 14:00:00 +0200

Version 2.28.19

  • Update dependencies

Released by Blackfire on Thu, 14 Nov 2024 10:00:00 +0200

Version 2.28.18

  • Reduce verbosity of agent logs when APM is not enabled
  • Update dependencies

Released by Blackfire on Tue, 05 Nov 2024 16:00:00 +0200

Version 2.28.17

  • Update dependencies

Released by Blackfire on Mon, 28 Oct 2024 09:00:00 +0200

Version 2.28.16

  • Update dependencies

Released by Blackfire on Thu, 24 Oct 2024 12:00:00 +0200

Version 2.28.15

  • Update dependencies
  • Improve error message when php-cli is not present

Released by Blackfire on Mon, 21 Oct 2024 11:00:00 +0200

Version 2.28.14

  • Update dependencies

Released by Blackfire on Mon, 14 Oct 2024 10:00:00 +0200

Version 2.28.13

  • Update dependencies
  • Discard unused parts in Conprof. payload in Agent

Released by Blackfire on Mon, 07 Oct 2024 09:00:00 +0200

Version 2.28.12

  • Update dependencies

Released by Blackfire on Wed, 18 Sep 2024 08:00:00 +0200

Version 2.28.11

  • Update dependencies
  • Override remote config conprof endpoint with an env. var
  • Override remote config apm endpoint with an env. var
  • Bridge `zap.Logger` with Agent's `zerolog`

Released by Blackfire on Mon, 05 Aug 2024 12:00:00 +0200

Version 2.28.10

  • Internal releasing changes
  • Update dependencies
  • Use same sort order for CLI output

Released by Blackfire on Wed, 31 Jul 2024 08:00:00 +0200

Version 2.28.9

  • Internal releasing changes
  • Add serverId in debug log on requesting API

Released by Blackfire on Thu, 18 Jul 2024 09:00:00 +0200

Version 2.28.8

  • Update dependencies

Released by Blackfire on Mon, 08 Jul 2024 11:00:00 +0200

Version 2.28.7

  • Update dependencies

Released by Blackfire on Mon, 01 Jul 2024 10:00:00 +0200

Version 2.28.6

  • Internal releasing changes

Released by Blackfire on Fri, 21 Jun 2024 09:00:00 +0200

Version 2.28.5

  • Update dependencies
  • Fix timeout issue when backend is redeploying
  • Remove code related to APM endpoint

Released by Blackfire on Mon, 17 Jun 2024 09:00:00 +0200

Version 2.28.4

  • Update dependencies

Released by Blackfire on Mon, 03 Jun 2024 09:00:00 +0200

Version 2.28.3

  • Fix homebrew recipes
  • Remove compose deprecations
  • Update dependencies
  • Make jitter parameterizable

Released by Blackfire on Thu, 23 May 2024 15:00:00 +0200

Version 2.28.2

  • Update dependencies
  • Upgrade go version 1.22.2 -> 1.22.3
  • Add jitter in flush ticker

Released by Blackfire on Mon, 13 May 2024 07:00:00 +0200

Version 2.28.1

  • Internal releasing changes

Released by Blackfire on Mon, 06 May 2024 12:00:00 +0200

Version 2.28.0

  • Deprecate the sample flag a make it a no-op
  • Add Basic `Authorization` to the OTLP payload

Released by Blackfire on Mon, 06 May 2024 09:00:00 +0200

Version 2.27.0

  • Add an embedded Open Telemetry collector service
  • Prevent running systemd scripts when systemd is not running
  • Update dependencies
  • Remove debug statement

Released by Blackfire on Tue, 30 Apr 2024 09:00:00 +0200

Version 2.26.4

  • Always finish after-remove hook successfully

Released by Blackfire on Fri, 12 Apr 2024 07:00:00 +0200

Version 2.26.3

  • Internal releasing changes

Released by Blackfire on Wed, 10 Apr 2024 07:00:00 +0200

Version 2.26.2

  • Update dependencies

Released by Blackfire on Mon, 08 Apr 2024 12:00:00 +0200

Version 2.26.1

  • Update client certificates
  • Update dependencies

Released by Blackfire on Mon, 18 Mar 2024 13:00:00 +0200

Version 2.26.0

  • Print status on http err for blackfire curl
  • Distinguish monitoring configuration endpoint from ingestion endpoint

Released by Blackfire on Fri, 01 Mar 2024 12:00:00 +0200

Version 2.25.0

  • Enable heap and goroutine profiling in agent continuous profiling instrumentation
  • Remove references to experimental go conprof lib
  • Use backend's routes to configure the browser probe

Released by Blackfire on Fri, 02 Feb 2024 12:00:00 +0200

Version 2.24.4

  • Update dependencies
  • Internal releasing changes
  • Periodic refresh of the config
  • Remove default ingester endpoint

Released by Blackfire on Tue, 16 Jan 2024 12:00:00 +0200

Version 2.24.3

  • Update dependencies
  • Create Blackfire extension dir if missing

Released by Blackfire on Mon, 08 Jan 2024 12:00:00 +0200

Version 2.24.2

  • Update dependencies
  • Fix compatibility with Homebrew 4.2

Released by Blackfire on Wed, 20 Dec 2023 12:00:00 +0200

Version 2.24.1

  • Update dependencies

Released by Blackfire on Mon, 18 Dec 2023 12:00:00 +0200

Version 2.24.0

  • Add support for the Browser sample rate
  • Replace old documentation URLs
  • Fix APM config version length
  • Update dependencies

Released by Blackfire on Wed, 13 Dec 2023 12:00:00 +0200

Version 2.23.0

  • Forward JS probe location
  • Update dependencies

Released by Blackfire on Thu, 26 Oct 2023 12:00:00 +0200

Version 2.22.0

  • Improve trace upload retry strategy
  • Deprecate BLACKFIRE_TOKEN_ID environment variable
  • Use backend's batch size config
  • Purge APM bucket on ban

Released by Blackfire on Wed, 27 Sep 2023 12:00:00 +0200

Version 2.21.0

  • Add an env var to disable profile aggregation

Released by Blackfire on Tue, 22 Aug 2023 12:00:00 +0200

Version 2.20.0

  • Increase retry delays for env config update errors

Released by Blackfire on Thu, 03 Aug 2023 12:00:00 +0200

Version 2.19.0

  • Add jitter on Ban duration
  • Rate limit env config update

Released by Blackfire on Thu, 27 Jul 2023 12:00:00 +0200

Version 2.18.0

  • Update the thresholds for sending traces to the backend

Released by Blackfire on Mon, 24 Jul 2023 12:00:00 +0200

Version 2.17.0

  • Update APM config from Mercure events
  • Protect main APM bucket from deletion
  • Improve logs

Released by Blackfire on Wed, 12 Jul 2023 12:00:00 +0200

Version 2.16.2

  • Fix panic in realtime config update support

Released by Blackfire on Tue, 27 Jun 2023 12:00:00 +0200

Version 2.16.1

  • Disable the Monitoring according to the backend configuration

Released by Blackfire on Mon, 15 May 2023 12:00:00 +0200

Version 2.16.0

  • Support (near) realtime update of the Monitoring configuration

Released by Blackfire on Wed, 10 May 2023 12:00:00 +0200

Version 2.15.1

  • Display a warning when the 'php:install' command doesn't detect any PHP binaries
  • Increase rate-limiting delay

Released by Blackfire on Wed, 03 May 2023 12:00:00 +0200

Version 2.15.0

  • Use the endpoints provided by the backend
  • Fix uri header encoding

Released by Blackfire on Wed, 12 Apr 2023 12:00:00 +0200

Version 2.14.2

  • Fix an issue with releasing

Released by Blackfire on Thu, 30 Mar 2023 12:00:00 +0200

Version 2.14.1

  • Show a part of the credentials in logs in case of 401
  • Fix a bug with profile title

Released by Blackfire on Wed, 29 Mar 2023 12:00:00 +0200

Version 2.14.0

  • Use BLACKFIRE_SERVER_ID env var as fallback to select the environement with the "run" command
  • Improve logs
  • Update support URL
  • Update dependencies

Released by Blackfire on Wed, 08 Mar 2023 12:00:00 +0200

Version 2.13.2

  • Update dependencies

Released by Blackfire on Mon, 05 Dec 2022 12:00:00 +0200

Version 2.13.1

  • Detect macOS 13.0 Ventura
  • Prevent prolog headers override

Released by Blackfire on Wed, 16 Nov 2022 12:00:00 +0200

Version 2.13.0

  • Add support to the browser collector APM config
  • Update default span limit values
  • Add initial support for continuous profiling
  • Remove on-premise support
  • Fix "blackfire curl" command compatibility with CONNECT proxy

Released by Blackfire on Tue, 18 Oct 2022 12:00:00 +0200

Version 2.12.0

  • Add support for probe's profile cancellation request

Released by Blackfire on Wed, 28 Sep 2022 12:00:00 +0200

Version 2.11.0

  • Allow the agent to start even if the Blackfire backend is unavailable
  • Rate limit trace upload when the Blackfire backend is unavailable

Released by Blackfire on Tue, 20 Sep 2022 12:00:00 +0200

Version 2.10.1

  • Fix a race condition
  • Fix error message specific to PHP

Released by Blackfire on Wed, 24 Aug 2022 12:00:00 +0200

Version 2.10.0

  • Add an identifier to the trace batch
  • Enable the Healthcheck in the Docker image
  • Update bundled CA root certificates
  • Fix install/remove scripts with Systemd

Released by Blackfire on Tue, 07 Jun 2022 12:00:00 +0200

Version 2.9.0

  • Add the 'agent:healthcheck' command
  • Don't log an error when a connection with no write is done (It allows healtchecks, like Kubernetes Liveness probe)
  • Handle 'Payment Required' status from API
  • Handle 'distributed-profile' and 'debug-profile' key-page attributes

Released by Blackfire on Mon, 16 May 2022 12:00:00 +0200

Version 2.8.1

  • Fix setting "log-level" from config file not honored
  • Add a warning when the agent is started with log-level=5

Released by Blackfire on Wed, 27 Apr 2022 12:00:00 +0200

Version 2.8.0

  • Migrate blackfire/blackfire:latest docker image to Blackfire v2

Released by Blackfire on Wed, 20 Apr 2022 12:00:00 +0200

Version 2.7.1

  • Fix a memory leak
  • Improve WSL detection

Released by Blackfire on Wed, 06 Apr 2022 12:00:00 +0200

Version 2.7.0

  • Automatic-profling: lock key-pages by transaction

Released by Blackfire on Tue, 15 Mar 2022 12:00:00 +0200

Version 2.6.0

  • Anonymize credit cards
  • Fix Blackfire keys expiration
  • Fix panic with WaitGroup
  • Fix WSL detection in package scripts
  • Update symfony-cli dependencies
  • Change logger library

Released by Blackfire on Wed, 16 Feb 2022 12:00:00 +0200

Version 2.5.2

  • Fix amd64 Docker image

Released by Blackfire on Wed, 03 Nov 2021 12:00:00 +0200

Version 2.5.1

  • Update Certificate Authority certificates
  • Update dependencies (including macOS Monterey detection in osinfo)

Released by Blackfire on Thu, 21 Oct 2021 12:00:00 +0200

Version 2.5.0

  • Update default configuration on macOS arm64
  • Improve SQL queries sanitization
  • Log command's output in case of error

Released by Blackfire on Mon, 30 Aug 2021 12:00:00 +0200

Version 2.4.3

  • Fix header cases

Released by Blackfire on Thu, 01 Jul 2021 12:00:00 +0200

Version 2.4.2

  • Update log messages

Released by Blackfire on Thu, 24 Jun 2021 12:00:00 +0200

Version 2.4.1

  • Fix default values for timespan-limit-global and timespan-limit-per-rule settings

Released by Blackfire on Mon, 21 Jun 2021 12:00:00 +0200

Version 2.4.0

  • Reset the APM config when the agent is not authorized
  • Add support for timespan-limit-global and timespan-limit-per-rule settings
  • Update Certificate Authority certificates
  • Change the log level when the agent cannot collect a trace

Released by Blackfire on Mon, 14 Jun 2021 12:00:00 +0200

Version 2.3.1

  • Fix panic when anonymizing invalid data

Released by Blackfire on Wed, 02 Jun 2021 12:00:00 +0200

Version 2.3.0

  • Bump Go version to 1.16
  • Distribute darwin/arm64 (Apple Silicon) binary

Released by Blackfire on Mon, 24 May 2021 12:00:00 +0200

Version 2.2.0

  • The SysVInit script `/etc/init.d/blackfire-agent` has been restored and lives alongside systemd configuration
  • Add Archlinux package
  • Fix the Timespan Threshold computation
  • Fix error messages

Released by Blackfire on Thu, 22 Apr 2021 12:00:00 +0200

Version 2.1.0

  • Add a timeout when locking the profile and return a "wait" response if the lock cannot be acquired
  • Add logs to php:install command
  • Fix incorrect error message

Released by Blackfire on Fri, 02 Apr 2021 12:00:00 +0200

Version 2.0.0

  • Release 2.0.0 final

Released by Blackfire on Tue, 23 Mar 2021 12:00:00 +0200