kcachegrind-container

Web GUI to inspect Valgrind and Xdebug profiling reports.

Usage with C/C++

Gain performance insights of C and C++ applications using Valgrind with Callgrind as the profiling tool.

1. Capture a Callgrind profiling report with Valgrind

valgrind --tool=callgrind --dump-instr=yes --collect-jumps=yes <your program>

2. Start the KCachegrind container

docker run --rm --pull always --name kcachegrind \
  -p 127.0.0.1:80:80 \
  -v "${PWD}:/data" \
  nedix/kcachegrind

3. Open the profiling data with KCachegrind

• Browse to the KCachegrind web interface on http://127.0.0.1:80
• Click on the Open button in the toolbar
• Navigate to the /data directory using the sidebar
• Open your profiling report

Usage with PHP

Gain performance insights of PHP applications using Xdebug as the profiling tool.

1. Download the Compose manifest to your project directory

wget https://raw.githubusercontent.com/nedix/kcachegrind-container/main/docs/examples/compose-php.yml

2. Start the KCachegrind service

docker compose -f compose-php.yml up

3. Capture a profiling report with Xdebug

• Navigate to any page on http://127.0.0.1:8081 to capture a profiling report

4. Open the profiling data with KCachegrind

• Browse to the KCachegrind web interface on http://127.0.0.1:8082
• Click on the Open button in the toolbar
• Navigate to the /data directory using the sidebar
• Open your profiling report