file
This is used to configure the file logger which stores log messages in a file you specify. The filename should be the preferred log file.
Example configuration of a file logging clause:
file {
filename "<cwd>/radiator-server.log";
loglevel info;
}
Parameters
| Parameter | Required | Description |
|---|---|---|
filename "path"; | Yes | Active log file path. |
loglevel <level>; | No | Minimum level to write. Default is info. |
json_log; | No | Write each application log row as JSON. |
rotate { ... } | No | Rotate the file by schedule, by size, or both. |
Rotation
Use rotate inside a file logger to let Radiator rename the active file and continue writing to a new file at filename.
file {
filename "<cwd>/radiator-server.log";
loglevel info;
json_log;
rotate {
interval {
cron "0 0 0 * * * *";
time-zone "local";
}
size 100MiB;
keep 14;
compress 5;
}
}
rotate supports these parameters:
| Parameter | Description |
|---|---|
interval { ... } | Rotation schedule. Use the shared interval syntax. If no interval is configured, Radiator rotates daily at midnight. |
size <byte-size>; | Rotate before writing a row that would make the active file larger than this limit. The value must be greater than zero. See byte size units. A new or empty file always accepts at least one row. |
keep <count>; | Keep at most this many default rotated files for this active log. |
compress <count>; | Compress default rotated files with gzip when they reach this generation. For example, compress 5; leaves the four newest default rotated files uncompressed. The count must be greater than zero and cannot be greater than keep when keep is configured. |
rotated-filename "path"; | Optional rotated filename pattern. The pattern supports timestamp format fields. |
When rotated-filename is omitted, Radiator writes default rotated files as <filename>.<timestamp>.old. The timestamp uses the configured cron time-zone when one is set. Otherwise, it uses the server local time zone.
The keep and compress parameters manage default rotated files. Compressed files use the .gz suffix and count toward keep.
Move log files that you need for future analysis out of the logging directory before retention can remove them.
Do not configure keep or compress with rotated-filename. Radiator rejects that configuration. Use custom rotated filenames when an external log management system handles retention and compression.