Versions Compared

    Key

    • This line was added.
    • This line was removed.
    • Formatting was changed.

    ...

    To instrument Windows services and standalone .NET applications, you edit the .NET Agent configuration file, config config.xml.

    Info

    Instrument the default domain if that 's is where your application runs, as AppDynamics does not automatically instrument the default domain out of the box. To determine whether you should use the default domain, and how to configure it, see Instrument the DefaultDomain for Standalone Applications.

    ...

    Note

    This command only works for 64-bit processes. For 32-bit processes, use the process explorer to view the dependencies of the process and whether there are any .NET .dll 's files loaded into the file.

    The output lists the processes that have DLLs starting with mscor*, indicative of .NET processes. Processes that are not on the list are not .NET processes and cannot be instrumented with the .NET Agent.

    If you have previously instrumented IIS applications on the server that hosts the Windows services and standalone applications, the server should already have a config.xml file that you can edit. If not, perform the following steps to generate one:

    1. Install the .NET Agent. See Install the .NET Agent  for more informationfor Windows
    2. Run the AppDynamics Agent Configuration utility. 

    ...

    Once you have configured the Controller properties for the .NET Agent, instrument your Windows service or standalone application by adding the Standalone Applications element to the config.xml.

    1. Edit the config.xml file as an administrator. See Administer the .NET Agent

      If you haven't have not instrumented any IIS applications, the file contains the minimal configuration for the Controller connectivity and the machine agent. Verify the Controller properties and the Business Application name, as in the following example:

      No Format
      <?xml version="1.0" encoding="utf-8"?>
      <appdynamics-agent xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
        <controller host="mycontroller.example.com" port="8090" ssl="false">
          <application name="My Business Application" />
        </controller>
      ...
      </appdynamics-agent>

      If you have already instrumented IIS applications, those configurations appear under the IIS element.

    2. Add a single standalone applications element (standalone-applications) under  under the app-agents element, and under the standalone-applications element, add a standalone application element, (standalone-application) for each Windows service or standalone application to instrument. For example:

      No Format
      ...
      <app-agents> 
         ...
         <standalone-applications>
            <standalone-application executable="MyStandaloneApp.exe">
              <tier name="Standalone Tier 1" />
            </standalone-application>
            <!-- Instrument a standalone application using a partial path. -->
            <standalone-application executable="MyApplication\MyOtherStandaloneApp.exe">
              <tier name="Standalone Tier 2" />
            </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>
      </app-agents>
      ...

      In the standalone application element configuration:

      • Use the tier element to assign the instrumented application to a tier in the Controller. See .NET Agent Configuration Properties.

      • Identify the application's executable file of the application in the Standalone Application element executable attribute using one of the following formats:

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

        • Full or partial path to the executable. : For example, C C:\Program Files\MyApplication\MyStandaloneApp.exe or MyApplication MyApplication\MyStandaloneApp.exeUse the full or partial path when you want to assign different AppDynamics tiers to separate instances of the same executable file running from different paths.
        • To differentiate between two instances of the same executable, specify any unique portion of the application's command line invocation format of the application, such as an argument, in the Standalone Application command-line attribute.

        Tip

        You can discover the path to a Windows service executable in the Services panel of the administrative tools. In Services, click on the service and choose Properties. The path appears in the General tab.

    3. Restart the AppDynamics.Agent.Coordinator service.

    4. Restart the Windows service or standalone application.

    5. If your Windows service or standalone application doesn't does not implement an auto-detected framework, you must configure a POCO entry point for a class/method in your service for the agent to begin instrumentation.

    Sample Configuration File

    This sample config.xml demonstrates instrumentation for a Windows service and standalone application:

    ...