Resolve Configuration Errors

  • Set your IIS applications to a Full trust level. .NET Agent reporting will not work if an IIS application is set to anything other than a Full trust level.
  • Ensure that you have correctly configured the config.xml file for the App Agent for .NET. See .NET Agent Configuration Properties.
  • If you manually edited the config.xml AgentLog.txt WarnLog.txt

    2014-03-13 10:49:18.7199 1232 dllhost 1 1 Error ConfigurationManager Error reading the configuration file
  • Resolve Log Issues

The .NET Agent writes logs to these 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. Select IIS > Application pools. IIS displays the list of application pools for your machine. Application Pools

  2. Right-click a particular application pool.

  3. Select Advanced Settings.Advanced Settings IIS displays the Application Pool Identity for that application.Application Pool Identities

  4. Ensure that your Agent Directory also has the same permissions as your site application pools.

    • Navigate to .NET App Server Agent directory location.
    • Right-click the logs directory for the App Server Agent and select Properties. Permissions For Logs
    • Select the Security tab, and verify that the same Application Pool Identity is specified for the .NET Agent directory. Security

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

  1. In the Security tab, select Edit.

  2. Select Add to add new permissions to the Agent directory.

  3. Select Advanced.

  4. Click Find Now to find all the users, groups, or built-in security principals on your machine.

  5. Select the required group from the list and click OK. Review the information that follows for Allowed groups.

  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 6.x, these 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 >= IIS 7.0, these 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 that follows

Custom Account

Provide the exact name of the account.

Application Pool Identity

Permission Level

LocalServiceLOCAL SERVICE
LocalSystemSYSTEM
NetworkServiceNETWORK SERVICE
ApplicationPoolIdentityProvide the group level permissions for IIS_IUSRS GroupSee the screenshot that follows
Custom AccountProvide 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 directory.

Agent Directory