App Agents - Standalone Applications Element

The standalone-applications element is a child of the app-agents element. It is a container element for all the Windows services and standalone applications you configure for instrumentation. See Configure the .NET Agent for Windows Services and Standalone Applications

Optional Element: <standalone-applications>

Standalone Application Element

The standalone-application element is a child of the standalone-applications element. It specifies a Windows service or standalone application to instrument.

Optional Element: <standalone-application executable="MyWindowsApplication.exe" command-line="">

Standalone Application executable attribute

The standalone-application executable attribute specifies the file name of the Windows application to instrument. Set the Standalone Application element executable attribute to one of the following:

  • Executable name: for example, MyStandaloneApp.exe or MyWindowsService.exe. The file extension is optional, so MyStandaloneApp also works.

  • Full path to the executable: for example, C:\Program Files\MyApplication\MyStandaloneApp.exe.
  • Partial path to the executable: for example, MyApplication\MyStandaloneApp.exe. Use the full or partial path to the executable when you want to assign different tiers to separate instances of the same executable running from different paths.

Type: String

Default: None

Required: Yes

Standalone Application command-line attribute

To differentiate between two instances of the same executable, specify any unique portion of the application command line, such as an argument, in the standalone-application command-line attribute.

Type: String

Default: None

Required: No

Standalone application app-domain-name attribute

For applications with multiple application domains, the app-domain-name attribute enables you to limit instrumentation to specific application domains. See Configure Application Domain Monitoring

Type: String

Default: None

Required: No

Standalone Application Tier Element

The tier element is a child of the standalone-application element. If you enable instrumentation for an application, you must use a tier element to assign the application to a tier in the Controller. See Overview of Application Monitoring.

Required Element: <tier name="Consumer" />

Tier name attribute

The tier name attribute indicates the business application tier.

Type: String, may also reference an environment variable. See Reference of Environment Variables

Default: None

Required: Yes

Environment Variable: APPDYNAMICS.AGENT.TIERNAME

Sample Windows Service and Standalone Application Configuration

    <standalone-applications>
      <standalone-application executable="ExampleApplication.exe">
        <tier name="Standalone Application Tier"/>
      </standalone-application>
      <!-- Instrument a Windows service using arguments. -->
      <!-- The following example matches the command "MyWindowsService.exe -d -x -r". -->
      <standalone-application executable="MyWindowsService.exe" command-line="-x">
        <tier name="Windows Service Tier"/>
      </standalone-application>
    </standalone-applications>