Python SDK

For tools and AI agents: Markdown version

2026.10.0

Maintenance release ·

2026.9.1

  • Emit a valid boolean async attribute in the browser probe script tag

2026.9.0

Maintenance release ·

2026.8.0

Maintenance release ·

2026.5.0

Maintenance release ·

2026.4.0

  • Add application name to server-monitoring probes
  • Internal releasing changes

2026.3.0

  • Change the brand in versions and licenses
  • Switch versioning to calver
  • Fix incorrect comment
  • Update dependencies; Internal releasing changes

1.20.37

Maintenance release ·

1.20.36

Maintenance release ·

1.20.35

Maintenance release ·

1.20.34

  • Python probe `3.14` support
  • Internal releasing changes

1.20.33

  • APM connection re-use issues
  • Add Ping support to WSGI frameworks

1.20.32

  • [Python] Remove setuptools dependency (pkg_resources)
  • Internal releasing changes

1.20.31

  • Hide pixel tracking
  • Internal releasing changes

1.20.30

Maintenance release ·

1.20.29

  • This is the latest version supporting Python 2.7
  • Internal releasing changes

1.20.28

Maintenance release ·

1.20.27

  • Inject JS probe to WSGI middleware

1.20.26

  • Fix Odoo v15 and up

1.20.25

  • Close connection before reconnect and log reconnect
  • Internal releasing changes

1.20.24

Maintenance release ·

1.20.23

  • `APM` share a single connection
  • Remove `eol` versions from test suite
  • Internal releasing changes

1.20.22

  • Print `Warning` when `uwsgi` is not running on `enable-threads`

1.20.21

  • Test against python `3.13`
  • Internal Releasing changes

1.20.20

Maintenance release ·

1.20.19

  • Fix `segfault` when extended trace is on

1.20.16

Maintenance release ·

1.20.15

Maintenance release ·

1.20.14

Maintenance release ·

1.20.13

  • Drop unnecessary getpid() in get_os_memory_usage()
  • Do not call atexit.register for every txn

1.20.12

  • Generate manylinux aarch64 binaries

1.20.11

  • Reintroduce manylinux compatible binaries

1.20.10

Maintenance release ·

1.20.9

Maintenance release ·

1.20.8

Maintenance release ·

1.20.7

Maintenance release ·

1.20.6

Maintenance release ·

1.20.5

Maintenance release ·

1.20.4

Maintenance release ·

1.20.3

Maintenance release ·

1.20.2

Maintenance release ·

1.20.1

  • Update documentation links

1.20.0

  • Python 3.12 Windows support

1.19.0

  • Python 3.12 support

1.18.0

  • Enable monitoring by default

1.17.0

  • Add Pyramid WSGI integration
  • Do not log to stderr when BLACKFIRE_LOG_FILE is specified
  • Various fixes related to stability

1.16.6

  • Use `path_info` instead of `request_uri` for monitoring WSGI applications

1.16.5

  • fix incorrect number of args. for `send_response` in WSGI middleware

1.16.4

  • Workaround for a segfault happening on `3.11`
  • Fix error prints when retrieving function name and `self` is not a class

1.16.2

  • Fix profiling on FastAPI when sub applications feature is used

1.16.1

  • Support Python 3.11/3.10 on Windows
  • Support Python 3.7 on Mac ARM
  • Add HTTP request naming support for monitoring

1.15.0

  • Support Python 3.11
  • Change APM timespan defaults

1.14.0

  • Support profiling of multiple threads simultaneously

1.13.0

  • APM start_transaction() API now accepts `name` parameter
  • Use better exception messages/types for Agent communication errors
  • Fix Django middleware throwing exception when response is `FileResponse`

1.12.0

  • Fix a bug that affects matplotlib on 3.10 and up
  • Add a generic WSGI middleware
  • Lock Monitoring if there is any connection problem to the Agent

1.11.0

  • Alpine binaries can be installed via pip
  • Odoo framework support
  • Fix a memory profiling issue when numpy is used
  • Small fixes&improvements

1.10.0

  • Add a decorator for flask views (profile_flask_view)
  • Change BLACKFIRE_LOG_FILE default to stderr
  • Remove all old DeprecationWarnings

1.9.1

  • Fix builds when a non-ASCII character used in .blackfire.yml file

1.9.0

  • Fix an issue that prevents APM time-threshold value to be respected
  • Fix invalid cost-dimensions for extended traces
  • Support APM auto-detection of the view name for FastAPI applications

1.8.1

  • Fix an issue that prevents running Builds on FastAPI

1.8.0

  • Fix encoding issue with Django middleware on Python2.7
  • Fix APM daemon thread not started when gunicorn run with UvicornWorker worker class
  • Add support for auto-profiling and writing scenarios to FastAPI

1.7.1

  • Fixed few minor memory leak issues related to asyncio profiling
  • Fix an issue where Content-Length header was always expected in Flask middleware

1.7.0

  • FastAPI support
  • Support profiling of asyncio applications
  • Support nw dimension
  • Fix various issues related to manual APM API and implement set_tag
  • Fix an issue with pending APM transactions on interpreter shutdown

1.6.1

  • Release Python 3.10 wheels for various platforms
  • Release Apple M1 wheels for 3.8, 3.9 and 3.10
  • Implement various optimizations/refactorings to profiling and monitoring
  • Fix an issue with auto-profiling for Monitoring
  • Implement Monitoring SDK APIs (start_transaction/stop_transaction...)

1.5.6

  • Fix a protocol related bug that prevents some Python recommendations to be shown properly.
  • Fix an issue where two functions sharing same Base class gets merged in a single trace.

1.5.5

  • Remove psutil dependency
  • Add APIs to set title/transaction_name for the current profiling session
  • Support http/https proxy settings for manual profiling
  • Import custom sitecustomize if there is any
  • Fix various issues

1.5.3

  • Fix an issue related to Web profiling
  • Release Python 3.9 wheels on Windows
  • Fix an issue with parsing an IPv6 URL scheme

1.5.2

  • Fix various bugs
  • Add support for Python 3.9

1.5.1

  • Fix various bugs
  • A new `blackfire-python` command for auto-instrumenting Python apps
  • Deprecate `install_bootstrap/uninstall_bootstrap` commands

1.4.5

  • Add 3.8 support for macOS

1.4.4

  • Drop multiprocessing dependency (for easier AWS Lambda integration)

1.4.3

  • Generate wheel distribution for Alpine OS
  • Capture named parameters in Python functions
  • More verbose/prettier logging
  • Defined/Added metrics for various frameworks
  • Add '@profile' decorator to profile single functions

1.4.0

  • Added memory profiler
  • Defined metrics for most of the stdlib. functions (socket, os, subprocess, threading...etc.)
  • Defined metrics for Elasticsearch, Redis, Celery, memcache
  • Add Blackfire-Auth header for Agent->Probe communication
  • Support blackfire.yml
  • Various fixes

1.3.4

  • Added timeline view support
  • Capture PyCFunctionObject args
  • Added Flask middleware
  • Defined Django template metrics
  • Various fixes

1.3.3

  • Added the changelog file