CLI

For tools and AI agents: Markdown version

2026.10.1

  • Send usage telemetry for every command
  • Update dependencies

2026.10.0

  • Remove code related to build notification
  • Bump golang to 1.27
  • Update dependencies

2026.9.1

  • Add AI agent support: a blackfire mcp stdio server over the read-only commands and the blackfire-cli agent skill
  • Add env:list, profile:sql and profile:graph --focus, and make --env optional on profile:*
  • Output Markdown by default on the profile read commands
  • Rewrite the command help and add agent:events to ease self-troubleshooting
  • Point support links to support.blackfire.upsun.com
  • Update dependencies

2026.9.0

Maintenance release ·

2026.8.1

  • Remove orphan init.d scripts after update on systemd
  • Fix self-update race condition
  • Update dependencies

2026.8.0

  • Patch reported CVEs
  • Update dependencies; Internal releasing changes

2026.7.0

  • Do not drop APM traces when the first remote configuration fetch fails transiently
  • Support the regionalized profile payload format
  • Update dependencies

2026.6.1

  • Support regional agent
  • Update dependencies

2026.6.0

  • Add a selector to ease agent configuration
  • Bump to golang 1.26
  • Update dependencies

2026.5.1

Maintenance release ·

2026.5.0

  • Update default CARoots
  • Update dependencies

2026.4.2

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

2026.4.1

  • Update links used for displaying the Graph URL

2026.4.0

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

2026.3.2

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

2026.3.1

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

2026.3.0

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

2.30.3

  • Fix blackfire run command
  • Internal releasing changes

2.30.2

  • Fix profiling for very large organizations
  • Internal releasing changes

2.30.1

Maintenance release ·

2.30.0

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

2.29.9

  • Update CA certificates

2.29.8

Maintenance release ·

2.29.7

Maintenance release ·

2.29.6

Maintenance release ·

2.29.5

Maintenance release ·

2.29.4

Maintenance release ·

2.29.3

Maintenance release ·

2.29.2

  • Simplify signature of public profilable apps
  • Make the client aware of Profile's ingestion endpoint
  • 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
  • Update dependencies

2.29.1

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

2.29.0

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

2.28.31

Maintenance release ·

2.28.30

  • 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.
  • Update dependencies

2.28.29

  • Add ping flag
  • Update dependencies; Internal releasing change

2.28.28

Maintenance release ·

2.28.27

Maintenance release ·

2.28.26

Maintenance release ·

2.28.25

  • Update CA certificates
  • Internal releasing changes; Update dependencies

2.28.24

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

2.28.23

  • Update CA certificates
  • Update dependencies

2.28.22

Maintenance release ·

2.28.21

  • Update ca-certificate
  • Update dependencies

2.28.20

Maintenance release ·

2.28.19

Maintenance release ·

2.28.18

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

2.28.17

Maintenance release ·

2.28.16

Maintenance release ·

2.28.15

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

2.28.14

Maintenance release ·

2.28.13

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

2.28.12

Maintenance release ·

2.28.11

  • 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`
  • Update dependencies

2.28.10

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

2.28.9

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

2.28.8

Maintenance release ·

2.28.7

Maintenance release ·

2.28.6

Maintenance release ·

2.28.5

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

2.28.4

Maintenance release ·

2.28.3

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

2.28.2

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

2.28.1

Maintenance release ·

2.28.0

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

2.27.0

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

2.26.4

  • Always finish after-remove hook successfully

2.26.3

Maintenance release ·

2.26.2

Maintenance release ·

2.26.1

  • Update client certificates
  • Update dependencies

2.26.0

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

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

2.24.4

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

2.24.3

  • Create Blackfire extension dir if missing
  • Update dependencies

2.24.2

  • Fix compatibility with Homebrew 4.2
  • Update dependencies

2.24.1

Maintenance release ·

2.24.0

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

2.23.0

  • Forward JS probe location
  • Update dependencies

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

2.21.0

  • Add an env var to disable profile aggregation

2.20.0

  • Increase retry delays for env config update errors

2.19.0

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

2.18.0

  • Update the thresholds for sending traces to the backend

2.17.0

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

2.16.2

  • Fix panic in realtime config update support

2.16.1

  • Disable the Monitoring according to the backend configuration

2.16.0

  • Support (near) realtime update of the Monitoring configuration

2.15.1

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

2.15.0

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

2.14.2

  • Fix an issue with releasing

2.14.1

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

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

2.13.2

Maintenance release ·

2.13.1

  • Detect macOS 13.0 Ventura
  • Prevent prolog headers override

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

2.12.0

  • Add support for probe's profile cancellation request

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

2.10.1

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

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

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

2.8.1

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

2.8.0

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

2.7.1

  • Fix a memory leak
  • Improve WSL detection

2.7.0

  • Automatic-profling: lock key-pages by transaction

2.6.0

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

2.5.2

  • Fix amd64 Docker image

2.5.1

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

2.5.0

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

2.4.3

  • Fix header cases

2.4.2

  • Update log messages

2.4.1

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

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

2.3.1

  • Fix panic when anonymizing invalid data

2.3.0

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

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

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

2.0.0

  • Release 2.0.0 final

2.0.0-beta3

  • Anonymize only function arguments and ignore other metadata

2.0.0-beta2

  • Remove 'self-update' command
  • Honor the 'continue' and 'wait' agent's instructions in the 'curl' command

2.0.0-beta1

  • Support the 'span_time_threshold' config
  • Improve the releasing

2.0.0-alpha10

  • Fix homebrew and freebsd releasing
  • Disable the SentryLogger

2.0.0-alpha9

  • Fix internal releasing

2.0.0-alpha8

  • Fix systemd unit for older systems

2.0.0-alpha7

  • Fix the releasing of the docker image

2.0.0-alpha6

  • Fix the releasing

2.0.0-alpha5

  • The init script `/etc/init.d/blackfire-agent` has been replaced by a systemd service

2.0.0-alpha1

  • First alpha release