This article is a quick guide to the basics of logging data and using Statoscope.
The page will guide you though the necessary setup and some basics of the Statoscope interface.
Chapters:
Statoscope will connect to any console/platform that is connected directly to the PC or via an IP address specified in the connection dialog.
From CRYENGINE version 3.6.3 and earlier:
If you chose e_StatoscopeLogDestination = 0 The session file is stored in the location: BuildRoot/statoscope/*.bin
From CRYENGINE 3.6.4 and later:
If you chose e_StatoscopeLogDestination = 0 The session file is stored in the location: BuildRoot/user/statoscope/*.bin
You can open logs in different ways:
Each log opens a new tab. When you open a log that has been recorded across several levels with the user marker data group enabled ('u'), then each level is also opened in its own tab (this is based on level start and end user markers).
Middle click on a tab to close it.
By default, every stat will be drawn (which is usually far too many to be useful), so the first thing to do is to trim the view down to what you want.
From File -> Connect you can connect to a running version of the game whose e_StatoscopeLogDestination is set to 1.
Choose the target platform you want to connect to.
If Log to file is enabled you will be given the option of saving the log to disk for opening later.
A slight limitation at the moment is that you must have enabled at least one data group before connecting, but you can change the data groups on the fly once connected.
If for any reason the connection fails, then you can reset it by setting e_StatoscopeLogDestination to a different value (e.g. 2) and then back to 1 again, and then reconnect.
After loading a log or connecting to a running application you will typically see the following layout in Statoscope:
This screen corresponds to the default view with all the options enabled and the entire log fitted to screen. From here, you can start turning off the data groups that you do not need and zooming in on the display in the areas of interest.
In the main graph window: