If you are using Docker, you might want to use the official Blackfire Docker image to run the Agent and get some inspiration from our recipes to install the Client and the Probe.
To ease the process of using Blackfire with Docker, define these environment variables on the Docker host machine:
From now on, we assume that these environment variables are set up properly.
If you use docker compose
, you can declare the Blackfire agent as a service.
To do so, use the following snippet:
When profiling remote servers, you may use the Blackfire CLI tool which is embedded in Blackfire Docker image.
Assuming you configured blackfire
service as explained above, you may use
the following command:
1
To make it less verbose, create an alias:
1 2
STDOUT & STDERR using docker compose
When using docker compose exec
STDOUT
and STDERR
outputs are mixed up. This is due to the limitations of the pseudo TTY
which is allocated by default by Docker Compose.
This can be an issue when using the --json
option to dump a profile
data in JSON. The profile data is indeed output to STDOUT
by
blackfire curl
command, while the process info is output to STDERR
.
The workaround in this case is to use Docker Compose -T
option:
1
docker compose exec -T blackfire blackfire curl http://example.com
By default, the agent is quiet and does not produce logs. To debug problems,
increase the log verbosity by setting BLACKFIRE_LOG_LEVEL
to 4
:
You may then tail the logs with docker compose
:
1
The Blackfire image is the fastest way to get the Blackfire agent running:
1
Upgrading
To upgrade the Blackfire image, pull the newest image from Docker and restart the agent container:
1
You can check the version of a running Blackfire container with the following command:
1
When profiling remote servers, you may use the Blackfire CLI tool which is embedded in Blackfire Docker image:
1 2 3 4 5 6
docker run -it --rm \
-e BLACKFIRE_CLIENT_ID \
-e BLACKFIRE_CLIENT_TOKEN \
--expose 8307 \
blackfire/blackfire:2 blackfire \
curl http://example.com/
To make it less verbose, create an alias:
1 2
To install the Blackfire Probe in your application container, read the following guides, depending on your runtime:
To use Blackfire Player with Docker, read the dedicated guide.