Logging

Logging is a set of tools for viewing and configuring all the logs.

Figure 94. Logs

Logs

Viewing logs

Appeon Server creates three different log files for record keeping and for future use in troubleshooting. You can view these log files using the View button or directly locate them in the <AppeonHome>\repository\<InstanceName>\log folder.

On a click on a View button either in the Appeon Server Logs table or in the Application Server Logs table, you direct access the log files created by Appeon Server and the host application server of Appeon Server, such as JBoss.

  • Appeon Server Logs

    Server Log: the main log file. Records messages logged from services and the core Appeon Server runtime.

    Error Log: the error log.

    Deployment Log: records messages logged during application deployments.

  • Application Server Log

    Server Log: the main log file of the host application server.

The Log Viewer tool provides the following manipulations:

  • To view a log file

    Click View to view the detailed information in the browser. Click the links of different log files to switch between them.

    If the size of the specified log file exceeds 2 MB, a message will pop up indicating that the file should be downloaded before viewing.

    Figure 95. View log files

    View log files

  • To download a log file

    Click Download and click Save on the popup dialog.

  • To clear a log file

    Click Clear to remove the contents in the Appeon Server log files.

    Contents in the application server log file cannot be cleared, because the application server log file may contain records that are not related with Appeon operations.

Log mode

Select one of the following four modes for log file operation.

  • Mode 1: Off

    Off mode does not generate any log files except error log files. It offers the fastest performance.

  • Mode 2: Standard mode

    Standard mode is the default mode, and should be used when the system is stabilized. It generates standard log files that are sufficient for providing basic system activity information and notifies you if errors have occurred. This mode may be inadequate for detailed troubleshooting.

  • Mode 3: Developer mode

    Developer mode generates detailed log files that are sufficient for routine checking and troubleshooting. Performance speed decreases when using this mode.

  • Mode 4: Debug mode

    Debug mode generates log files that record every system activity in detail and provide the user with information for troubleshooting obscure or hard to find issues. Debug mode log files are useful for technical support. There is a noticeable slowdown in performance when using this mode.

Replace log files

Log files accumulate over time, and if they become too large, they can decrease Appeon Server performance. Select the "Replace log files..." option to replace the log files periodically. This section is specifically applicable to AppeonServer.log, AppeonDev.log files and AppeonError.log file.

To configure log file settings:

Step 1: Decide whether the log files should be replaced.

  • Option 1: Never replace log files

    If you select this option, the log files will never be replaced. This option may compromise system performance when the log files become large, in which case they should be manually deleted.

  • Option 2: Replace log files ...

    If you select this option, this option will replace log files according to conditions configured in Step 2. It is highly recommended that you use this option. To create and keep an archive of all logs, check the "Backup log files before replacing" option.

Step 2: Set the condition for replacing log files by checking one of the options.

  • Option 1: Replace log files when size exceeds ___ MB.

    The system automatically replaces the log files when the file size exceeds the value set here.

  • Option 2: Replace log files every ___ day (s).

    The system automatically replaces the log files as stipulated by the value set here.

Step 3: Decide whether the log files should be backed up.

  • This setting allows Appeon Server to back up the log files before replacing them. If this option is checked, all log files are backed up before they are replaced so an archive of the log files is maintained. Maintaining this archive does not compromise system performance, but there must be adequate hard disk space for the backup log files.

  • All backup log files are named according to the following format: Log File name ( "LogSystem") + an underscore ("_") + the time of the creation of the backup file (yyyy/mm/dd/hh/mm) + ".bak". For example: LogSystem_200504081213.bak.