7.6. Enabling Debug Mode for the Agent
The JBoss ON agent, like the JBoss ON server, uses
log4j
for its logging. To troubleshoot agent performance or server-agent communication, enable debug logging for the agent, which enables the log4j
debug log.
The log files are in the
agentRoot/rhq-agent/logs
directory.
7.6.1. Using an Environment Variable
The quickest way to enable debug logging is to set the
RHQ_AGENT_DEBUG
environment variable to any value before starting the agent. When you start the agent, both the launcher scripts and the agent itself will output debug messages.
If the JBoss ON agent is running on Microsoft Windows using the service wrapper, set
RHQ_AGENT_DEBUG
and then install the service:
rhq-agent-wrapper.bat install