yalter/gnome-shell-tracy

Description

GNOME Shell and dependencies instrumented with Tracy.

Installation Instructions

Make sure that you know how to restore the packages to their original versions before proceeding, in case the session stops working. Something like sudo dnf downgrade might be sufficient.

Run the following:

sudo dnf copr enable yalter/gnome-shell-tracy
sudo dnf update

This should install a .tracy version of several packages with Tracy instrumentation.

Now, to be able to capture more useful data (CPU scheduling and context switches), run the following commands:

echo -1 | sudo tee /proc/sys/kernel/perf_event_paranoid
sudo chmod -R a+rx /sys/kernel/debug
sudo chmod -R a+rx /sys/kernel/debug

You need to run the second command twice because the first time it fails to change permissions of one of the important subfolders. It might give a bunch of permission errors but that's fine.

Finally, log out and back in. You're ready to capture performance traces.

Note: if you reboot, you will need to run the tee and chmod commands above, and then log out and back in, again, since their effect is reset upon rebooting.

Note: if you suspend/sleep and resume, the traces you capture will become unreadable. So you will need to log out and back in before capturing traces.

Capturing a Trace

Use this command to capture a trace:

tracy-capture -o output.tracy -f -p 8087

You may need to use a different port (try 8086, 8087, 8088).

Once the capturing has started, do the actions that you want to profile for a few seconds. For example, open and close the Overview repeatedly several times.

Finally, press Ctrl-C to terminate the capture-release command. The output.tracy file contains the recorded data. You can inspect it yourself with the Tracy UI (see below) or send it to me so that I can take a look at it.

Running the Tracy UI

You can run the Tracy UI with the tracy-ui command. There you can open a previously recorded trace or capture a new trace right from the UI.

Active Releases

The following unofficial repositories are provided as-is by owner of this project. Contact the owner directly for bugs or issues (IE: not bugzilla).

Release	Architectures	Repo Download
Fedora 39	x86_64 (7019)*	Fedora 39 (90 downloads)

* Total number of downloaded packages.