nedix/kcachegrind repository overview

⁠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 \
    --name kcachegrind \
    --pull always \
    --rm \
    -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