Frame profiler
Go to file
2019-09-24 23:42:25 +02:00
capture Allow specifying network port in server. 2019-09-21 15:43:01 +02:00
client Allow changing tracy port in client. 2019-09-21 15:11:15 +02:00
common Send thread id in GPU zone end message. 2019-09-23 16:06:14 +02:00
doc Fix 32 bit NEON version of DXT1 compression. 2019-09-03 21:37:07 +02:00
extra Fix div tables for max range on all channels. 2019-07-01 12:31:06 +02:00
icon Add icon files. 2019-06-02 18:05:49 +02:00
imgui Update ImGui to 1.73. 2019-09-24 23:32:03 +02:00
imguicolortextedit Update ImGuiColorTextEdit to 0a88824f7de8d. 2019-06-22 14:19:10 +02:00
libbacktrace Fixed compiler warnings. 2019-02-20 17:50:49 +01:00
manual Update manual. 2019-09-24 00:20:41 +02:00
nfd All variables must be defined before goto. 2019-06-23 00:36:25 +02:00
profiler Update ImGui to 1.73. 2019-09-24 23:32:03 +02:00
server Add thread color box to crash info. 2019-09-24 23:42:25 +02:00
test Allow easy adding of tracy flags in test application. 2019-09-21 15:49:54 +02:00
update Add task dispatcher to server. 2019-09-20 22:58:12 +02:00
.appveyor.yml Also build test with TRACY_ON_DEMAND enabled. 2019-09-21 15:50:27 +02:00
.gitignore Basic technical documentation. 2019-07-15 21:00:12 +02:00
AUTHORS Briefly describe contributor's work. 2019-03-09 12:36:54 +01:00
FAQ.md Mention on-demand mode in FAQ. 2018-07-12 13:32:49 +02:00
LICENSE Update year in copyright notice. 2018-12-30 17:51:17 +01:00
NEWS Update NEWS. 2019-09-23 17:28:32 +02:00
README.md Release 0.5.0. 2019-08-10 22:14:14 +02:00
Tracy.hpp Allow sending application information messages. 2019-07-12 18:34:46 +02:00
TracyC.h Merged in z33ky/tracy/const-frame-image (pull request #37) 2019-07-13 13:09:21 +00:00
TracyClient.cpp Add system tracing skeleton. 2019-08-12 23:05:34 +02:00
TracyClientDLL.cpp Clean up imported functions in multi-dll projects. 2019-06-07 19:50:08 +03:00
TracyLua.hpp Drop support for CPU id queries. 2019-08-12 23:05:34 +02:00
TracyOpenGL.hpp Send thread id in GPU zone end message. 2019-09-23 16:06:14 +02:00
TracyVulkan.hpp Send thread id in GPU zone end message. 2019-09-23 16:06:14 +02:00

Tracy Profiler

Build status

Tracy is a real time, nanosecond resolution frame profiler that can be used for remote or embedded telemetry of your application. It can profile CPU (C, C++11, Lua), GPU (OpenGL, Vulkan) and memory. It also can display locks held by threads and their interactions with each other.

The following compilers are supported:

  • MSVC
  • gcc
  • clang

The following platforms are confirmed to be working (this is not a complete list):

  • Windows (x86, x64)
  • Linux (x86, x64, ARM, ARM64)
  • Android (ARM, x86)
  • FreeBSD (x64)
  • Cygwin (x64)
  • WSL (x64)
  • OSX (x64)

Introduction to Tracy Profiler v0.2
New features in Tracy Profiler v0.3
New features in Tracy Profiler v0.4
New features in Tracy Profiler v0.5

A quick FAQ.
List of changes.

High-level overview

Tracy is split into client and server side. The client side collects events using a high-efficiency queue and awaits for an incoming connection. The server part connects to client and receives collected data from the client, which is then reconstructed into a viewable timeline. The transfer is performed using a TCP connection.

Performance impact

To check how much slowdown is introduced by using Tracy, I have profiled etcpak, which is the fastest ETC texture compression utility there is. I used an 8192×8192 test image as input data and instrumented everything down to the 4×4 pixel block compression function (that's 4 million blocks to compress). It should be noted that Tracy needs to calibrate its internal timers at each run. This introduces a delay of 115 ms (on my machine), which is negligible when doing lengthy profiling runs, but it skews the results of etcpak timing. The following times have this delay subtracted, to give focus on zone collection impact, which is the thing that really matters here.

Scenario Zones Clean run Profiling run Difference
Compression of an image to ETC1 format 4194568 0.94 s 1.003 s +0.063 s
Compression of an image to ETC2 format, with mip-maps 5592822 1.034 s 1.119 s +0.085 s

In both scenarios the per-zone time cost is at ~15 ns. This is in line with the measured 8 ns single event collection time (each zone has to report start and end event).

Usage instructions

The user manual for Tracy is available at the following address. It provides information about the integration process, required code markup and so on.

Features

Histogram of function execution times

Comparison of two profiling runs

Marking locks

Plotting data

Message log