+

Search Tips   |   Advanced Search

Enable site analysis logging


Site analysis logging is not enabled by default. To enable site analysis logging, specify the names and locations of the log files as values for the following parameters in the WP SiteAnalyzerLogService.

For details see Set service configuration properties.

  1. Names for the log files and backup log files.

      SiteAnalyzerFileHandler.fileName

      Specify the location and filename of the log fileDefault is logs/$APPSERVER_NAME/sa.log.

      SiteAnalyzerFileHandler.backupFileName

      Specify the location and filename of the backup file for the log fileDefault is logs/$APPSERVER_NAME/sa_$CREATE_TIME.log. When the log file is backed up, the current data is stored in the backup file, sa_$CREATE_TIME.log, and a new log file, sa.log, is created.

    We can specify the following tokens as part of the directory location or file name:

      $APPSERVER_NAME

      Name of the application server. Use this token for vertical clusters to enforcthat the different appservers write into different files if they share the same file system.

      $CREATE_TIME

      Date and time the file is created. Specify the format of this token in this parameter: SiteAnalyzerFileHandler.dateFormat.

      $CLOSE_TIME

      Date and time the file is closed. Specify the format of this token in this parameter: SiteAnalyzerFileHandler.dateFormat.

    For example, we can specify log file locations and names as follows: log/backup/$APPSERVER_NAME/sa_$CREATE_TIME_$CLOSE_TIME.log.

    If WebSphere Portal is currently writing to a file, the values for $CLOSE_TIME and $CREATE_TIME are the same.

  2. Specify the date format for tokens in the log file names.

      SiteAnalyzerFileHandler.dateFormat

      Specify a value to format the date and time for the $CLOSE_TIME and $CREATE_TIME tokens.

      For example, SiteAnalyzerFileHandler.dateFormat=yyyy.MM.dd-HH.mm.ss.

  3. Specify the interval to back up log files.

      SiteAnalyzerFileHandler.minutesPerLogFile

      Sets the backup interval in minutes. Specify a value between 1 and 60.

      SiteAnalyzerFileHandler.hoursPerLogFile

      Sets the backup interval in hours. Specify a value between 1 and 24.

      SiteAnalyzerFileHandler.daysPerLogFile

      Sets the backup interval in days. Specify any value that indicates the number of days between backups.

    • If you enable more than one date format interval, the smallest interval is used.

    • If we specify 60 minutes the file is backed up after 60 minutes. If we specify 1 hour, the file is backed up on the next full hour; for example, 01:00, 02:00 and so on. If we specify an interval of days, the file is backed up at 24:00 (midnight). For more information about the date format, see the Javadoc documentation for java.text.SimpleDateFormat.

  4. Activate loggers as appropriate: To activate a logger, select the logger you plan to activate and set the value to true.

    For example, SiteAnalyzerSessionLogger.isLogging=true For a list of available loggers refer to Analysis loggers reference.

    Site analysis logging can impact performance. For this reason, we might choose to disable loggers when necessary. To disable loggers, set the value to false.

  5. Restart WebSphere Portal.


Parent: Log and analyze server side site data
Related:
Logging custom details of business events for site analysis
Related reference:
Analysis loggers reference
Understand the site analysis log