Search Unity

Building the rig

We have built a performance test rig that can monitor selected development and release branches and report selected data points to a database.

The performance test rig is continuously running and looking for new builds to test from our build automation system. As soon as new builds are ready, it runs tests on all platforms we have setup for performance testing. The results get reported into a database with all the related information like Unity version used, platform and information about the hardware and operating system. We also have a reporting solution that continuously monitors the data in the database and shows us if we have a significant performance regression. It can tell us in which release branch the regression occurs, which platforms and tests are affected by it.

The figure below shows the components of the performance test framework. For running the tests we have dedicated machines running tests on different platforms. We use a .Net web service to report test results to the database. And we have a reporting solution that presents results in nicely formatted reports.

Performance test framework components

When analyzing the test results we use a fixed set of hardware and software configurations and we look for changes over different versions of Unity. For example when testing Windows Standalone platform we use the same hardware and Windows version for all the runs. Only the Unity version is varying.

As all of the data is saved in the database, we can make reports from the data for different uses. For each Unity version we are about to release we make a chart that shows data points vs previously released versions. We can also see almost realtime status of performance tests for release branches we are developing in parallel. When analyzing a regression we can even see the individual measurements, not only the mean value.

Currently we have three dedicated performance test machines for handling the test running. We have one Mac Mini (OSX 10.8.5) that is used to run tests on the Mac platforms (Editor, Standalone). We have two Windows machines (Windows 7, Windows 8.0) that are used to run tests on the Windows platforms (Editor, Standalone). And we have a Nexus 10 device to run tests on Android. We intend to extend this to more platforms, hardware and software configurations, but more on that later. And before you ask, yes, OSX 10.9 Mavericks is coming. We just didn’t get to it yet.

Extending existing framework

We wrote about one of our test frameworks, the Runtime Test Framework, in an earlier blog post. For performance testing we have extended our existing test frameworks instead of creating a new one. This means we can tap into the existing test suites and use them for performance testing. Further, everyone that can write tests using existing frameworks can write performance tests. This also means it is easy to get new platforms running performance tests as soon as we have the platform running other tests.

The test suites

We have split the tests into two types called Editor Tests and Runtime Tests based on how they get run and what can be measured. Editor Tests are limited to the platforms the editor runs on. Editor Tests can make measurements outside of Unity user scripts. The tests measure things like editor start-up time and asset import times for different types of assets. Runtime Tests, on the other hand, can be run on all the supported runtime platforms. With Runtime Tests it is possible to measure things like frame time of rendered frames or to measure the time it takes to deserialize different types of assets. It is actually possible to measure anything you can do with user scripts in Unity.

The future

First of all we will add more configurations. Hardware and software. OSX 10.9 is high on the list, and so are the remaining mobile platforms and consoles. We truly believe that the performance rig is a lifesaver when it comes to detecting performance regressions as early as possible. Further, the rig makes it very easy to compare performance across different platforms and versions of Unity. We will keep you posted as we find interesting results – and different usages of the rig.

6 replies on “Monitoring Unity Performance, Part II”

I’ve noticed a fairly significant performance regression with the jump from Unity 4.2.x to 4.3.1f on Mac, and it appears the issue is with Windows too. Before upgrading, my scene was running at around 85 fps at a particular FOV, same FOV on the newer version is running 45 fps. Seems strange I’d experience a halving of performance.

Secondary question, are you guys using the CGDisplayLink for locking Unity’s render loop timer to the video clock?


Yeah, I’ve seen all that, but most of the reports are about sluggish performance. I (and others) are experience full system locks. Which feels different.

Regardless I guess the best is to just file a bug with apple? FWIW, I think a lot of use would appreciate regular updates on this one. The occasional post to the forums or issue tracker would be welcomed.

@Pat: If you search for “Mavericks performance issues” on Google you will see that many, many people are experiencing the same problems with other applications, too, and while many possible solutions have been suggested, none of them seem to work for all the users. This is one of the reason why this is more likely a performance regression Apple introduced than a problem with Unity. Another reason to believe that is that there are Unity users on Mavericks that don’t experience any performance issues.

Thomas, thank you for the response. I apologize if I come off rude, it’s simply that this bug is so very, very frustrating.

It’s surprising that you have not been able to repro the issue. Is there something that the users suffering with this problem can do to help move things forward. I’d hate for us to be in a place where Unity points the finger at Apple and Apple points the finger back at Unity.

It’s interesting that you believe this bug is an Apple one. Why do you think that? I have many, many applications and Unity is the only app with which I’m experiencing this issue. That was key reason for believing that this was a Unity bug and not an Apple one. Regardless, that being said, what can be done to push this forward? It is truly a painful, painful bug.

@Pat: Before we recalibrated votes, one person could place 10 votes on one bug.

Anyways, we know about the Mavericks issue, but we have NOT been able to reproduce it internally and we have every reason to believe this is and OSX issue. We have created a bug report with Apple, but have unfortunately not had a resolution on it.

Guys, allow me to direct you to the unity issue tracker site so that you may feast your eyes on the insanely bad performance bug that exists between Unity and Mavericks. It is a bug so bad that it’s worthy of a hot fix. And to read that you have test Unity against Mavericks, months after it has been released is profoundly disappointing.

(BTW before you recalibrated the voting process in issue tracker, this bug had over 1100 votes!)

Comments are closed.