# CLI changelog

## 2026.10.1 (2026-10-21)

- Send usage telemetry for every command
- Update dependencies

## 2026.10.0 (2026-10-01)

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

## 2026.9.1 (2026-09-17)

- 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 (2026-09-01)

Maintenance release.

## 2026.8.1 (2026-08-26)

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

## 2026.8.0 (2026-08-05)

- Patch reported CVEs
- Update dependencies; Internal releasing changes

## 2026.7.0 (2026-07-09)

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

## 2026.6.1 (2026-06-17)

- Support regional agent
- Update dependencies

## 2026.6.0 (2026-05-31)

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

## 2026.5.1 (2026-05-26)

Maintenance release.

## 2026.5.0 (2026-05-20)

- Update default CARoots
- Update dependencies

## 2026.4.2 (2026-04-21)

- 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 (2026-04-09)

- Update links used for displaying the Graph URL

## 2026.4.0 (2026-04-07)

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

## 2026.3.2 (2026-03-31)

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

## 2026.3.1 (2026-03-30)

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

## 2026.3.0 (2026-03-10)

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

## 2.30.3 (2026-02-26)

- Fix blackfire run command
- Internal releasing changes

## 2.30.2 (2026-02-18)

- Fix profiling for very large organizations
- Internal releasing changes

## 2.30.1 (2025-12-23)

Maintenance release.

## 2.30.0 (2025-12-22)

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

## 2.29.9 (2025-12-11)

- Update CA certificates

## 2.29.8 (2025-11-20)

Maintenance release.

## 2.29.7 (2025-11-20)

Maintenance release.

## 2.29.6 (2025-11-20)

Maintenance release.

## 2.29.5 (2025-11-19)

Maintenance release.

## 2.29.4 (2025-11-12)

Maintenance release.

## 2.29.3 (2025-11-05)

Maintenance release.

## 2.29.2 (2025-10-14)

- 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 (2025-09-15)

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

## 2.29.0 (2025-08-27)

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

## 2.28.31 (2025-08-04)

Maintenance release.

## 2.28.30 (2025-07-31)

- 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 (2025-07-08)

- Add ping flag
- Update dependencies; Internal releasing change

## 2.28.28 (2025-06-25)

Maintenance release.

## 2.28.27 (2025-06-18)

Maintenance release.

## 2.28.26 (2025-06-02)

Maintenance release.

## 2.28.25 (2025-06-02)

- Update CA certificates
- Internal releasing changes; Update dependencies

## 2.28.24 (2025-05-14)

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

## 2.28.23 (2025-01-28)

- Update CA certificates
- Update dependencies

## 2.28.22 (2024-12-23)

Maintenance release.

## 2.28.21 (2024-12-04)

- Update ca-certificate
- Update dependencies

## 2.28.20 (2024-11-25)

Maintenance release.

## 2.28.19 (2024-11-14)

Maintenance release.

## 2.28.18 (2024-11-05)

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

## 2.28.17 (2024-10-28)

Maintenance release.

## 2.28.16 (2024-10-24)

Maintenance release.

## 2.28.15 (2024-10-21)

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

## 2.28.14 (2024-10-14)

Maintenance release.

## 2.28.13 (2024-10-07)

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

## 2.28.12 (2024-09-18)

Maintenance release.

## 2.28.11 (2024-08-05)

- 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 (2024-07-31)

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

## 2.28.9 (2024-07-18)

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

## 2.28.8 (2024-07-08)

Maintenance release.

## 2.28.7 (2024-07-01)

Maintenance release.

## 2.28.6 (2024-06-21)

Maintenance release.

## 2.28.5 (2024-06-17)

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

## 2.28.4 (2024-06-03)

Maintenance release.

## 2.28.3 (2024-05-23)

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

## 2.28.2 (2024-05-13)

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

## 2.28.1 (2024-05-06)

Maintenance release.

## 2.28.0 (2024-05-06)

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

## 2.27.0 (2024-04-30)

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

## 2.26.4 (2024-04-12)

