Skip to main content
Skip table of contents

Axon Agent Log Levels

In certain scenarios, enabling a higher level of logging may be beneficial to troubleshooting an Axon Agent installation. This logging level is set on a per-agent basis, and is not enabled on the Agent Profile level. This allows for more targeted usage of elevated logging for the Axon Agent.

It is suggested to leave the log level on “info” during normal operation. Selection of “Debug” or “Trace” level logging may result in a large number of logs being generated.

“Debug” and “Trace” level logs are excluded by default from being sent to the Axon UI by the Agent Logging Collector. These logs must be viewed locally in the lragent.log and fluentd.log files. See the troubleshooting page on your operating system (Windows or Linux) for file locations.

Configure Axon Agent Log Levels

The Axon Agent logging level can be set in the “Edit Agent” screen. This is accessed from the Agent Overview page:

  1. From the Dashboard, click the Administration cog in the lower-left corner.

  2. Under the Integrations section, click Agents.

  3. Click the Agents tab.

  4. Select the Agent that needs to have its log levels modified.
    The Agent Overview page appears.

  5. Click Edit Agent.
    The Edit Agent pop-up appears.

    image-20240524-184811.png
  6. Open the Log Level pop-up and select from the following choices:

    1. Fatal

    2. Error

    3. Warn

    4. Info (Default)

    5. Debug

    6. Trace

  7. When finished, click Save.
    The Axon Agent is updated successfully.

These log levels range from the least verbose (Fatal) to the most verbose (Trace). For example, setting the log level to “Fatal” means only fatal-level logs are shown in the log file. Setting the level to “Trace” means that all logs possible are shown, including the extremely verbose trace-level logs.

“Debug” level logging may be useful for examining normal Agent operation; however, “Trace” level logging should only be turned on when actively diagnosing a problem with Axon Agent. Trace logging is extremely verbose.

Axon Agent log level is a global modifier, and changes the log level of the Axon Agent itself, all enabled collectors, and FluentD.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.