dotTrace 2018.3 Help

Threads Diagram

The Threads diagram visualizes threads activity and filtered time intervals (in case filters are applied). Use the diagram to select threads and time intervals that are interesting for analysis.

threads 1

pos 1 ID
Thread ID.

pos 2 Type
Thread name* or thread type (if a thread does not have a name).

dotTrace distinguishes the following thread types:

  • Main
    The thread that starts the application.

  • Thread Pool
    A thread created by the CLR Thread Pool.

  • CLR Worker
    A worker thread created by CLR.

  • Garbage Collection
    A thread that performs background garbage collection.

  • Finalizer
    A thread that performs object finalization.

  • Native
    An unmanaged system thread.

pos 3 ms / MB / events
Filtered time / allocated memory / number of events. For example, if Not Selected event is selected and no other filters are applied, this will be the entire thread lifetime. If, for instance, you select Waiting in the Thread State filter, this time will be a sum of all Waiting time intervals.

pos 4 %
The percentage of the filtered time / allocated memory / number of events relative to all selected time intervals / allocated memory / number of events.

pos 5 Thread activity timeline
The timeline distinguishes three thread states: Running, Waiting, Ready (corresponding to the Thread State filter). After you apply any filter, the timeline will highlight the filtered time intervals or point events.
Thread timeline can also show detailed info about activity in a particular time point in a smart tooltip. Learn more about tooltips below.

Smart tooltips

Threads diagram in both standalone and Visual Studio viewers support smart tooltips. Hold the mouse over a specific time point on the timeline and a tooltip containing current thread state, executed method, and other info will appear.
Tooltips are context-sensitive. This means that if some filter is applied, the tooltip will contain additional data on the filtered event. For example, when the File Operations filter is selected, the tooltip additionally shows info about file operation, file name, and data size.

smart tooltips

Selecting threads

To select threads

  • Click on the desired thread(s).

After you select a thread(s), the filter by Thread will be applied. All other filters will show data only for the selected thread(s).

Use this to analyze only specific threads.

In some cases, it may be convenient to select all threads of a particular type.

To select threads by type

  1. Open the context menu for any thread which belongs to the type you want to select.

  2. In the context menu, choose Select All <Type_Name> Threads.

Selecting Time Interval and Thread

To select a time interval

  • Drag the mouse over the desired interval and thread holding the left mouse button.

After this, the Selected Time Interval and Thread filter will be applied. All other filters will show data only for the selected time range and thread.

Hiding threads

To simplify analysis, you can hide threads that are not currently interesting (for example, do not perform any work on the selected time interval).

To hide a specific thread

  1. Open the context menu for a thread you want to hide.

  2. In the context menu, select Hide Thread#<ID>.

To hide (non-)selected threads

  1. Select threads.

  2. In the context menu, select Hide Selected Threads or Hide Non-Selected Threads.

To hide threads by type

  1. Open the context menu for any thread which belongs to the type you want to hide.

  2. In the context menu, select Hide All <Type_Name> Threads.

Sorting threads

By default, the list of threads is sorted by their creation order. By clicking on the column headers, you can sort threads by other criterion: ID, Type, ms / MB / events, %. The column that is currently used for sorting is marked with the ThemedIcon SortArrowDown Screen Gray sign.

In some cases, it may be convenient to have a certain thread on top of the list regardless of the sorting order. Use the Move to Top option in the thread's context menu to move any thread to the top.

Zooming

To zoom in/out the diagram

  • Do one of the following:
    • Use the mouse scroll wheel.

    • Press Ctrl + Drag the mouse holding the left mouse button.

After you zoom the diagram, the Visible Time Interval filter will be applied. All other filters will show data only for the currently visible interval.

If a time interval is selected on the diagram, you can zoom in to this interval.

To zoom in to the selected time interval

  • Press Ctrl+O or select Zoom to Selection in the context menu.

After this the selected time range will take the entire diagram.

Panning

To pan the diagram

  • Drag the mouse holding the right mouse button.

Last modified: 15 March 2019