Exceptions

Last modified: 08 March 2021

When Exceptions is selected in the Events filter, dotTrace shows data about exceptions occurred in the app during profiling. For example, Call Tree shows methods where the exceptions were thrown.

Select the Exceptions event to analyze exceptions and their origin.

When you select the Exceptions event, dotTrace adds the auxiliary Exceptions: Type filter to the Filters window.

Exceptions: Type

The filter is used to show types of exceptions and filter out point events where certain exceptions were raised. Use this filter to analyze exceptions in your application: determine threads and methods that throw them, and so on. For example, if you want to determine methods that raised exceptions of a particular type, select Exceptions and the exception type in Exceptions: Type. The methods will be shown in the Call Stack window in Methods and Subsystems.

Exceptions type 1

Pos 1 Exception type name.

Pos 2 The number of raised exceptions.

Pos 3 The percentage of exceptions of the certain type relative to the total number of exceptions.

For example, your application has two threads: Thread#1 and Thread#2. During profiling, Thread#1 raised 2 DivideByZeroException and 2 SomeUserException. Thread#2 raised 1 SomeUserException. The Events filter for these two threads will look like follows:

...
Exceptions 5

The Exceptions: Type filter for these two threads will look like follows:

SomeUserException 3 60.00%
DivideByZeroException 2 40.00%

To apply the Exceptions: Type filter

  • Select the desired type(s) in the filter.

After you select a type in Exceptions: Type, other filters will show only the point events where the exceptions of the selected type were raised. For example, Methods and Subsystems in the Call Stack window will show the list of methods that raised the exceptions.

Exceptions type 2

Exceptions: Message

The filter is used to show exception messages and filter out point events where exceptions with certain messages were raised. Use this filter to analyze exceptions in your application: determine threads and methods that raise them, and so on.

Exceptions message 1

Pos 1 Exception message.

Pos 2 The number of raised exceptions.

Pos 3 The percentage of exceptions with the certain message relative to the total number of exceptions.

To apply the Exceptions: Message filter

  • Select the desired message(s) in the filter.

After you select a message, other filters will show only the point events where the exceptions with the selected message were raised.

Exceptions message 2