On this page:

Related pages:

Verify Agent Controller Communication

Use the AppDynamics UI to verify that the agent is able to connect to the Controller.

  1. In a browser open:

    http://<controller-host>:<controller-port>/controller
    

    If you can't connect to the controller in Internet Explorer, see Check Internet Explorer proxy settings.

  2. Log in to the AppDynamics UI.
  3. Select the application to open the Application Dashboard.
  4. In the left navigation panel click Servers > Tiers & Nodes and open the Health tab.

The Health tab lists the tiers, their nodes, and App Agent Status. When an agent successfully reports to the Controller, you see an "up" arrow symbol.

For details see Agent-to-Controller Connections.

If no data appears after a few minutes:

Check Internet Explorer proxy settings

This section is only for resolving issues connecting to the AppDynamics Controller when step 1 of "Verify Agent Controller Connection" above fails. To configure the .NET Agent to work through a proxy, see "Controller Element" on .NET Agent Configuration Properties.

Misconfigured proxy settings in Internet Explorer may cause the App Agent for .NET to fail to connect to the controller. If Test Controller connection fails on the Controller Configuration window in the AppDynamics Agent Configuration utility, do the following:

  1. Verify the Controller host and port settings are correct.
  2. In Internet Explorer, open:

    http://<controller-host>:<controller-port>/controller
    
  3. If the connection also fails in Internet Explorer, check the proxy settings.  See Change IE Proxy Settings.
  4. Correct or remove any incorrect proxy settings.

Checklist for Resolving  Installation Issues

 

Item 

Notes

(tick)

Run the installer as Administrator.

Verify Administrative privileges

(tick)Verify that MSDTC is enabled and that it is running under the correct account.Verify MSDTC is enabled and running under the correct account

(tick)

Verify permissions for Agent directory.

Verify that the .NET Agent directory has the correct permissions based on the site’s application pool identity.

(tick)

Verify that the Agent is compatible with the Controller.

Agent and Controller Compatibility

(tick)

Verify the correct settings in the config.xml:

Windows Server 2008 and later:
%ProgramData%\AppDynamics\DotNetAgent\Config\config.xml

Update the config.xml file to include the .NET Agent Configuration Properties.

Resolve  Installation Issues

If the Agent installation is failing, check the following configurations in your environment:

Verify administrative privileges

Ensure that you have the administrative privileges when you launch the installer. If the currently user doesn't have sufficient privileges, the installer prompts you for an administrator password.

Verify MSDTC is enabled and running under the correct account

If you encounter an error that MSDTC is not enabled or it is running under the wrong account, launch an elevated command prompt with full administrative privileges and execute the following command:

msdtc -install

Even if MSTDC is already installed, this command resets the service to run using the "NT Authority\NetworkServices" account.

Generate a log for agent installation failures

If the installer fails, use the command line utility to launch the installer.

msiexec /i $Path_to_the_MSI_File /l*v verbose.log

A verbose log for the .NET Agent is created at the same location where you saved the installer file.

Correct failed installation caused by other APM products

The .NET Agent installation may fail if there are other Application Performance Management (APM) products installed in the same managed environment. Remove the associated "Environment" subkey for certain services for the installed APM products.

Remove associated "Environment" subkey for W2SVC and WAS services in the registry:

  1. Run Regedit or regedt32.
  2. In regedit.exe, locate the following registry keys: 
    HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\services\W3SVC
    HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\services\WAS
  3. Expand the keys.
  4. Modify the Environment subkey to delete the following values:

    COMPLUS_ProfAPI_ProfilerCompatibilitySetting=EnableV2Profiler
        COR_ENABLE_PROFILING=1
        COR_PROFILER= {a GUID}
  5. Restart the services. For more details see How to restart the W2SVC and WAS services?

Resolve Configuration Errors

Resolve Log Issues

The .NET Agent writes logs to the following directories: 

 %ProgramData%\AppDynamics\DotNetAgent\Logs

The agent will not generate logs if the agent directory does not have sufficient permissions.

Verify that the .NET Agent directory has the correct permissions

  1. Click IIS > Application pools.
    IIS displays the list of application pools for your machine.
  2. Right-click on a particular application pool.
  3. Click Advanced Settings.

    IIS displays the Application Pool Identity for that application.
  4. Ensure that your Agent Directory also has the same permissions as your site's application pools.

 

If the Agent's logs directory does not have the required permissions:

  1. In the Security tab, click Edit.
  2. Click Add to add new permissions to the Agent directory.
  3. Click Advanced.
  4. Click Find Now to find all the users, groups, or built-in security principals on your machine.
  5. Select the required group (see the information given below for Allowed groups) from the list and click OK.
  6. Provide the read and write permissions for the selected user/group/security principal to the Agent directory and click OK.
  7. Click Apply.

Allowed groups for different IIS versions

For IIS v6.x, following settings are applicable for Application Pool Identities:

Application Pool Identity

Permission Level

LocalService

LOCAL SERVICE

LocalSystem

SYSTEM

NetworkService

NETWORK SERVICE

Custom Account

Provide the exact name of the account.

For IIS v7.0 and later, following settings are applicable for Application Pool Identities:

Application Pool Identity

Permission Level

LocalService

LOCAL SERVICE

LocalSystem

SYSTEM

NetworkService

NETWORK SERVICE

ApplicationPoolIdentity

Provide the group level permissions for IIS_IUSRS Group
(see the screenshot given below).

Custom Account

Provide the exact name of the account.

For example, if your application has the identity "ApplicationPoolIdentity", you must provide the permissions for "IIS_IUSRS" group to your Agent's directory.

 

Known Issues

You may ignore the following error from the AppDynamics.Agent.Coordinator service in the agent.log or warn.log:

2015-12-01 10:12:03.0435 3872 AppDynamics.Coordinator 1 7 Warn MaxQueueItemAgePolicy MaxQueueItemAge is beyond the integer limit: 13093467123