Information:

Environment

AppMon: all versions

Symptoms

How to exclude assemblies from instrumentation on AppMon .NET agents

Solution

To exclude assemblies from instrumentation, please use one of the 2 options:

  • Add an environment variable named DT_EXCLUDEDASSEMBLIES with a comma separated list of the to-be-excluded assemblies. Example:

    DT_EXCLUDEDASSEMBLIES=Aspose.PDF.dll,Aspose.Words.dll

    All .NET agents on that host that can see the environment variable will not instrument the list of assemblies

  • More selectively by adding a registry string value named excludedassemblies to the related agent configuration below

    [HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\dynaTrace\Agent\whitelist\<num>]

    Every numeric subfolder will represent one agent configuration visible in the .NET Agent Configuration Tool. Note: On 32bit editions of Windows the Wow6432Node folder is not existing, so the correct path will simply be without that folder ([HKEY_LOCAL_MACHINE\SOFTWARE\dynaTrace\Agent\whitelist\<num>]).

    As the value, set the comma separated list of assemblies. Example:

 

Icon

Please be aware of that some assemblies are essential and are not allowed to be excluded, otherwise the .NET agent will not work anymore. Those are (currently with feature set of AppMon v7.0 GA):

Classic AgentAppMon Agent (formerly known as OneAgent)
  • mscorlib.dll
  • System.dll
  • System.Data.dll
  • System.EnterpriseServices.dll
  • System.Messaging.dll
  • System.ServiceModel.dll
  • System.Web.dll
  • System.Web.Services.dll
  • System.Windows.Forms.dll
  • PresentationCore.dll
  • amqmdnet.dll
  • RabbitMQ.Client.dll
  • mscorlib.dll
  • System.dll
  • System.Data.dll
  • System.Data.Common.dll
  • System.Diagnostics.DiagnosticSource.dll
  • System.Messaging.dll
  • System.Net.Http.dll
  • System.Private.CoreLib.dll
  • System.ServiceModel.dll
  • System.Web.dll
  • System.Web.Services.dll
  • System.Windows.Forms.dll
  • Microsoft.AspNetCore.Http.Abstractions.dll
  • Microsoft.Owin.dll
  • Microsoft.ServiceFabric.Services.dll
  • Microsoft.ServiceFabric.Services.Remoting.dll
  • presentationframework.dll
  • amqmdnet.dll