Resource Contentions View - Contention Data

 

For the latest documentation on Visual Studio 2017, see Visual Studio 2017 Documentation.

For the latest documentation on Visual Studio 2017, see Resource Contentions View - Contention Data on docs.microsoft.com. The Resource Contention view lists contention data for the resources that were the source of contention events. A contention event occurs when a function in a thread is forced to wait for access to the resource because a function in another thread has acquired exclusive access to the resource. Each resource is the root node of a call tree that displays the function execution paths that resulted in the contention events.

Resource values

The data in a resource row displays the total time that access to the resource was blocked in the profiling data and the total number of contention events that occurred because of access conflict to this resource. Inclusive and exclusive values for a resource are always the same.

Function values

Function values are based on the instances of the function that occurred in the execution path represented in the call tree.

  • Exclusive values are based on the events that occurred when the function was executing statements in its function body. Events that occurred in functions that were called by the function are not included in exclusive values.

  • Inclusive values are based on the events that occurred when the function or a function called by the function was executing.

Percentage values

Percentage values are based on the total time or contention events in the profiling data. If the report or view of the profiling run is filtered, only the blocked time and contentions in the filtered data are used as the total value.

ColumnDescription
NameThe name of resource or function.
Exclusive Blocked Time- For a resource, the total time that access to the resource was blocked and caused a thread to wait.
- For a function, the time that these instances of the function were blocked from accessing the parent resource when the function was executing code in the function body. Blocked time in functions that were called by the function is not included.
Exclusive Blocked Time %- For a resource, the percentage of all blocked time in the profiling data that was blocked time of this resource
- For a function, the percentage of all blocked time in the profiling data that was exclusive blocked time of these function instances.
Exclusive Contentions- For a resource, the total number of times that access to the resource was blocked and caused a thread to wait.
- For a function, the number of times that these instances of the function were blocked from accessing the parent resource when the function was executing code in the function body. Blocking events in functions that were called by the function are not included.
Exclusive Contentions %- For a resource, the percentage of all contention events in the profiling data that were contention events for access to this resource.
- For a function, the percentage of all contention events in the profiling data that were exclusive contention events of these function instances for the parent resource.
Inclusive Blocked Time- For a resource, the total time that access to the resource was blocked and caused a thread to wait.
- For a function, the time that these instances of the function or any functions called by the instances were blocked from accessing the parent resource when the function was executing code in the function body.
Inclusive Blocked Time %- For a resource, the percentage of all blocked time in the profiling data that was blocked time of this resource
- For a function, the percentage of all blocked time in the profiling run that was inclusive blocked time of these function instances.
Inclusive Contentions- For a resource, the total number of times that access to the resource was blocked and caused a thread to wait.
- For a function, the percentage of all contention events in the profiling run that were inclusive contention events of these function instances for the parent resource.
Inclusive Contentions %- For a resource, the percentage of all contention events in the profiling run that were contention events for access to this resource.
- For a function, the number of times that these instances of the function were blocked from accessing the parent resource when the function was executing code in the function body. Blocking events in functions that were called by the function are not included.
LevelThe depth of this function in the call tree. Only in VSPerfReport command-line reports.
Function Line NumberThe line number of the start of this function in the source file.
Module NameThe name of the module that contains the function.
Module PathThe path of the module that contains the function.
Process IDThe process ID (PID) of the process in which the function was executing.
Process NameThe name of the process.
Source FileThe source file that contains the definition for this function.
Show: