Resolve Java Agent Startup Issues

The first thing the Java agent does upon application startup is to register with the Controller. Once registered, the agent should appear in the agents list at Settings > Agent Management > Manage Agents.

If you do not see the agent in the list within a few minutes, check the following:

  1. Make sure you have restarted the application server.
  2. Verify that the javaagent argument has been added to the startup script of your JVM.
  3. Verify that you configured the agent-controller communication properties and agent identification properties in the controller-info.xml file or as system properties in the startup script of your JVM.
    See Java Agent Configuration Properties.
  4. Check the Agent logs directory located at <agent_home>/ver<version_number>/logs/<node_name> for the agent.log file.
  5. Verify that the Agent is compatible with the Controller.
    See Agent and Controller Tenant Compatibility.