.NET Agent Installation: Enable .NET Core Applications

Retrace has been tested with .NET Core apps targeting the full .NET framework as well as the new .NET Core “netcoreapp” framework. It also works with ASP.NET Core apps that are deployed behind IIS or using Kestrel only in more of the “self hosted” mode.

  • .NET Core is currently only supported for Windows.
  • Some features may not yet be fully supported for .NET Core 2.x applications

There are potentially 3 different types of .NET Core applications:

  • ASP.NET Core app that is hosted with/behind IIS
  • ASP.NET Core app that is running as kestrel only without IIS
  • A console app or Windows service that is not a web app

The Retrace profiler and agent should automatically profile and track ASP.NET Core apps hosted with IIS.

Non IIS apps will require telling the Retrace agent about your app so that it will be profiled.  See this article for more explanation: .NET Agent Installation: Configure Windows Services

To make ASP.NET Core apps work, you must install our middleware.

How to Install the Stackify Middleware:

1. Add the “StackifyMiddleware” nuget package to your project.

PM> Install-Package StackifyMiddleware

2. Modify your Configure() method in Startup.cs to add our middleware. The order in which you add middleware in your code matters. The StackifyMiddleware must be added before you add MVC via the “app.UseMvc()” method.


Retrace Error and Logs also work for .NET Core apps.  See this article for more explanation: Errors and Logs: Configure .NET Core