Configuration: Logging

This section of the configuration file configures DataSource's log files. The log files keep a record of all data and to what destinations the data was sent.

log-level

Type: String
Default: INFO

Default logging level

log-monitor-level

Type: String
Default: CRIT

Default logging level to send log events to monitoring

log-syslog-level

Type: String
Default: ERROR

Default logging level to send log events to syslog

log-dir

Type: String
Default: %r/var

Default directory in which to store log files. %r is replaced by application-root, %a will be replaced by application-name.

log-maxsize

Type: Integer
Default: 0

Maximum log file size in bytes. The log files will be cycled if they exceed the size specified here; therefore a value of 0 means log files will cycle every time they are checked.

log-cycle-time

Type: Integer
Default: 240

Time at which logs will cycle, in minutes from midnight.

log-cycle-period

Type: Integer
Default: 1440

Interval between cycling logs, in minutes.

log-cycle-suffix

Type: String
Default: .%u

Suffix for cycled logs. This is passed through strftime (refer to your UNIX manual for further information on strftime). The default of %u results in a file beiang created for each day of the week.

log-cycle-offset

Type: Integer
Default: -1

Specifies how many minutes to take off the current time when creating the suffix. For example, if cycling at 0400 hours, the time passed into strftime to create the suffix will be 0400 hours the previous day.

log-max-history

Type: Integer
Default: 10

Max number of log lines to retain for monitoring

log-use-parent-handlers

Type: Boolean
Default: FALSE

Parent handler

Configuration group add-log

As well as the global configuration options for log files, individual log files may be configured individually. This option overrides the global default for a particular logfile.

Format:

add-log
    name          [value]
    maxsize       [value]
    time          [value]
    period        [value]
    suffix        [value]
    offset        [value]
    level         [value]
    monitor-level [value]
end-log

name

Type: String
Default: None

Name of log

maxsize

Type: Integer
Default: 0

Log file max size

time

Type: Integer
Default: 240

Log Cycle Time

period

Type: Integer
Default: 1440

Log Cycle Period

suffix

Type: String
Default: .%u

Log Cycle Suffix

offset

Type: Integer
Default: -1

Log Cycle Offset

level

Type: String
Default: None

Log level

monitor-level

Type: String
Default: None

Log level to to push log events to monitoring

syslog-level

Type: String
Default: None

Log level to to push log events to monitoring

use-parent-handlers

Type: Boolean
Default: FALSE

Parent handlers