14.3. Viewing the Log

Abstract

You can view the log using your systems text display mechanisms, the Red Hat JBoss A-MQ console, or the administration client.

Overview

There are three ways you can view the log:
  • using a text editor
  • using the broker's, or a remote broker's, console
  • using the administration client

Viewing the log in a text editor

The log files are stored as simple text files in InstallDir/data/log. The main log file is karaf.log. If archiving is turned on, there may be archived log files also stored in the logging directory.
Log entries are listed in chronological order with the oldest entries first. The default output displays the following information:
  • the time of the entry
  • the log level of the entry
  • the thread that generated the entry
  • the bundle that generated the entry
  • an informational message about the cause of the entry

Viewing the log with the console

The JBoss A-MQ console provides the following commands for viewing the log:
  • log:display—displays the most recent log entries
    By default, the number of entries returned and the pattern of the output depends on the size and pattern properties in the org.apache.karaf.log.cfg file. You can override these using the -p and -d arguments.
  • log:display-exception—displays the most recently logged exception
  • log:tail—continuously display log entries

Viewing the log with the administration client

If you do not have a broker running in console mode, you can also use the administration client to invoke the broker's log displaying commands. For example, entering client log:display into a system terminal will display the most recent log entries for the local broker.