Install .NET Framework agent for WCF applications

This document explains how to install the New Relic .NET Framework agent for WCF applications (both self-hosted and IIS-hosted).

Recommended: Before following these instructions, first read the .NET agent install overview.

IIS-hosted WCF

To install IIS-hosted WCF apps and ensure that IIS-hosted WCF apps will be instrumented automatically:

  1. Install the latest .NET Framework agent.
  2. Ensure you give each WCF app a descriptive name.
  3. Enable or disable ASP.NET Compatibility Mode depending on which type of events you want to be instrumented:

    ASP.NET Compatibility Mode enabled

    When ASP.NET Compatibility Mode is enabled, the .NET agent instruments ASP.NET pipeline events as well as WCF events. In this mode, the agent provides you with a full view of your application stack.

    ASP.NET Compatibility Mode disabled

    When ASP.NET Compatibility Mode is disabled, the .NET agent only instruments WCF events. Any activity that occurs as part of the ASP.NET pipeline will not be captured, such as agent API calls that are made outside of a WCF transaction. In addition, cross application traces are not supported when ASP.NET Compatibility Mode is disabled.

Self-hosted WCF

Many WCF applications are hosted in IIS, but they can also be hosted as a custom Windows Service, a console app, or a Windows Forms app. To instrument self-hosted WCF applications, see Install for applications not using IIS.

Cross application tracing and distributed tracing are not supported for self-hosted WCF applications.

For more help

Recommendations for learning more: