ANTS Profiler
Latest version: 4.3
Notes & articles
How to profile the performance of a single .NET assembly (ANTS Profiler 3)
This article will explain how you can use ANTS Profiler 3 to limit the performance profiler to a single assembly. This can be a useful technique when you know that there are performance issues in a specific assembly or component. The benefits of setting up the profiler to profile just one assembly are that:
- ANTS Profiler will run more quickly, as it is profiling less code
- The results will only contain profiling data about methods in this assembly, which reduces the amount of information that you will have to review
Setting up the profiler
We will work through setting up ANTS Profiler to profile one component of a .NET desktop application. Exactly the same technique can be applied to all the other different types of .NET application, including ASP.NET web applications, and .NET Windows Services.
Let us imagine, for the sake of this article, that we have written a .NET desktop application called "CoolApp". The architecture of this simple application is shown in the diagram below. The user interface is contained in the main executable RedGate.CoolApp.exe. This executable uses two additional components that we have also written: RedGate.Library1.dll and RedGate.Library2.dll. All three .NET assemblies make extensive use of several .NET Framework libraries.
All the classes in RedGate.CoolApp.exe sit in the RedGate.CoolApp namespace.
All the classes in RedGate.Library1.dll sit in the namespace RedGate.Library1.
All the classes in RedGate.Library2.dll sit in the namespace RedGate.Library2.

When we run our "CoolApp", we quickly spot that there is a serious performance problem, and we know immediately that the problem must lie in Library1. We are keen to profile the performance of just this one dll.
We set up performance profiling of "CoolApp" in the usual fashion, using the ANTS Profiler 3 project wizard. The final screen of the wizard is the point at which we can customize the project to restrict profiling to just one library. We specify that we want to use a Custom filter to limit the areas of the application that will be profiled.

We edit the custom filter and specify that we are only interested in profiling a particular namespace, as shown below. In this case, we set up a filter that will cause ANTS Profiler to only profile methods that are part of the RedGate.Library1 namespace. This is exactly what we want, and we are now ready to start profiling.

We can now proceed with profiling in the usual fashion. However, when we get performance profiling results, either by taking a snapshot, or by closing down the application, they will only contain data about methods in RedGate.Library1.dll.

