From 0ea8cbdfbf9af1c5dda5a457e86eab8362523c72 Mon Sep 17 00:00:00 2001 From: Xuetao Li Date: Tue, 14 Oct 2025 16:18:05 +0800 Subject: [PATCH] Clarify log.filePath behavior in documentation --- docs/content/observability/logs.md | 1 + .../install-configuration/observability/logs-and-accesslogs.md | 2 +- 2 files changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/content/observability/logs.md b/docs/content/observability/logs.md index 30fc57c29..8f82e9936 100644 --- a/docs/content/observability/logs.md +++ b/docs/content/observability/logs.md @@ -20,6 +20,7 @@ Traefik logs concern everything that happens to Traefik itself (startup, configu By default, the logs are written to the standard output. You can configure a file path instead using the `filePath` option. +When `filePath` is specified, Traefik will write logs only to that file (not to standard output). ```yaml tab="File (YAML)" # Writing Logs to a File diff --git a/docs/content/reference/install-configuration/observability/logs-and-accesslogs.md b/docs/content/reference/install-configuration/observability/logs-and-accesslogs.md index e814139f1..70165cca2 100644 --- a/docs/content/reference/install-configuration/observability/logs-and-accesslogs.md +++ b/docs/content/reference/install-configuration/observability/logs-and-accesslogs.md @@ -35,7 +35,7 @@ The section below describe how to configure Traefik logs using the static config | Field | Description | Default | Required | |:-----------|:----------------------------|:--------|:---------| -| `log.filePath` | By default, the logs are written to the standard output.
You can configure a file path instead using the `filePath` option.| - | No | +| `log.filePath` | By default, the logs are written to the standard output.
You can configure a file path instead using the `filePath` option. When `filePath` is specified, Traefik will write logs only to that file (not to standard output).| - | No | | `log.format` | Log format (`common`or `json`).
The fields displayed with the format `common` cannot be customized. | "common" | No | | `log.level` | Log level (`TRACE`, `DEBUG`, `INFO`, `WARN`, `ERROR`, `FATAL`, and `PANIC`)| ERROR | No | | `log.noColor` | When using the format `common`, disables the colorized output. | false | No |