Reading What's Happening
By default, logs are written to stdout, in text format.
Traefik logs concern everything that happens to Traefik itself (startup, configuration, events, shutdown, and so on).
By default, the logs are written to the standard output.
You can configure a file path instead using the
# Writing Logs to a File [log] filePath = "/path/to/traefik.log"
# Writing Logs to a File log: filePath: "/path/to/traefik.log"
# Writing Logs to a File --log.filePath=/path/to/traefik.log
By default, the logs use a text format (
common), but you can also ask for the
json format in the
# Writing Logs to a File, in JSON [log] filePath = "/path/to/log-file.log" format = "json"
# Writing Logs to a File, in JSON log: filePath: "/path/to/log-file.log" format: json
# Writing Logs to a File, in JSON --log.filePath=/path/to/traefik.log --log.format=json
By default, the
level is set to
ERROR. Alternative logging levels are
[log] level = "DEBUG"
log: level: DEBUG
Traefik will close and reopen its log files, assuming they're configured, on receipt of a USR1 signal.
This allows the logs to be rotated and processed by an external program, such as
This does not work on Windows due to the lack of USR signals.