This approach massively reduces the number of methods that are profiled and shown in the results. Our task of hunting down bottlenecks is greatly simplified.
Additional comments
This simple technique can be applied to all other types of .NET application. You will need to find out the namespaces that are used by each component, but this is a straightforward task that can be accomplished quickly and easily using the Object browser in Visual Studio .NET.
Filtering in ANTS Profiler 3 can be made even more granular by specifying right down to the class or method name. For example, if we were concerned about the performance of a specific class, we could set up a filter to only profile that class only profile .NET methods that start with RedGate.Library1.MySpecialClass or, for a specific method, only profile .NET methods that start with RedGate.Library1.MySpecialClass.MyReallySlowMethod.
Sometimes there is not a one-to-one correspondence between namespaces and components. For example, the types exposed by the .NET Framework in the System.Collections.Generic namespace are shared between mscorlib.dll and System.dll. If we wanted to profile only the methods in System.dll, we would need to specify the namespace filters down to the class level, as above.
ANTS Profiler 3 does not present the user with a list of components that a particular application will use at runtime. This might seem like an obvious approach to make filtering easier. Although this would be relatively straightforward for .NET desktop applications, it is much less clear for profiling an ASP.NET web application specified by a single URL.
Memory profiling
You cannot specify any filtering of memory profiling when you set up a project. The reason for this is that all .NET memory objects are interlinked. However, once you have taken a snapshot of memory usage, you can filter the All objects tab to just show the objects allocated from a particular module.
Conclusion
This article illustrates how ANTS Profiler can be used in instances where you really need to focus on a performance bottleneck within a single .NET component.
Was this article helpful?
ANTS Profiler
- Enabling logs to track the profiling session
- Changing the interprocess communications ports in version 4
- Double hit counts occurring on one line
- System.EntryPointNotFoundException (Versions: 3,4 only)
- Version 3.0 Unhandled startup exception on Windows Vista
- Version 3 add-in grayed out on non-English Visual Studio 2005 and 2008
- Methods in (ASCX) web controls may not appear
- Failed to CoCreate Profiler error profiling a Windows service
- Multiple-core portable computers may show inflated times (version 3)
- No .NET methods were profiled on web application
- ANTS Profiler code instrumentation method
- Profiling a single assembly in version 3
- Filtering results by individual thread
- Add-in fails to load when using RunAs to start Visual Studio as another user
- Profiling unit tests using Nunit
- Can I profile Compact Framework applications?
- Profiling a SharePoint 2007 Web Part
- Profiling an assembly in the Global Assembly Cache (GAC)
- Additional hidden statistics in the results grid (version 3)
- Multiple floating ANT icons in Visual Studio (version 3)
- ANTS Profiler overhead adjustments
- Profiling IIS web applications that need to run under the SYSTEM account
- Profiling a web application hosted in IIS on a fixed TCP port
- Add-in 'Object Reference not set to an instance of an object' error
- Profiling client-side XBAP .NET applications
- ANTS Profiler prompts for location of source code which is not your own source code
- ANTS menu remains in Visual Studio after uninstall of ANTS Profiler
- Profiling a web application needing to run as the Network Service account
- Abnormal termination caused by .NET 2.0 critical finalizer threads
- Cannot start COM+ application via Remote Desktop
- Fast mode and memory profiling options unavailable
- Finding the overall time taken to execute a thread
- Running an IIS application pool as a named identity
- IIS web application always loads default website
- Profiling BizTalk applications
- Profiling Microsoft Office managed-code add-ins
- The system cannot find the file specified
- Error Stopping IISAdmin profiling IIS web application on Windows XP
- ANTS Memory Profiler total size of all objects does not match the memory footprint of an application
- Lines of source code do not align with hit count, time data in version 3
- Creating a global debugging symbols (PDB) directory
- Profiling a SharePoint site collection
- Using the add-in to profile solutions containing more than one project
- Methods may be missing on multi-core systems in version 3
- ASP .NET 1.x application recycling causing incomplete results
- Ambiguous site selection message when profiling IIS applications
- Application recycling causes incomplete results and other errors when profiling ASP .NET
- Profiling WCF services hosted in IIS
- Cannot profile IIS 6 web application on port lower than 1024
- (version 5) Support for profiling Silverlight applications
- Couldn't open metabase error when profiling ASP .NET hosted in IIS
- Failed to coCreate Profiler on ASP .NET web application
- HTTP error 404.17 profiling ASP .NET 1.1 on IIS 7
- Performance counters missing from results
- Isolating single ASP .NET pages in ANTS Profiler results
- Missing hits for lines in the source code view
- ANTS Profiler restarts IIS
- Showing the amount of time taken for a method in one particular thread
- Common ASP .NET memory issues
- Please specify a valid URL message profiling ASP .NET
- Times on individual lines do not add up to method time
- Manually installing the add-in
- Error starting services running as "Local Service"
- Explanation of "thread blocked" methods in ANTS Profiler
- Call graph percentages do not add up exactly
- Operation could destabilize the runtime error profiling ASP .NET
- IIS ceases to work after profiling web applications
- Access to the Temp directory is denied error profiling web applications
- Problems with ANTS Visual Studio integration
- Unable to coCreate Profiler error profiling any application
all products
- Some Red Gate products identified as containing a trojan by Anti-Virus software
- Activation may fail with Unknown Error -1
- Product uses web help although a CHM file is available locally
- Argument exception resulting from missing environment variable
- Check for updates may fail when used through proxies
- 'Unidentified Publisher' error when repairing or uninstalling
- Licensing activates product as standard edition
- Moving Red Gate software products to another machine
- Red Gate tools log locations
- The application UI opening slowly when there is no internet access
ANTS Profiler
- Getting help offline
- Finding memory leaks using ANTS Profiler
- Identifying root objects with ANTS Profiler
- Performance profiling with ANTS 4: tips for ANTS 3 users
- How to profile a desktop application that hosts the .NET runtime (ANTS Profiler 3)
- How to profile the performance of a single .NET assembly (ANTS Profiler 3)
- Profiling ASP.NET applications (ANTS Profiler 3)
- How to reduce the number of topics you see in the "All objects" panel (ANTS Profiler 3)
- ANTS Profiler release notes - version 4.xx
- Why can't ANTS Profiler find my source code? (ANTS Profiler 3)
all products
- Red Gate product acknowledgements
- Activating your products
- Activating your products
- Red Gate bundle history
- Check for updates
- Troubleshooting Check for Updates errors
- Current versions
- Deactivating your products
- Installing Red Gate products from the .msi file
- Requesting additional activations
- Serial numbers for bundles
- Reactivating using a different serial number
- Extending your trial
- Finding your serial numbers
- Moving a serial number from one computer to another
- No response received for manual activation
- Licensing and activation resources
- Licensing and activation resources
- Troubleshooting licensing and activation errors
- Licensing and activation FAQs
- Red Gate tools log file locations
- Download old versions of products
- Download product prerequisites & utilities
- Support & upgrades
- Upgrading your software
- Upgrading FAQs

Using ANTS Performance Profiler