Product Documentation

To configure log settings

Jun 12, 2015

You can configure log settings to customize the output of logs that XenMobile generates. If you have clustered XenMobile servers, when you configure log settings in the XenMobile console, those settings are shared with all other servers in the cluster.

In the XenMobile console, click the wrench icon Support tool icon in the upper-right corner of the console.

 


 

The Support page appears in a separate browser tab.

 

Support page

 

Under Log Operations, click Log Settings to access the following options:

 

Log settings page

 

  • Log Size. Use this option to control the size of the log file and the maximum number of log backup files retained in the database. Log size applies to each of the logs supported by XenMobile (debug log, Admin activity log, and user activity log).
  • Log level. Use this option to change the log level or to persist settings.
  • Custom Logger. Use this option to create a custom logger; custom logs require a class name and the log level.

To configure the Log Size options

  1. On the Log Settings page, expand Log Size and configure the following settings:
     

    1. Debug log file size (MB): In the list, click a size between 5 MB and 20 MB to change the maximum size of the debug file. By default, the size of the file is set to 10 MB.
    2. Maximum number of debug backup files: In the list, click the maximum number of debug files retained by the server. By default, XenMobile retains 50 backup files on the server.
    3. Admin activity log file size (MB): in the list, click a size between 5 MB and 20 MB to change the maximum size of the admin activity file. By default, the size of the file is set to 10 MB.
    4. Maximum number of admin activity backup files: In the list, click the maximum number of admin activity files retained by the server. By default, XenMobile retains 300 backup files on the server.
    5. User activity log file size (MB): In the list, click a size between 5 MB and 20 MB to change the maximum size of the user activity file. By default, the size of the file is set to 10 MB.
    6. Maximum number of user activity backup files: In the list, click the maximum number of user activity files retained by the server. By default, XenMobile retains 300 backup files on the server.

To configure Log Level options

Log Level lets you specify what type of information XenMobile collects in the log. You can set the same level for all classes or you can set individual classes to specific levels.

  1. On the Log Settings page, expand Log level. The table of all log classes appears.



  2. Do one of the following:
    • Click the check box next to one Class and then, click Set Level to change just this class's log level.
    • Click Edit all to apply the log level change to all classes in the table.

    The Set Log Level screen appears.


    Set log level dialog

    1. Class Name: This field displays All when you are changing the log level for all classes or it displays the individual class name; it is not editable.
    2. Sub-class name.This field displays All when you are changing the log level for all classes or it displays the individual class sub-class name; it is not editable.
    3. Log level: In the list, click a log level. The supported log levels include:
      • Fatal
      • Error
      • Warning
      • Info
      • Debug
      • Trace
      • Off
    4. Included Loggers: This field is blank when you are changing the log level for all classes or it displays the currently configured loggers for an individual class; it is not editable.
    5. Persist settings: If you want the log level settings to persist when you reboot the server, select this check box. Not selecting this check box means that the log level settings revert to their defaults when you reboot the server.
  3. Click Set to commit your changes.

To add a Custom Logger

  1. On the Log Settings page, expand Custom Logger and click Add.



    The Add custom logger screen appears.



    Configure the following settings:

    1. Class Name: This field displays Custom; it is not editable.
    2. Log level: In the list, click a log level. The supported log levels include:
      • Fatal
      • Error
      • Warning
      • Info
      • Debug
      • Trace
      • Off
    3. Included loggers: Add the loggers to be included in this custom log. You must add at least one logger.
  2. Click Add. The custom logger is added to the Custom Logger table.


    Custom logger table

To delete a Custom Logger

  1. On the Log Settings page, expand Custom Logger and select the custom logger you want to delete.
  2. Click Delete. A dialog box appears asking whether you want to delete the custom logger. Click OK.
    Important: You cannot undo this operation.