.NET Compatibility Mode

This page explains how to set compatibility mode for the .NET Agent. Compatibility mode allows you to collect and view machine or server metrics on a server with Machine and .NET Agents installed.

Before You Begin

Review the list of requirements and general information about compatibility mode:

  • .NET Compatibility Mode is required for metrics from a Machine Agent and a .NET Agent on the same server to be visibly associated with the same node in the Controller UI.
  • Differences may exist between metric values reported by the Machine Agent and the .NET Agent due to different averaging rates and measurement methods.
  • You must enable .NET Compatibility Mode on the Machine Agent.
  • When .NET Compatibility Mode is enabled:
    • Events from Service Availability and Custom Extensions appear in the Servers tab, but are not associated with .NET applications in the Controller UI.
    • The Controller UI may show the server name with " -java-MA " appended to the host ID. Thus, a Machine Agent with a <unique-host-id> set to " ABC " might appear as " ABC-java-MA " in the Controller UI. This is expected behavior; the " -java-MA " suffix indicates that the host has a Machine Agent running in .NET Compatibility Mode.
  • Do not specify the <application-name> , <tier-name> , or <node-name> properties on the Machine Agent. These properties are used with a Machine Agent on a host that has no other Splunk AppDynamics Agents installed.

Enable Compatibility Mode

To enable .NET Compatibility Mode:

  1. Enable .NET Compatibility Mode on the Agent using one of two methods:
    • Set these options in <machine_agent_home>/conf/controller-info.xml:

      1. <dotnet-compatibility-mode>true</dotnet-compatibility-mode> You may need to add this line to the controller-info.xml file.

      2. <unique-host-id><unique-host-id-of-dot-net-agent></unique-host-id> For both Agents to report metrics to the same node, the Machine Agent must use the same case-sensitive Unique Host ID used by the .NET Agent. See FAQs and Troubleshooting.

    • Set the ./bin/machine-agent system property to: ./bin/machine-agent -Dappdynamics.machine.agent.dotnetCompatibilityMode=true
  2. Save the controller-info.xml file.
  3. Start or restart the Machine Agent to apply the changes.