tlog-rec.conf - tlog-rec configuration file
tlog-rec.conf is a JSON-format configuration file for
tlog-rec
program. Contrary to the strict JSON specification, both C and C++ style
comments are allowed in the file.
The file must contain a single JSON object with the objects and fields described
below. Almost all of them are optional and assume a default value. However,
those that do require a value can still be omitted and specified to
tlog-rec in other ways: through environment variables or command line.
- latency (integer)
- The number of seconds to cache captured data for before
logging. The encoded data which does not reach payload size stays in
memory and is not logged until this number of seconds elapses.
Minimum: 1
Default: 10
- payload (integer)
- The maximum encoded data (payload) size per message, bytes.
As soon as payload exceeds this number of bytes, it is formatted into a
message and logged.
Minimum: 32
Default: 2048
- log (object)
- Logged data set object, see below.
- limit (object)
- Logging limit object, see below.
- file (object)
- File writer object, see below.
- syslog (object)
- Syslog writer object, see below.
- journal (object)
- Journal writer object, see below.
- writer (string)
- The type of "log writer" to use for logging. The
writer needs to be configured using its dedicated parameters.
One of: "journal", "syslog", "file"
Default: "file"
- input (boolean)
- If true, user input is logged.
Default: false
- output (boolean)
- If true, terminal output is logged.
Default: true
- window (boolean)
- If true, terminal window size changes are logged.
Default: true
- rate (integer)
- The maximum rate messages could be logged at, bytes/sec.
Minimum: 0
Default: 16384
- burst (integer)
- The number of bytes by which logged messages are allowed to
exceed the rate limit momentarily, i.e. "burstiness".
Minimum: 0
Default: 32768
- action (string)
- The logging limit action. If set to "pass" no
logging limits will be applied. If set to "delay", logging will
be throttled. If set to "drop", messages exceeding limits will
be dropped.
One of: "pass", "delay", "drop"
Default: "pass"
- path (string)
- The "file" writer log file path.
No default.
- facility (string)
- The syslog facility "syslog" writer should use
for messages.
One of: "auth", "authpriv", "cron",
"daemon", "ftp", "kern", "local0",
"local1", "local2", "local3",
"local4", "local5", "local6",
"local7", "lpr", "mail", "news",
"syslog", "user", "uucp"
Default: "authpriv"
- priority (string)
- The syslog priority "syslog" writer should use
for messages.
One of: "emerg", "alert", "crit",
"err", "warning", "notice",
"info", "debug"
Default: "info"
- priority (string)
- The syslog-style priority "journal" writer should
use for messages.
One of: "emerg", "alert", "crit",
"err", "warning", "notice",
"info", "debug"
Default: "info"
- augment (boolean)
- If true, the "journal" writer copies the
following JSON fields to Journal fields: user -> TLOG_USER, session
-> TLOG_SESSION, rec -> TLOG_REC, and id -> TLOG_ID.
Default: true
- A configuration specifying only a reduced latency:
-
{
"latency": 3
}
- A configuration enabling logging user input:
-
{
"log": {
"input": true
}
}
- A configuration specifying logging to a file:
-
{
"writer": "file"
"file" : {
"path": "/var/log/tlog-rec.log"
}
}
tlog-rec(8),
http://json.org/
Nikolai Kondrashov <
[email protected]>