The File Access ProfilerA window that helps you to optimize your game. It shows how much time is spent in the various areas of your game. For example, it can report the percentage of time spent rendering, animating, or in your game logic. More info
See in Glossary module displays information about the file activity in your application, such as the number of read or write operations Unity performs or the number of file handles open, either for a specific frame or across all frames in a capture. You can use this information to help determine how efficiently your application performs file operations. This module can capture information about file operations on any file within your built application’s folder structure, or within your Unity project folder if you run the Profiler in the Unity Editor.
This module is not enabled by default. To enable the File Access Profiler module, open the Profiler window, select the Profiler Modules dropdown menu, and toggle the File Access checkbox.
The File Access Profiler module’s chart is divided into five categories. To change the order of the categories in the chart, drag and drop them in the chart’s legend. You can also click a category’s colored legend to toggle its display on or off. For more information on how to use the Profiler window, see Getting started with the Profiler window. This module doesn’t collect information about unsuccessful file operations. If a file operation attempt is unsuccessful, Unity displays an error.
Chart | Description |
---|---|
Files Opened | The total number of files successfully opened in the local file system this frame. |
Files Closed | The total number of files successfully closed in the local file system this frame. |
File Seeks | The number of file seek operations performed in the local file system this frame. A file seek operation involves a search through the contents of a file. |
Reads in Flight | The total number of read operations that were in progress during this frame. |
File Handles Open | The total number of file handles held open at any time during this frame. This includes files that Unity opens and closes within the same frame. |
When you select a frame in the File Access Profiler module, the module details pane displays detailed information about files that Unity accessed during the capture. The File Access Profiler module has two views:
Use the dropdown menu at the top-left of the details pane to toggle which view is active. By default, the File Summary view is active.
Both views can display information for either a single selected frame, or for all frames in the capture. Use the second dropdown menu at the top-left of the details pane to choose between a single frame or all frames. This module doesn’t populate the details pane automatically. Instead, you need to select the Analyze Markers button at the top of the details pane to populate the view with data.
The File Summary view displays a summary of all file access operations that happened to each file during the capture. One entry in the table represents the full summary for a single file.
The table below describes all possible columns that the File Summary view table can display. Not all columns are enabled by default; to enable or disable a column, right-click anywhere in the row that contains the column headers to open a menu. Use this menu to toggle any column on or off.
Detail | Description | Enabled by default |
---|---|---|
Filename | The name of the file that was accessed. | Yes |
Total Bytes Read | The total number of bytes of information Unity read from this file during the selected frames. | Yes |
Read Access Time (ms) | The total time Unity spent performing reads from this file during the selected frames. | Yes |
Access Count | The total number of accesses of any type to this file during the selected frames. | Yes |
First Frame | The first frame that Unity accessed this file on. | Yes |
Number of Frames | The total number of frames that Unity accessed this file on. | Yes |
ID | An index that represents the order of execution of the file access markers. | No |
Read Bandwidth (MBps) | The average bandwidth of read operations on this file over the selected frames, in megabytes per second. | No |
Open Count | Total number of opening operations on this file during the selected frames. | No |
Close Count | Total number of closing operations on this file during the selected frames. | No |
Read Count | Total number of read operations on this file during the selected frames. | No |
Write Count | Total number of write operations on this file during the selected frames. | No |
Seek Count | Total number of file seek operations on this file during the selected frames. | No |
Total Bytes Written | The total number of bytes Unity wrote to this file during the selected frames. | No |
Write Bandwidth (MBps) | The average bandwidth of write operations on this file over the selected frames, in megabytes per second. | No |
Open Access Time (ms) | The total time Unity spent performing opening operations on this file during the selected frames, in milliseconds. | No |
Close Access Time (ms) | The total time Unity spent performing close operations on this file during the selected frames, in milliseconds. | No |
Write Access Time (ms) | The total time Unity spent performing write operations to this file during the selected frames, in milliseconds. | No |
Total Access Time (ms) | The total time Unity spent accessing this file during the selected frames, in milliseconds. | No |
The Accesses view provides detailed information about every file access operation in the capture. Each entry in the table in the details pane of the Profiler represents a single file access operation to a single file. The below table describes all possible columns that the Accesses view can display.
Detail | Description | Enabled by default |
---|---|---|
Index | An ID number that represents the order in which Unity performed the access operations. | Yes |
Filename | The name of the accessed file during this operation. To see the file path in full, hover your cursor over the filename entry. | Yes |
Type | The type of access operation performed. This can be either Open, Close, Seek, Read, or Write. | Yes |
Access Size | The number of bytes transferred during the access, where the access was a read or write. Where the access was a file seek, the size is the destination offset. | Yes |
Offset | The (starting) offset of the file access. | Yes |
Duration (ms) | The time taken to perform this access, in milliseconds. | Yes |
Average Bandwidth (MBps) | The average bandwidth for this access, where the access type was a read. | Yes |
First Frame Index | The ID of the frame this access began on. | Yes |
FramesThe frequency at which consecutive frames are displayed in a running game. More info See in Glossary |
The total number of frames this access occurred for. | Yes |
Thread | The thread the access occurred on. | Yes |
Timestamp (ms) | The time this access started, relative to the start of the profiler capture. | No |
You can right-click on any of the file access markers to open a sub-menu with additional options to explore the data. The available options are as follows:
Property | Function |
---|---|
Show marker in timeline view | Opens this marker in the CPU Usage Profiler module. |
Go to the first frame of this marker | Selects the frame in which the marker first appears in the chart. This option is disabled if the marker only appears on one frame. |
Go to the last frame of this marker | Selects the frame in which this marker last appears in the chart. This option is disabled if the marker only appears on one frame. |
Filter the view to this file path | Populates the search bar with the contents of the Filename column to filter the results. |
When you visit any website, it may store or retrieve information on your browser, mostly in the form of cookies. This information might be about you, your preferences or your device and is mostly used to make the site work as you expect it to. The information does not usually directly identify you, but it can give you a more personalized web experience. Because we respect your right to privacy, you can choose not to allow some types of cookies. Click on the different category headings to find out more and change our default settings. However, blocking some types of cookies may impact your experience of the site and the services we are able to offer.
More information
These cookies enable the website to provide enhanced functionality and personalisation. They may be set by us or by third party providers whose services we have added to our pages. If you do not allow these cookies then some or all of these services may not function properly.
These cookies allow us to count visits and traffic sources so we can measure and improve the performance of our site. They help us to know which pages are the most and least popular and see how visitors move around the site. All information these cookies collect is aggregated and therefore anonymous. If you do not allow these cookies we will not know when you have visited our site, and will not be able to monitor its performance.
These cookies may be set through our site by our advertising partners. They may be used by those companies to build a profile of your interests and show you relevant adverts on other sites. They do not store directly personal information, but are based on uniquely identifying your browser and internet device. If you do not allow these cookies, you will experience less targeted advertising. Some 3rd party video providers do not allow video views without targeting cookies. If you are experiencing difficulty viewing a video, you will need to set your cookie preferences for targeting to yes if you wish to view videos from these providers. Unity does not control this.
These cookies are necessary for the website to function and cannot be switched off in our systems. They are usually only set in response to actions made by you which amount to a request for services, such as setting your privacy preferences, logging in or filling in forms. You can set your browser to block or alert you about these cookies, but some parts of the site will not then work. These cookies do not store any personally identifiable information.