The timeline is visible throughout a profiling session, and provides a frequently updated display of performance counter values and instances of events related to the application you are profiling. You can use this overview of application activity to isolate performance-profiling results for specific time periods.
To see profiling results for a specific period of your application's execution, select a region on the timeline. You can select any region as often as you need to, both during profiling and after you have stopped profiling and closed your application. You can also create bookmarks for selected regions, enabling you to define multiple regions and switch between them to look at data for different time periods.
The overview timeline shows performance data for the entire profiling session, with the currently selected region of the overview timeline shown in the main timeline pane. The main timeline shows the values of a selection of Windows performance counters.
You can choose which performance counters to display before you start profiling your application. By default ANTS Performance Profiler shows you only Processor Time
For more information, see Setting up chart performance counters
The event bar on the timeline shows event markers. These indicate when certain types of event occur within your application, for example, button clicks, window activations, and exceptions.
For more information, see: Working with event markers and method events
Working with regions on the timeline
You can click anywhere on the main timeline to select a point in time. Information about the selected point is shown in the Selected Point tab to the left of the timeline:
You can select, adjust, and bookmark regions on the timeline. Whenever you select a region, profiling results are displayed that relate to the selected region only.
Selecting and adjusting a region
To select a region, on the overview timeline, do any of the following:
- Click and drag the slide bar to the region you want to select.
- Click anywhere on the overview timeline to select a region centered on the pointer.
Hold down the Shift key, and click and drag the edge of the slide bar to start selecting a new region from that point.
To move or adjust the timescale of a selected region, do any of the following:
- On the overview timeline, click and drag the edge of the slide bar to resize the selected region.
- On the main timeline, click and drag the mouse pointer to pan the timeline.
- On the main timeline, hold down the Shift key and click and drag the pointer to zoom in on a selected region.
- On the main timeline, rotate the mouse wheel to zoom in or out.
Bookmarking a region
Bookmarks let you quickly compare regions of the timeline that you are interested in. You can bookmark a point in time or a period of time, if you want to isolate a specific piece of your application's activity.
You can create a bookmark either during or after profiling.
To bookmark a selected region, click
The selected region is now bookmarked, and is shown in the overview timeline and added to the Current Bookmarks list.
To select this bookmarked region again later, click on it on the overview timeline or in the Current Bookmarks list. Your bookmark is labelled according to the time period it spans, but you can rename a bookmark to make it easier to identify. To rename a bookmark, on the Current Bookmarks list, click next to the bookmark you want to rename.
To delete a bookmark, click next to the bookmark you want to delete.
In addition to bookmarking existing regions of the timeline, you can record live bookmarks as you profile. This is useful if you want to bookmark the behavior of your application during or after a specific event or user input. In other words, live bookmarks allow you to tally what you are doing with the results.
To start recording a live bookmark, click . When you want to stop bookmarking the current profiler activity, click
The new bookmark is shown in the overview timeline and Current Bookmarks list, and behaves in the same way as if you had created it with the button.
Working with performance counters
You can choose which performance counters to display when you set up a new profiling session; see Setting up chart performance counters. To view the performance counters available for the current profiling session, to the left of the timeline, click the Chart Counters tab:
The Chart Counters tab shows all your counters, and lets you highlight one as a main counter. The main counter is shown as a filled box, and the area under its graph is shaded on the timeline. Other counters are shown with an unfilled box in the Chart Counters tab and by colored lines on the timeline.
To set a different counter as the main counter, click on its name in the Chart Counters tab. Values for the main performance counter are shown on a tooltip when you move your pointer over the main timeline. The values on the vertical axis of the main timeline are set by the main counter.
To remove a counter from the timeline, in the Chart Counters tab, clear the checkbox next to its name.
To split the timeline into separate graphs for each performance counter, click
To merge the graphs again, click
Working with event markers and method events
The events bar directly below the main timeline indicates when certain events occurred within your application.
Events are displayed using colored markers:
Window activated and window closed
All other events
To see more detail about an event, click on the event marker in the event bar or the timeline. Information about the event is shown in the Selected Point tab:
Click to see which method caused an event in the call tree or method grid.
If you click on a method in the call tree, on the methods grid, or when you display the call graph for a method, the times when that method executed are shown as light green areas in the events bar. These areas are called 'method events'. If the method called unmanaged code, the period when the unmanaged code ran is shown as dark green.
Adding custom event markers
It is possible to add your own event markers to the timeline. For example, you might want to know when a certain item is loaded into memory or when an ASP.NET page is loaded or unloaded. To add a custom marker:
- Copy %ProgramFles%/Red Gate/ANTS Performance Profiler 8/RedGate.Profiler.UserEvents.dll to your application's bin folder. (Create the bin folder using Windows Explorer if it does not already exist.)
- Reference the DLL from your application.
Add the following line to your application wherever you want to see an event marker on the profiler's timeline. (Replace 'The message' with a short description of the event.)
- When you profile your application, the event is shown in the ANTS Performance Profiler timeline with a black event marker. To see more detail about the event, click on the event marker: