dotTrace 2016.3 Help

Exceptions

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.

/help/img/dotnet/2016.3/exceptions_type_1.png

/help/img/dotnet/2016.3/pos_1.png Exception type name.

/help/img/dotnet/2016.3/pos_2.png The number of raised exceptions.

/help/img/dotnet/2016.3/pos_3.png 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:

  • Check 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.

/help/img/dotnet/2016.3/exceptions_type_2.png

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.

/help/img/dotnet/2016.3/exceptions_message_1.png

/help/img/dotnet/2016.3/pos_1.png Exception message.

/help/img/dotnet/2016.3/pos_2.png The number of raised exceptions.

/help/img/dotnet/2016.3/pos_3.png The percentage of exceptions with the certain message relative to the total number of exceptions.

To apply the Exceptions: Message filter:

  • Check 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.

/help/img/dotnet/2016.3/exceptions_message_2.png
Last modified: 20 January 2017