- Always finish after-remove hook successfully

## 2.26.3 (2024-04-10)

Maintenance release.

## 2.26.2 (2024-04-08)

Maintenance release.

## 2.26.1 (2024-03-18)

- Update client certificates
- Update dependencies

## 2.26.0 (2024-03-01)

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

## 2.25.0 (2024-02-02)

- 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 (2024-01-16)

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

## 2.24.3 (2024-01-08)

- Create Blackfire extension dir if missing
- Update dependencies

## 2.24.2 (2023-12-20)

- Fix compatibility with Homebrew 4.2
- Update dependencies

## 2.24.1 (2023-12-18)

Maintenance release.

## 2.24.0 (2023-12-13)

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

## 2.23.0 (2023-10-26)

- Forward JS probe location
- Update dependencies

## 2.22.0 (2023-09-27)

- 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 (2023-08-22)

- Add an env var to disable profile aggregation

## 2.20.0 (2023-08-03)

- Increase retry delays for env config update errors

## 2.19.0 (2023-07-27)

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

## 2.18.0 (2023-07-24)

- Update the thresholds for sending traces to the backend

## 2.17.0 (2023-07-12)

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

## 2.16.2 (2023-06-27)

- Fix panic in realtime config update support

## 2.16.1 (2023-05-15)

- Disable the Monitoring according to the backend configuration

## 2.16.0 (2023-05-10)

- Support (near) realtime update of the Monitoring configuration

## 2.15.1 (2023-05-03)

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

## 2.15.0 (2023-04-12)

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

## 2.14.2 (2023-03-30)

- Fix an issue with releasing

## 2.14.1 (2023-03-29)

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

## 2.14.0 (2023-03-08)

- 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 (2022-12-05)

Maintenance release.

## 2.13.1 (2022-11-16)

- Detect macOS 13.0 Ventura
- Prevent prolog headers override

## 2.13.0 (2022-10-18)

- 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 (2022-09-28)

- Add support for probe's profile cancellation request

## 2.11.0 (2022-09-20)

- 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 (2022-08-24)

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

## 2.10.0 (2022-06-07)

- 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 (2022-05-16)

- 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 (2022-04-27)

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

## 2.8.0 (2022-04-20)

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

## 2.7.1 (2022-04-06)

- Fix a memory leak
- Improve WSL detection

## 2.7.0 (2022-03-15)

- Automatic-profling: lock key-pages by transaction

## 2.6.0 (2022-02-16)

- 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 (2021-11-03)

- Fix amd64 Docker image

## 2.5.1 (2021-10-21)

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

## 2.5.0 (2021-08-30)

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

## 2.4.3 (2021-07-01)

- Fix header cases

## 2.4.2 (2021-06-24)

- Update log messages

## 2.4.1 (2021-06-21)

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

## 2.4.0 (2021-06-14)

- 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 (2021-06-02)

- Fix panic when anonymizing invalid data

## 2.3.0 (2021-05-24)

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

## 2.2.0 (2021-04-22)

- 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 (2021-04-02)

- 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 (2021-03-23)

- Release 2.0.0 final

## 2.0.0-beta3 (2021-03-22)

- Anonymize only function arguments and ignore other metadata

## 2.0.0-beta2 (2021-03-08)

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

## 2.0.0-beta1 (2021-02-25)

- Support the 'span_time_threshold' config
- Improve the releasing

## 2.0.0-alpha10 (2021-02-08)

- Fix homebrew and freebsd releasing
- Disable the SentryLogger

## 2.0.0-alpha9 (2021-01-28)

- Fix internal releasing

## 2.0.0-alpha8 (2021-01-26)

- Fix systemd unit for older systems

## 2.0.0-alpha7 (2021-01-14)

- Fix the releasing of the docker image

## 2.0.0-alpha6 (2021-01-13)

- Fix the releasing

## 2.0.0-alpha5 (2021-01-06)

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

## 2.0.0-alpha1 (2020-11-24)

- First alpha release