this Docker image is based on Debian and includes the perf utility, designed for use on Docker for debian-based linux system. It comes pre-configured with Nginx to demonstrate how to use perf for performance profiling. feel free to adapt the image to include other utilities as needed
- Debian base image
perfinstalled for performance profiling- Nginx included as a web server (modifiable)
- Privileged mode support for
perfcommands
start the container in a privileged mode, run:
docker run --name perf-utils --privileged -p 8080:80 -d ghcr.io/triplemcoder14/perf-utils:latest
create a bash shell in the running container, execute:
docker exec -it perf-utils bash
Once inside the container, you can run perf commands to probe your applications. Here are some examples:
- List available probes for Nginx:
perf probe -x /usr/sbin/nginx -F
output:
- Inspect specific function variables:
perf probe -x `which nginx` -V ngx_accept_log_error
output:
Feel free to customize this image by adding additional utilities or configurations as needed. Simply modify the Dockerfile to install any required packages or dependencies.
cheers!!!

