Knowledge Base

cancel
Showing results for 
Search instead for 
Did you mean: 

Troubleshooting Agent Issues - FAQs

How can I troubleshoot Agent issues?

 

Table of Contents


 

How do I delete an abandoned Machine Agent when it is not attached to any APM agents? 

There are two ways to delete the abandoned machine agent, either from controller UI by creating a dummy application or through a manual step to delete the agent from the database. See the steps for either process under Delete abandoned machine agent.

 

 

What is the best way to set up alerts for App Agent Status and Machine Agent Status? 

There are two solutions for this, found in Agent Status on .NET 

 

 

What does the error message "account key doesn't match with the current account for machine id" mean?

The "account key doesn't match with the current account for machine id" message indicates that the account key generated by the AppDynamics Controller during the registration may be now changed. This could happen if you migrate the Controller without shutting down the agents.

 

Restart the agent to resolve the error.

 

 

How do I resolve an Agent causing overhead or crash?

Follow these steps to troubleshoot:

  1. Check the agent logs for any communication errors between Agent and Controller.
  2. Make sure ALD has not been turned on for a long time.
  3. The Agent requires 30 MB of permgen space. Set this parameter (-XX:MaxPermSize=<value>) to a higher value (256m at least) and try again.
  4. Get the crash report and heap dump for analysis.
  5. Check the agent log level is set to INFO (default log level value if not changed to debug/trace) at agent_dir/conf/logging/log4j.xml.
  6. Make sure periodic sampling and occurrence request sampling is not set to a low value (default 100 requests and 10 min, update/disable as per requirement).
  7. Check the agent logs if any repetitive exceptions are logged.
  8. Disable the agent from the node dashboard and monitor the heap usage whether the overhead/crash is still happening to find whether agent/webapp instrumentation
    is raising the issue.

 

 

When requesting Agent logs, the log status times out

On requesting Agent logs in <Application> -> Servers -> App Servers -> <tier> -> <node> -> Agents, you may experience a timeout of the log status.

 

One possible cause is that someone first requested the log and reset the agent before the log sends to the Controller. To resolve the error, reset the Agent before requesting the agent log.  

 

 

Can I assign a Machine Agent to multiple applications on the same server?

To assign a Machine Agent to multiple applications on the same server, run one Machine Agent process for each application on a machine.

  1. Add the VM parameter (-Dappdynamics.agent.uniqueHostId=<<some unique value per application>>) to both Machine Agent and the App Agent.
  2. Provide the same value to the machine - app agent pair.
    • For example, if you have 2 nodes (n1 and n2 ) reporting to applications (a1 and a2). Let's say m1 and m2 are your machine agents for the corresponding nodes. You will need to pass -Dappdynamics.agent.uniqueHostId=a1 for n1 and m1. and -Dappdynamics.agent.uniqueHostId=a2 for n2 and m2.
  3. The uniqueHostId value can be any unique value but should be different for each application.
  4. Restarting the JVMs with the above options. you should see machine agents associating with corresponding applications. 

 

 

How do I export a list of Agents and details into a spreadsheet?

Other than viewing the list of AppDynamics Agents in Settings, can I get a list of those Agents and their details in a spreadsheet format?

 

 It's not out of the box, but there is a workaround:

  1. Create a small program which can read /controller/rest/applications
  2. List all applications and get list of nodes from /controller/rest/applications/<application-name|application-id>/nodes
  3. Go to AppDynamics Agents page.
  4. Take a screenshot of the AppDynamics Agents page
  5. Trim the picture and copy it to One Note
  6. Right-click the picture in OneNote and select  Copy to Text

 

More Troubleshooting Guides:

 

Published 2/26/2018

Version history
Revision #:
10 of 10
Last update:
‎06-25-2020 04:19 PM
Updated by:
 
Labels (1)


Found this article helpful? Click the Thumbs Up button.
Have an additional comment? Post it below.
Comments

what is ALD?



Found this article helpful? Click the Thumbs Up button.
Have an additional comment? Post it below.