[jira] [Created] (TOMEE-1631) Basic Rotating JUL Handler

["Romain Manni-Bucau (JIRA)" <ji...@apache.org>]

Romain Manni-Bucau created TOMEE-1631:
-----------------------------------------

             Summary: Basic Rotating JUL Handler
                 Key: TOMEE-1631
                 URL: https://issues.apache.org/jira/browse/TOMEE-1631
             Project: TomEE
          Issue Type: Bug
         Environment: Supporting rotation by day AND size, archiving of old logs and purge of old archives.


            Reporter: Romain Manni-Bucau
            Assignee: Romain Manni-Bucau
             Fix For: 7.0.0-M2


Doc:

 *  NOTE: for simplicity the prefix `org.apache.tomee.jul.handler.rotating.LocalFileHandler.` has been removed of name columns.
 *
 *  |===
 *  | Name                      | Default Value                                     | Description
 *  | filenamePattern           | ${catalina.base}/logs/logs.%s.%03d.log            | where log files are created, it uses String.format() and gives you the date and file number - in this order.
 *  | limit                     | 10 Megabytes                                      | limit size indicating the file should be rotated
 *  | dateCheckInterval         | 5 seconds                                         | how often the date should be computed to rotate the file (don't do it each time for performances reason, means you can get few records of next day in a file name with current day)
 *  | bufferSize                | -1 bytes                                          | if positive the in memory buffer used to store data before flushing them to the disk
 *  | encoding                  | -                                                 | file encoding
 *  | level                     | ALL                                               | level this handler accepts
 *  | filter                    | -                                                 | filter used to check if the message should be logged
 *  | formatter                 | java.util.logging.SimpleFormatter                 | formatter used to format messages
 *  | archiveDirectory          | ${catalina.base}/logs/archives/                   | where compressed logs are put.
 *  | archiveFormat             | gzip                                              | zip or gzip.
 *  | archiveOlderThan          | -1 days                                           | how many days files are kept before being compressed
 *  | purgeOlderThan            | -1 days                                           | how many days files are kept before being deleted, note: it applies on archives and not log files so 2 days of archiving and 3 days of purge makes it deleted after 5 days.
 *  | compressionLevel          | -1                                                | In case of zip archiving the zip compression level (-1 for off or 0-9).
 *  |===
 *
 *  NOTE: archiving and purging are done only when a file is rotated, it means it can be ignored during days if there is no logging activity.
 *
 * NOTE: archiving and purging is done in a background thread pool, you can configure the number of threads in thanks to
 * `org.apache.tomee.jul.handler.rotating.BackgroundTaskRunner.threads` property in `conf/logging.properties`.
 * Default is 2 which should be fine for most applications.



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)