This site contains the documentation that is relevant to older WSO2 product versions and offerings.
For the latest WSO2 documentation, visit https://wso2.com/documentation/.

System Logs

The System Logs page displays all events of a running server instance. Further, it facilitates downloading and viewing log files according to user preferences. The log files can be retrieved in two ways:

  • If syslog-ng is configured, log files are taken from the remote location where the log files are hosted using syslog-ng server. 
  • If syslog-ng is not configured, log files are taken from the local file system (super-tenant or Stand-alone apps).

You can refer to more information about logs and how to set log properties in the Logging Configuration section. Statistics on system logs are provided by the following feature:

Name: WSO2 Carbon - Logging Management Feature
Identifier: org.wso2.carbon.logging.mgt.feature.group

If it is not bundled in your product by default, you can install the above feature using the instructions given in the Installing Features section. 

Follow the instructions below to access statistics on System Logs.

  1. Log on to the management console and click Monitor -> System Logs.
  2. The System Logs page displays logs in a bottom-up manner.

    The log messages displayed on this page are obtained from a memory appender. Hence, the severity (log level) of the displayed log messages are equal to or higher than the threshold of the memory appender. For more information on appenders, loggers, their log levels and logging, see Apache Log4j 2 Guide.

  3. To view old archived logs, click the Show archived logs tab at the bottom of the System Logs page.
    Click Download to download the wso2carbon.log file to <PRODUCT_HOME>/repository/logs.
  4. In the View list, select the category of logs you want to view. The available categories are:
    • TRACE - Trace messages.
    • DEBUG - Debug messages.
    • INFO - Information messages.
    • WARN - Warning messages.
    • ERROR - Error messages.
    • FATAL - Fatal error messages.
  5. You can also find a specific log using the search function. Enter a keyword (or part of a keyword) and click Search.

    The location of the log files on disk is specified in the log4j.configuration file.