DataSource for C SDK  7.1.1.311017
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

Specify the level at which logs are reported. This can take the following values (in order of decreasing severity/increasing verbosity):

log-level name Description
CRIT Reports critical errors that prevent the application from running.
ERROR Reports serious errors regarding network connections and all errors included in the CRIT log level.
NOTIFY Reports errors regarding data corruptions and all errors included in the ERROR and CRIT log levels.
WARN Reports minor errors and all errors included in the NOTIFY, ERROR and CRIT log levels.
INFO Reports events and information regarding normal operation, and all errors included in the WARN, NOTIFY, ERROR and CRIT log levels.
DEBUG Reports tracing information and all logs at a higher level.
FINER Reports more deatiled tracing information and all logs at a higher level.
FINEST Reports more deatiled tracing information and all logs at a higher level.

log-monitor-level

Type: String
Default: CRIT

Default logging level to send log events to monitoring


log-syslog-level

Type: String
Default: ERROR

log-syslog-level specifies the level of the logs that are reported to the system log when this DataSource application is running.

You can override this setting by specifying the syslog-level option of the add-log configuration item.

system log

On Linux system logs are written to the Linux system log. On Windows the logs are written to the Windows event log.

Note
The log-level item, and level option of add-log (if specified) take precedence over log-syslog-level. For example, if log-syslog-level is set to DEBUG but log-level is set to INFO, only log messages with severity INFO or higher go the system log.

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

Logging level to send log events to syslog


use-parent-handlers

Type: Boolean
Default: FALSE

Parent handlers




Generated on Sun Mar 11 2018 12:22:05 for DataSource for C SDK