Logging Settings

Logging is configured in the logging section of the AppDynamics configuration file. See Python Agent Settings and Python Agent.

Logging Levels

Set the logging level for the amount of detail that you want to see: INFO, WARNING or DEBUG. The default is level is WARNING.

For maximum debugging information, set the logging level to DEBUG. Debug-level logs show the information that the Python Agent is sending to the proxy, which can be useful for debugging the agent.

For quick debugging, set the debugging configuration option to on. This causes debug-level logs to be written to both stderr and log files.

This is the behavior you can expect with various combinations of logging level and debug settings:

The various combinations of logging level and debug settings produce behavior as follows:

  • level=info, debugging=off: Info-level logs are written to the log file
  • level=warning, debugging=off: Warning-level logs are written to the log file
  • level=debug, debugging=off: Debug-level logs are written to the log file
  • level=info, debugging=on:  Debug-level logs are written to the log file and to stderr
  • level=warning, debugging=on: Debug-level logs are written to the log file and to stderr
  • level=debug, debugging=on: Debug-level logs are written to the log file and to stderr

The Proxy logging level is separate and is not affected by the configuration settings of the Agent logging levels. Proxy logging level is "info" by default. Typically, you can redirect that output to a file if desired. In case if you wish to increase the logging level output, you must do so by starting the Proxy manually. First assign the new logging level within the Proxy's configuration file (proxy/conf/logging/log4j.xml) and then invoke the Proxy task.   

There is no way to automatically adjust the Proxy logging level from the Agent configuration file settings.

Location and Names of Agent Log Files

Agent logs are written in the directory specified by the dir directive, APPD_LOGS_DIR in the logging section of the configuration file. 

For each node, the log is output to a file named APP_NAME-<NODE_NAME>.log. These files live in the log dir directory, APPD_LOGS_DIR.

The agent creates and rotates a maximum of five log files. Maximum log size is 20 MB, which gives you a maximum of the most recent 100 MB of log data at one time.

For example:

  1. myApp-myNode.log
  2. myApp-myNode.log.1
  3. myApp-myNode.log.2
  4. myApp-myNode.log.3
  5. myApp-myNode.log.4

Location of Proxy Logs

The proxy logs are always written to dir APPD_LOGS_DIR, which defaults to /tmp/appd/logs, APPD_DIR/logs.