diff --git a/content/de/administration/console/index.md b/content/de/administration/console/index.md index 489ef506..e8af749f 100644 --- a/content/de/administration/console/index.md +++ b/content/de/administration/console/index.md @@ -10,8 +10,11 @@ The **RustFS Console** is the web administration interface for RustFS. Use this The Console is enabled by default and listens on port `9001`, separately from the S3 API on port `9000`. You can set the behavior explicitly with the following environment variables: ```ini title="/etc/default/rustfs" -RUSTFS_CONSOLE_ENABLE=true +RUSTFS_ADDRESS=":9000" RUSTFS_CONSOLE_ADDRESS=":9001" +RUSTFS_CONSOLE_ENABLE=true +RUSTFS_OBS_LOGGER_LEVEL=error +RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" ``` Restart RustFS after changing these values. Set `RUSTFS_CONSOLE_ENABLE=false` when the Console must not run. diff --git a/content/de/developer/integration/big-data/iceberg.md b/content/de/developer/integration/big-data/iceberg.md index 568a3699..9511170c 100644 --- a/content/de/developer/integration/big-data/iceberg.md +++ b/content/de/developer/integration/big-data/iceberg.md @@ -70,9 +70,11 @@ services: RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY} RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY} RUSTFS_VOLUMES: /data - RUSTFS_ADDRESS: 0.0.0.0:9000 - RUSTFS_CONSOLE_ADDRESS: 0.0.0.0:9001 + RUSTFS_ADDRESS: ":9000" + RUSTFS_CONSOLE_ADDRESS: ":9001" RUSTFS_CONSOLE_ENABLE: "true" + RUSTFS_OBS_LOGGER_LEVEL: error + RUSTFS_OBS_LOG_DIRECTORY: /var/log/rustfs/ volumes: - rustfs-data:/data ports: diff --git a/content/de/developer/integration/big-data/milvus.md b/content/de/developer/integration/big-data/milvus.md index 869be2d3..2b17701b 100644 --- a/content/de/developer/integration/big-data/milvus.md +++ b/content/de/developer/integration/big-data/milvus.md @@ -96,9 +96,11 @@ services: RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY} RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY} RUSTFS_VOLUMES: /data - RUSTFS_ADDRESS: 0.0.0.0:9000 - RUSTFS_CONSOLE_ADDRESS: 0.0.0.0:9001 + RUSTFS_ADDRESS: ":9000" + RUSTFS_CONSOLE_ADDRESS: ":9001" RUSTFS_CONSOLE_ENABLE: "true" + RUSTFS_OBS_LOGGER_LEVEL: error + RUSTFS_OBS_LOG_DIRECTORY: /var/log/rustfs/ volumes: - rustfs-data:/data ports: diff --git a/content/de/developer/integration/reverse-proxy/caddy.md b/content/de/developer/integration/reverse-proxy/caddy.md index 57c1a55b..cd1c2384 100644 --- a/content/de/developer/integration/reverse-proxy/caddy.md +++ b/content/de/developer/integration/reverse-proxy/caddy.md @@ -109,8 +109,10 @@ services: RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY} RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY} RUSTFS_CONSOLE_ENABLE: "true" - RUSTFS_ADDRESS: "0.0.0.0:9000" - RUSTFS_CONSOLE_ADDRESS: "0.0.0.0:9001" + RUSTFS_ADDRESS: ":9000" + RUSTFS_CONSOLE_ADDRESS: ":9001" + RUSTFS_OBS_LOGGER_LEVEL: error + RUSTFS_OBS_LOG_DIRECTORY: /var/log/rustfs/ expose: - "9000" - "9001" diff --git a/content/de/developer/integration/reverse-proxy/haproxy.md b/content/de/developer/integration/reverse-proxy/haproxy.md index faac09ef..265b88c6 100644 --- a/content/de/developer/integration/reverse-proxy/haproxy.md +++ b/content/de/developer/integration/reverse-proxy/haproxy.md @@ -128,8 +128,10 @@ services: RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY} RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY} RUSTFS_CONSOLE_ENABLE: "true" - RUSTFS_ADDRESS: "0.0.0.0:9000" - RUSTFS_CONSOLE_ADDRESS: "0.0.0.0:9001" + RUSTFS_ADDRESS: ":9000" + RUSTFS_CONSOLE_ADDRESS: ":9001" + RUSTFS_OBS_LOGGER_LEVEL: error + RUSTFS_OBS_LOG_DIRECTORY: /var/log/rustfs/ expose: - "9000" - "9001" diff --git a/content/de/developer/integration/reverse-proxy/nginx.md b/content/de/developer/integration/reverse-proxy/nginx.md index 12eb5230..b7d025c3 100644 --- a/content/de/developer/integration/reverse-proxy/nginx.md +++ b/content/de/developer/integration/reverse-proxy/nginx.md @@ -167,8 +167,10 @@ services: RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY} RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY} RUSTFS_CONSOLE_ENABLE: "true" - RUSTFS_ADDRESS: "0.0.0.0:9000" - RUSTFS_CONSOLE_ADDRESS: "0.0.0.0:9001" + RUSTFS_ADDRESS: ":9000" + RUSTFS_CONSOLE_ADDRESS: ":9001" + RUSTFS_OBS_LOGGER_LEVEL: error + RUSTFS_OBS_LOG_DIRECTORY: /var/log/rustfs/ expose: - "9000" - "9001" diff --git a/content/de/developer/integration/reverse-proxy/traefik.md b/content/de/developer/integration/reverse-proxy/traefik.md index 7e319593..a40c7f42 100644 --- a/content/de/developer/integration/reverse-proxy/traefik.md +++ b/content/de/developer/integration/reverse-proxy/traefik.md @@ -83,8 +83,10 @@ services: RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY} RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY} RUSTFS_CONSOLE_ENABLE: "true" - RUSTFS_ADDRESS: "0.0.0.0:9000" - RUSTFS_CONSOLE_ADDRESS: "0.0.0.0:9001" + RUSTFS_ADDRESS: ":9000" + RUSTFS_CONSOLE_ADDRESS: ":9001" + RUSTFS_OBS_LOGGER_LEVEL: error + RUSTFS_OBS_LOG_DIRECTORY: /var/log/rustfs/ expose: - "9000" - "9001" diff --git a/content/de/installation/container/docker.md b/content/de/installation/container/docker.md index 26124785..8469df29 100644 --- a/content/de/installation/container/docker.md +++ b/content/de/installation/container/docker.md @@ -32,7 +32,11 @@ docker run -d \ -v rustfs-data:/data \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ + -e RUSTFS_ADDRESS=":9000" \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ rustfs/rustfs:latest \ /data ``` diff --git a/content/de/installation/container/index.mdx b/content/de/installation/container/index.mdx index b7528a27..27ed2b35 100644 --- a/content/de/installation/container/index.mdx +++ b/content/de/installation/container/index.mdx @@ -76,8 +76,11 @@ docker run -d \ -v /mnt/rustfs/data:/data \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ - -e RUSTFS_ADDRESS=:9000 \ + -e RUSTFS_ADDRESS=":9000" \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ rustfs/rustfs:latest \ /data ``` @@ -121,7 +124,11 @@ docker run -d \ -p 9000:9000 \ -p 9001:9001 \ -v /mnt/data:/data \ - -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_ADDRESS=":9000" \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ + -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ rustfs/rustfs:latest \ --console-enable \ /data @@ -173,7 +180,7 @@ Running the command under root directory, docker compose --profile observability up -d ``` -Providing the necessary permissions. An initialization container is necessary to grant the correct access rights to rustfs using the `depends_on` keyword. In the example below the `rustfs_perms` service is added to the `docker-compose.yml` to handle this. To ensure logs are persisted and accessible, we map the host log directory to the container's `/logs` path +Providing the necessary permissions. An initialization container is necessary to grant the correct access rights to rustfs using the `depends_on` keyword. In the example below the `rustfs_perms` service is added to the `docker-compose.yml` to handle this. To ensure logs are persisted and accessible, we map the host log directory to the container's `/var/log/rustfs/` path ```yaml title="docker-compose.yml" services: @@ -192,9 +199,13 @@ Providing the necessary permissions. An initialization container is necessary to condition: service_completed_successfully volumes: - /path/to_host_directory/volumes/data:/data - - /path/to_host_directory/volumes/logs:/logs + - /path/to_host_directory/volumes/logs:/var/log/rustfs/ environment: - - RUSTFS_OBS_LOG_DIRECTORY=/logs + - RUSTFS_ADDRESS=":9000" + - RUSTFS_CONSOLE_ADDRESS=":9001" + - RUSTFS_CONSOLE_ENABLE=true + - RUSTFS_OBS_LOGGER_LEVEL=error + - RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" # ... other configurations ``` @@ -269,7 +280,11 @@ docker run -d \ -v /mnt/rustfs/data:/data \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ + -e RUSTFS_ADDRESS=":9000" \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ -e RUSTFS_VOLUMES="http://node{1...4}:9000/data/rustfs{0...3}" \ rustfs/rustfs:latest ``` diff --git a/content/de/installation/container/podman.md b/content/de/installation/container/podman.md index fdcb320a..5c478328 100644 --- a/content/de/installation/container/podman.md +++ b/content/de/installation/container/podman.md @@ -31,7 +31,11 @@ podman run -d \ -v rustfs-data:/data \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ + -e RUSTFS_ADDRESS=":9000" \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ docker.io/rustfs/rustfs:latest \ /data ``` diff --git a/content/de/installation/linux/multiple-node-multiple-disk.md b/content/de/installation/linux/multiple-node-multiple-disk.md index eaf7bfb3..797c9cd9 100644 --- a/content/de/installation/linux/multiple-node-multiple-disk.md +++ b/content/de/installation/linux/multiple-node-multiple-disk.md @@ -68,8 +68,9 @@ RUSTFS_SECRET_KEY= RUSTFS_VOLUMES="http://node{1...4}:9000/data/rustfs{0...3}" RUSTFS_ADDRESS=":9000" RUSTFS_CONSOLE_ENABLE=true -RUST_LOG=error -RUSTFS_OBS_LOG_DIRECTORY="/var/logs/rustfs/" +RUSTFS_CONSOLE_ADDRESS=":9001" +RUSTFS_OBS_LOGGER_LEVEL=error +RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" ``` :::note @@ -81,8 +82,8 @@ The access key, secret key, and `RUSTFS_VOLUMES` value must be identical on all 2. Create the storage and log directories on every node: ```bash -sudo mkdir -p /data/rustfs{0..3} /var/logs/rustfs /opt/tls -sudo chmod -R 750 /data/rustfs* /var/logs/rustfs +sudo mkdir -p /data/rustfs{0..3} /var/log/rustfs /opt/tls +sudo chmod -R 750 /data/rustfs* /var/log/rustfs ``` ## Start Service and Verification @@ -108,7 +109,7 @@ netstat -ntpl 4. View log files: ```bash -tail -f /var/logs/rustfs/rustfs*.log +tail -f /var/log/rustfs/rustfs*.log ``` 5. Access the console: enter any node's IP address (or the load balancer address) and the console port (default 9001) in a browser. You should see: diff --git a/content/de/installation/linux/prerequisites-and-service.md b/content/de/installation/linux/prerequisites-and-service.md index 0714609f..8917c54e 100644 --- a/content/de/installation/linux/prerequisites-and-service.md +++ b/content/de/installation/linux/prerequisites-and-service.md @@ -206,8 +206,8 @@ RestrictSUIDSGID=true RestrictRealtime=true # service log configuration -StandardOutput=append:/var/logs/rustfs/rustfs.log -StandardError=append:/var/logs/rustfs/rustfs-err.log +StandardOutput=append:/var/log/rustfs/rustfs.log +StandardError=append:/var/log/rustfs/rustfs-err.log [Install] WantedBy=multi-user.target diff --git a/content/de/installation/linux/single-node-multiple-disk.md b/content/de/installation/linux/single-node-multiple-disk.md index 95dd8f00..4f4c2690 100644 --- a/content/de/installation/linux/single-node-multiple-disk.md +++ b/content/de/installation/linux/single-node-multiple-disk.md @@ -43,15 +43,16 @@ RUSTFS_SECRET_KEY= RUSTFS_VOLUMES="/data/rustfs{0...3}" RUSTFS_ADDRESS=":9000" RUSTFS_CONSOLE_ENABLE=true -RUST_LOG=error -RUSTFS_OBS_LOG_DIRECTORY="/var/logs/rustfs/" +RUSTFS_CONSOLE_ADDRESS=":9001" +RUSTFS_OBS_LOGGER_LEVEL=error +RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" ``` 2. Create the storage and log directories: ```bash -sudo mkdir -p /data/rustfs{0..3} /var/logs/rustfs /opt/tls -sudo chmod -R 750 /data/rustfs* /var/logs/rustfs +sudo mkdir -p /data/rustfs{0..3} /var/log/rustfs /opt/tls +sudo chmod -R 750 /data/rustfs* /var/log/rustfs ``` ## Start Service and Verification @@ -77,7 +78,7 @@ netstat -ntpl 4. View log files: ```bash -tail -f /var/logs/rustfs/rustfs*.log +tail -f /var/log/rustfs/rustfs*.log ``` 5. Access the console: enter the server's IP address and the console port (default 9001) in a browser. You should see: diff --git a/content/de/installation/linux/single-node-single-disk.md b/content/de/installation/linux/single-node-single-disk.md index cf912d2f..b6c96e62 100644 --- a/content/de/installation/linux/single-node-single-disk.md +++ b/content/de/installation/linux/single-node-single-disk.md @@ -42,15 +42,16 @@ RUSTFS_SECRET_KEY= RUSTFS_VOLUMES="/data/rustfs0" RUSTFS_ADDRESS=":9000" RUSTFS_CONSOLE_ENABLE=true -RUST_LOG=error -RUSTFS_OBS_LOG_DIRECTORY="/var/logs/rustfs/" +RUSTFS_CONSOLE_ADDRESS=":9001" +RUSTFS_OBS_LOGGER_LEVEL=error +RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" ``` 2. Create the storage and log directories: ```bash -sudo mkdir -p /data/rustfs0 /var/logs/rustfs /opt/tls -sudo chmod -R 750 /data/rustfs* /var/logs/rustfs +sudo mkdir -p /data/rustfs0 /var/log/rustfs /opt/tls +sudo chmod -R 750 /data/rustfs* /var/log/rustfs ``` ## Start Service and Verification @@ -76,7 +77,7 @@ netstat -ntpl 4. View log files: ```bash -tail -f /var/logs/rustfs/rustfs*.log +tail -f /var/log/rustfs/rustfs*.log ``` 5. Access the console: enter the server's IP address and the console port (default 9001) in a browser. You should see: diff --git a/content/de/operations/observability.md b/content/de/operations/observability.md index 2496cb2e..b0531ca3 100644 --- a/content/de/operations/observability.md +++ b/content/de/operations/observability.md @@ -209,13 +209,16 @@ Per-disk usage and disk online/offline state are currently surfaced through the Where logs go is controlled by `RUSTFS_OBS_LOG_DIRECTORY`: - **Unset** — logs go to stdout. In containers, use your log driver; on systemd hosts, stdout/stderr is captured by **journald**, so `journalctl -u rustfs -f` works without extra configuration. -- **A local directory** (e.g. `/logs`) — RustFS writes rotating log files there. Rotation is tuned with `RUSTFS_OBS_LOG_FILENAME`, `RUSTFS_OBS_LOG_ROTATION_SIZE_MB`, `RUSTFS_OBS_LOG_ROTATION_TIME`, and `RUSTFS_OBS_LOG_KEEP_FILES`. +- **A local directory** (e.g. `/var/log/rustfs/`) — RustFS writes rotating log files there. Rotation is tuned with `RUSTFS_OBS_LOG_FILENAME`, `RUSTFS_OBS_LOG_ROTATION_SIZE_MB`, `RUSTFS_OBS_LOG_ROTATION_TIME`, and `RUSTFS_OBS_LOG_KEEP_FILES`. - **A URL** (contains `://`) — logs are shipped to a remote endpoint. When `RUSTFS_OBS_ENDPOINT` is set and log export is enabled, logs are additionally exported via OTLP; the reference stack routes them into Loki for querying from Grafana. ```bash title="Example: file logs plus OTLP export" -RUSTFS_OBS_LOG_DIRECTORY=/var/log/rustfs -RUSTFS_OBS_LOGGER_LEVEL=info +RUSTFS_ADDRESS=":9000" +RUSTFS_CONSOLE_ADDRESS=":9001" +RUSTFS_CONSOLE_ENABLE=true +RUSTFS_OBS_LOGGER_LEVEL=error +RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" RUSTFS_OBS_ENDPOINT=http://otel-collector:4318 ``` diff --git a/content/de/operations/upgrade/container/index.md b/content/de/operations/upgrade/container/index.md index 071146bc..e9e388f1 100644 --- a/content/de/operations/upgrade/container/index.md +++ b/content/de/operations/upgrade/container/index.md @@ -50,7 +50,11 @@ docker run -d \ -v rustfs-data:/data \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ + -e RUSTFS_ADDRESS=":9000" \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ rustfs/rustfs: \ /data ``` @@ -84,7 +88,11 @@ podman run -d \ -v rustfs-data:/data \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ + -e RUSTFS_ADDRESS=":9000" \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ docker.io/rustfs/rustfs: \ /data ``` diff --git a/content/de/troubleshooting/driver.md b/content/de/troubleshooting/driver.md index 19176e8c..f0d48390 100644 --- a/content/de/troubleshooting/driver.md +++ b/content/de/troubleshooting/driver.md @@ -118,7 +118,7 @@ Once RustFS detects a freshly formatted disk at a known mount point, its backgro journalctl -u rustfs -f # Or view the log files under the directory set by RUSTFS_OBS_LOG_DIRECTORY -tail -f /var/logs/rustfs/rustfs.log +tail -f /var/log/rustfs/rustfs.log ``` You can also open the RustFS Console and check the disk status of the affected node. diff --git a/content/en/administration/console/index.md b/content/en/administration/console/index.md index 489ef506..e8af749f 100644 --- a/content/en/administration/console/index.md +++ b/content/en/administration/console/index.md @@ -10,8 +10,11 @@ The **RustFS Console** is the web administration interface for RustFS. Use this The Console is enabled by default and listens on port `9001`, separately from the S3 API on port `9000`. You can set the behavior explicitly with the following environment variables: ```ini title="/etc/default/rustfs" -RUSTFS_CONSOLE_ENABLE=true +RUSTFS_ADDRESS=":9000" RUSTFS_CONSOLE_ADDRESS=":9001" +RUSTFS_CONSOLE_ENABLE=true +RUSTFS_OBS_LOGGER_LEVEL=error +RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" ``` Restart RustFS after changing these values. Set `RUSTFS_CONSOLE_ENABLE=false` when the Console must not run. diff --git a/content/en/developer/integration/big-data/iceberg.md b/content/en/developer/integration/big-data/iceberg.md index 568a3699..9511170c 100644 --- a/content/en/developer/integration/big-data/iceberg.md +++ b/content/en/developer/integration/big-data/iceberg.md @@ -70,9 +70,11 @@ services: RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY} RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY} RUSTFS_VOLUMES: /data - RUSTFS_ADDRESS: 0.0.0.0:9000 - RUSTFS_CONSOLE_ADDRESS: 0.0.0.0:9001 + RUSTFS_ADDRESS: ":9000" + RUSTFS_CONSOLE_ADDRESS: ":9001" RUSTFS_CONSOLE_ENABLE: "true" + RUSTFS_OBS_LOGGER_LEVEL: error + RUSTFS_OBS_LOG_DIRECTORY: /var/log/rustfs/ volumes: - rustfs-data:/data ports: diff --git a/content/en/developer/integration/big-data/milvus.md b/content/en/developer/integration/big-data/milvus.md index 869be2d3..2b17701b 100644 --- a/content/en/developer/integration/big-data/milvus.md +++ b/content/en/developer/integration/big-data/milvus.md @@ -96,9 +96,11 @@ services: RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY} RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY} RUSTFS_VOLUMES: /data - RUSTFS_ADDRESS: 0.0.0.0:9000 - RUSTFS_CONSOLE_ADDRESS: 0.0.0.0:9001 + RUSTFS_ADDRESS: ":9000" + RUSTFS_CONSOLE_ADDRESS: ":9001" RUSTFS_CONSOLE_ENABLE: "true" + RUSTFS_OBS_LOGGER_LEVEL: error + RUSTFS_OBS_LOG_DIRECTORY: /var/log/rustfs/ volumes: - rustfs-data:/data ports: diff --git a/content/en/developer/integration/reverse-proxy/caddy.md b/content/en/developer/integration/reverse-proxy/caddy.md index 57c1a55b..cd1c2384 100644 --- a/content/en/developer/integration/reverse-proxy/caddy.md +++ b/content/en/developer/integration/reverse-proxy/caddy.md @@ -109,8 +109,10 @@ services: RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY} RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY} RUSTFS_CONSOLE_ENABLE: "true" - RUSTFS_ADDRESS: "0.0.0.0:9000" - RUSTFS_CONSOLE_ADDRESS: "0.0.0.0:9001" + RUSTFS_ADDRESS: ":9000" + RUSTFS_CONSOLE_ADDRESS: ":9001" + RUSTFS_OBS_LOGGER_LEVEL: error + RUSTFS_OBS_LOG_DIRECTORY: /var/log/rustfs/ expose: - "9000" - "9001" diff --git a/content/en/developer/integration/reverse-proxy/haproxy.md b/content/en/developer/integration/reverse-proxy/haproxy.md index faac09ef..265b88c6 100644 --- a/content/en/developer/integration/reverse-proxy/haproxy.md +++ b/content/en/developer/integration/reverse-proxy/haproxy.md @@ -128,8 +128,10 @@ services: RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY} RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY} RUSTFS_CONSOLE_ENABLE: "true" - RUSTFS_ADDRESS: "0.0.0.0:9000" - RUSTFS_CONSOLE_ADDRESS: "0.0.0.0:9001" + RUSTFS_ADDRESS: ":9000" + RUSTFS_CONSOLE_ADDRESS: ":9001" + RUSTFS_OBS_LOGGER_LEVEL: error + RUSTFS_OBS_LOG_DIRECTORY: /var/log/rustfs/ expose: - "9000" - "9001" diff --git a/content/en/developer/integration/reverse-proxy/nginx.md b/content/en/developer/integration/reverse-proxy/nginx.md index 12eb5230..b7d025c3 100644 --- a/content/en/developer/integration/reverse-proxy/nginx.md +++ b/content/en/developer/integration/reverse-proxy/nginx.md @@ -167,8 +167,10 @@ services: RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY} RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY} RUSTFS_CONSOLE_ENABLE: "true" - RUSTFS_ADDRESS: "0.0.0.0:9000" - RUSTFS_CONSOLE_ADDRESS: "0.0.0.0:9001" + RUSTFS_ADDRESS: ":9000" + RUSTFS_CONSOLE_ADDRESS: ":9001" + RUSTFS_OBS_LOGGER_LEVEL: error + RUSTFS_OBS_LOG_DIRECTORY: /var/log/rustfs/ expose: - "9000" - "9001" diff --git a/content/en/developer/integration/reverse-proxy/traefik.md b/content/en/developer/integration/reverse-proxy/traefik.md index 7e319593..a40c7f42 100644 --- a/content/en/developer/integration/reverse-proxy/traefik.md +++ b/content/en/developer/integration/reverse-proxy/traefik.md @@ -83,8 +83,10 @@ services: RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY} RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY} RUSTFS_CONSOLE_ENABLE: "true" - RUSTFS_ADDRESS: "0.0.0.0:9000" - RUSTFS_CONSOLE_ADDRESS: "0.0.0.0:9001" + RUSTFS_ADDRESS: ":9000" + RUSTFS_CONSOLE_ADDRESS: ":9001" + RUSTFS_OBS_LOGGER_LEVEL: error + RUSTFS_OBS_LOG_DIRECTORY: /var/log/rustfs/ expose: - "9000" - "9001" diff --git a/content/en/installation/container/docker.md b/content/en/installation/container/docker.md index 26124785..8469df29 100644 --- a/content/en/installation/container/docker.md +++ b/content/en/installation/container/docker.md @@ -32,7 +32,11 @@ docker run -d \ -v rustfs-data:/data \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ + -e RUSTFS_ADDRESS=":9000" \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ rustfs/rustfs:latest \ /data ``` diff --git a/content/en/installation/container/index.mdx b/content/en/installation/container/index.mdx index b7528a27..27ed2b35 100644 --- a/content/en/installation/container/index.mdx +++ b/content/en/installation/container/index.mdx @@ -76,8 +76,11 @@ docker run -d \ -v /mnt/rustfs/data:/data \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ - -e RUSTFS_ADDRESS=:9000 \ + -e RUSTFS_ADDRESS=":9000" \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ rustfs/rustfs:latest \ /data ``` @@ -121,7 +124,11 @@ docker run -d \ -p 9000:9000 \ -p 9001:9001 \ -v /mnt/data:/data \ - -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_ADDRESS=":9000" \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ + -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ rustfs/rustfs:latest \ --console-enable \ /data @@ -173,7 +180,7 @@ Running the command under root directory, docker compose --profile observability up -d ``` -Providing the necessary permissions. An initialization container is necessary to grant the correct access rights to rustfs using the `depends_on` keyword. In the example below the `rustfs_perms` service is added to the `docker-compose.yml` to handle this. To ensure logs are persisted and accessible, we map the host log directory to the container's `/logs` path +Providing the necessary permissions. An initialization container is necessary to grant the correct access rights to rustfs using the `depends_on` keyword. In the example below the `rustfs_perms` service is added to the `docker-compose.yml` to handle this. To ensure logs are persisted and accessible, we map the host log directory to the container's `/var/log/rustfs/` path ```yaml title="docker-compose.yml" services: @@ -192,9 +199,13 @@ Providing the necessary permissions. An initialization container is necessary to condition: service_completed_successfully volumes: - /path/to_host_directory/volumes/data:/data - - /path/to_host_directory/volumes/logs:/logs + - /path/to_host_directory/volumes/logs:/var/log/rustfs/ environment: - - RUSTFS_OBS_LOG_DIRECTORY=/logs + - RUSTFS_ADDRESS=":9000" + - RUSTFS_CONSOLE_ADDRESS=":9001" + - RUSTFS_CONSOLE_ENABLE=true + - RUSTFS_OBS_LOGGER_LEVEL=error + - RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" # ... other configurations ``` @@ -269,7 +280,11 @@ docker run -d \ -v /mnt/rustfs/data:/data \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ + -e RUSTFS_ADDRESS=":9000" \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ -e RUSTFS_VOLUMES="http://node{1...4}:9000/data/rustfs{0...3}" \ rustfs/rustfs:latest ``` diff --git a/content/en/installation/container/podman.md b/content/en/installation/container/podman.md index fdcb320a..5c478328 100644 --- a/content/en/installation/container/podman.md +++ b/content/en/installation/container/podman.md @@ -31,7 +31,11 @@ podman run -d \ -v rustfs-data:/data \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ + -e RUSTFS_ADDRESS=":9000" \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ docker.io/rustfs/rustfs:latest \ /data ``` diff --git a/content/en/installation/linux/multiple-node-multiple-disk.md b/content/en/installation/linux/multiple-node-multiple-disk.md index eaf7bfb3..797c9cd9 100644 --- a/content/en/installation/linux/multiple-node-multiple-disk.md +++ b/content/en/installation/linux/multiple-node-multiple-disk.md @@ -68,8 +68,9 @@ RUSTFS_SECRET_KEY= RUSTFS_VOLUMES="http://node{1...4}:9000/data/rustfs{0...3}" RUSTFS_ADDRESS=":9000" RUSTFS_CONSOLE_ENABLE=true -RUST_LOG=error -RUSTFS_OBS_LOG_DIRECTORY="/var/logs/rustfs/" +RUSTFS_CONSOLE_ADDRESS=":9001" +RUSTFS_OBS_LOGGER_LEVEL=error +RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" ``` :::note @@ -81,8 +82,8 @@ The access key, secret key, and `RUSTFS_VOLUMES` value must be identical on all 2. Create the storage and log directories on every node: ```bash -sudo mkdir -p /data/rustfs{0..3} /var/logs/rustfs /opt/tls -sudo chmod -R 750 /data/rustfs* /var/logs/rustfs +sudo mkdir -p /data/rustfs{0..3} /var/log/rustfs /opt/tls +sudo chmod -R 750 /data/rustfs* /var/log/rustfs ``` ## Start Service and Verification @@ -108,7 +109,7 @@ netstat -ntpl 4. View log files: ```bash -tail -f /var/logs/rustfs/rustfs*.log +tail -f /var/log/rustfs/rustfs*.log ``` 5. Access the console: enter any node's IP address (or the load balancer address) and the console port (default 9001) in a browser. You should see: diff --git a/content/en/installation/linux/prerequisites-and-service.md b/content/en/installation/linux/prerequisites-and-service.md index 0714609f..8917c54e 100644 --- a/content/en/installation/linux/prerequisites-and-service.md +++ b/content/en/installation/linux/prerequisites-and-service.md @@ -206,8 +206,8 @@ RestrictSUIDSGID=true RestrictRealtime=true # service log configuration -StandardOutput=append:/var/logs/rustfs/rustfs.log -StandardError=append:/var/logs/rustfs/rustfs-err.log +StandardOutput=append:/var/log/rustfs/rustfs.log +StandardError=append:/var/log/rustfs/rustfs-err.log [Install] WantedBy=multi-user.target diff --git a/content/en/installation/linux/single-node-multiple-disk.md b/content/en/installation/linux/single-node-multiple-disk.md index 95dd8f00..4f4c2690 100644 --- a/content/en/installation/linux/single-node-multiple-disk.md +++ b/content/en/installation/linux/single-node-multiple-disk.md @@ -43,15 +43,16 @@ RUSTFS_SECRET_KEY= RUSTFS_VOLUMES="/data/rustfs{0...3}" RUSTFS_ADDRESS=":9000" RUSTFS_CONSOLE_ENABLE=true -RUST_LOG=error -RUSTFS_OBS_LOG_DIRECTORY="/var/logs/rustfs/" +RUSTFS_CONSOLE_ADDRESS=":9001" +RUSTFS_OBS_LOGGER_LEVEL=error +RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" ``` 2. Create the storage and log directories: ```bash -sudo mkdir -p /data/rustfs{0..3} /var/logs/rustfs /opt/tls -sudo chmod -R 750 /data/rustfs* /var/logs/rustfs +sudo mkdir -p /data/rustfs{0..3} /var/log/rustfs /opt/tls +sudo chmod -R 750 /data/rustfs* /var/log/rustfs ``` ## Start Service and Verification @@ -77,7 +78,7 @@ netstat -ntpl 4. View log files: ```bash -tail -f /var/logs/rustfs/rustfs*.log +tail -f /var/log/rustfs/rustfs*.log ``` 5. Access the console: enter the server's IP address and the console port (default 9001) in a browser. You should see: diff --git a/content/en/installation/linux/single-node-single-disk.md b/content/en/installation/linux/single-node-single-disk.md index cf912d2f..b6c96e62 100644 --- a/content/en/installation/linux/single-node-single-disk.md +++ b/content/en/installation/linux/single-node-single-disk.md @@ -42,15 +42,16 @@ RUSTFS_SECRET_KEY= RUSTFS_VOLUMES="/data/rustfs0" RUSTFS_ADDRESS=":9000" RUSTFS_CONSOLE_ENABLE=true -RUST_LOG=error -RUSTFS_OBS_LOG_DIRECTORY="/var/logs/rustfs/" +RUSTFS_CONSOLE_ADDRESS=":9001" +RUSTFS_OBS_LOGGER_LEVEL=error +RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" ``` 2. Create the storage and log directories: ```bash -sudo mkdir -p /data/rustfs0 /var/logs/rustfs /opt/tls -sudo chmod -R 750 /data/rustfs* /var/logs/rustfs +sudo mkdir -p /data/rustfs0 /var/log/rustfs /opt/tls +sudo chmod -R 750 /data/rustfs* /var/log/rustfs ``` ## Start Service and Verification @@ -76,7 +77,7 @@ netstat -ntpl 4. View log files: ```bash -tail -f /var/logs/rustfs/rustfs*.log +tail -f /var/log/rustfs/rustfs*.log ``` 5. Access the console: enter the server's IP address and the console port (default 9001) in a browser. You should see: diff --git a/content/en/operations/observability.md b/content/en/operations/observability.md index 2496cb2e..b0531ca3 100644 --- a/content/en/operations/observability.md +++ b/content/en/operations/observability.md @@ -209,13 +209,16 @@ Per-disk usage and disk online/offline state are currently surfaced through the Where logs go is controlled by `RUSTFS_OBS_LOG_DIRECTORY`: - **Unset** — logs go to stdout. In containers, use your log driver; on systemd hosts, stdout/stderr is captured by **journald**, so `journalctl -u rustfs -f` works without extra configuration. -- **A local directory** (e.g. `/logs`) — RustFS writes rotating log files there. Rotation is tuned with `RUSTFS_OBS_LOG_FILENAME`, `RUSTFS_OBS_LOG_ROTATION_SIZE_MB`, `RUSTFS_OBS_LOG_ROTATION_TIME`, and `RUSTFS_OBS_LOG_KEEP_FILES`. +- **A local directory** (e.g. `/var/log/rustfs/`) — RustFS writes rotating log files there. Rotation is tuned with `RUSTFS_OBS_LOG_FILENAME`, `RUSTFS_OBS_LOG_ROTATION_SIZE_MB`, `RUSTFS_OBS_LOG_ROTATION_TIME`, and `RUSTFS_OBS_LOG_KEEP_FILES`. - **A URL** (contains `://`) — logs are shipped to a remote endpoint. When `RUSTFS_OBS_ENDPOINT` is set and log export is enabled, logs are additionally exported via OTLP; the reference stack routes them into Loki for querying from Grafana. ```bash title="Example: file logs plus OTLP export" -RUSTFS_OBS_LOG_DIRECTORY=/var/log/rustfs -RUSTFS_OBS_LOGGER_LEVEL=info +RUSTFS_ADDRESS=":9000" +RUSTFS_CONSOLE_ADDRESS=":9001" +RUSTFS_CONSOLE_ENABLE=true +RUSTFS_OBS_LOGGER_LEVEL=error +RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" RUSTFS_OBS_ENDPOINT=http://otel-collector:4318 ``` diff --git a/content/en/operations/upgrade/container/index.md b/content/en/operations/upgrade/container/index.md index 071146bc..e9e388f1 100644 --- a/content/en/operations/upgrade/container/index.md +++ b/content/en/operations/upgrade/container/index.md @@ -50,7 +50,11 @@ docker run -d \ -v rustfs-data:/data \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ + -e RUSTFS_ADDRESS=":9000" \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ rustfs/rustfs: \ /data ``` @@ -84,7 +88,11 @@ podman run -d \ -v rustfs-data:/data \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ + -e RUSTFS_ADDRESS=":9000" \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ docker.io/rustfs/rustfs: \ /data ``` diff --git a/content/en/troubleshooting/driver.md b/content/en/troubleshooting/driver.md index 19176e8c..f0d48390 100644 --- a/content/en/troubleshooting/driver.md +++ b/content/en/troubleshooting/driver.md @@ -118,7 +118,7 @@ Once RustFS detects a freshly formatted disk at a known mount point, its backgro journalctl -u rustfs -f # Or view the log files under the directory set by RUSTFS_OBS_LOG_DIRECTORY -tail -f /var/logs/rustfs/rustfs.log +tail -f /var/log/rustfs/rustfs.log ``` You can also open the RustFS Console and check the disk status of the affected node. diff --git a/content/fr/administration/console/index.md b/content/fr/administration/console/index.md index 489ef506..e8af749f 100644 --- a/content/fr/administration/console/index.md +++ b/content/fr/administration/console/index.md @@ -10,8 +10,11 @@ The **RustFS Console** is the web administration interface for RustFS. Use this The Console is enabled by default and listens on port `9001`, separately from the S3 API on port `9000`. You can set the behavior explicitly with the following environment variables: ```ini title="/etc/default/rustfs" -RUSTFS_CONSOLE_ENABLE=true +RUSTFS_ADDRESS=":9000" RUSTFS_CONSOLE_ADDRESS=":9001" +RUSTFS_CONSOLE_ENABLE=true +RUSTFS_OBS_LOGGER_LEVEL=error +RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" ``` Restart RustFS after changing these values. Set `RUSTFS_CONSOLE_ENABLE=false` when the Console must not run. diff --git a/content/fr/developer/integration/big-data/iceberg.md b/content/fr/developer/integration/big-data/iceberg.md index 568a3699..9511170c 100644 --- a/content/fr/developer/integration/big-data/iceberg.md +++ b/content/fr/developer/integration/big-data/iceberg.md @@ -70,9 +70,11 @@ services: RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY} RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY} RUSTFS_VOLUMES: /data - RUSTFS_ADDRESS: 0.0.0.0:9000 - RUSTFS_CONSOLE_ADDRESS: 0.0.0.0:9001 + RUSTFS_ADDRESS: ":9000" + RUSTFS_CONSOLE_ADDRESS: ":9001" RUSTFS_CONSOLE_ENABLE: "true" + RUSTFS_OBS_LOGGER_LEVEL: error + RUSTFS_OBS_LOG_DIRECTORY: /var/log/rustfs/ volumes: - rustfs-data:/data ports: diff --git a/content/fr/developer/integration/big-data/milvus.md b/content/fr/developer/integration/big-data/milvus.md index 869be2d3..2b17701b 100644 --- a/content/fr/developer/integration/big-data/milvus.md +++ b/content/fr/developer/integration/big-data/milvus.md @@ -96,9 +96,11 @@ services: RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY} RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY} RUSTFS_VOLUMES: /data - RUSTFS_ADDRESS: 0.0.0.0:9000 - RUSTFS_CONSOLE_ADDRESS: 0.0.0.0:9001 + RUSTFS_ADDRESS: ":9000" + RUSTFS_CONSOLE_ADDRESS: ":9001" RUSTFS_CONSOLE_ENABLE: "true" + RUSTFS_OBS_LOGGER_LEVEL: error + RUSTFS_OBS_LOG_DIRECTORY: /var/log/rustfs/ volumes: - rustfs-data:/data ports: diff --git a/content/fr/developer/integration/reverse-proxy/caddy.md b/content/fr/developer/integration/reverse-proxy/caddy.md index 57c1a55b..cd1c2384 100644 --- a/content/fr/developer/integration/reverse-proxy/caddy.md +++ b/content/fr/developer/integration/reverse-proxy/caddy.md @@ -109,8 +109,10 @@ services: RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY} RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY} RUSTFS_CONSOLE_ENABLE: "true" - RUSTFS_ADDRESS: "0.0.0.0:9000" - RUSTFS_CONSOLE_ADDRESS: "0.0.0.0:9001" + RUSTFS_ADDRESS: ":9000" + RUSTFS_CONSOLE_ADDRESS: ":9001" + RUSTFS_OBS_LOGGER_LEVEL: error + RUSTFS_OBS_LOG_DIRECTORY: /var/log/rustfs/ expose: - "9000" - "9001" diff --git a/content/fr/developer/integration/reverse-proxy/haproxy.md b/content/fr/developer/integration/reverse-proxy/haproxy.md index faac09ef..265b88c6 100644 --- a/content/fr/developer/integration/reverse-proxy/haproxy.md +++ b/content/fr/developer/integration/reverse-proxy/haproxy.md @@ -128,8 +128,10 @@ services: RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY} RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY} RUSTFS_CONSOLE_ENABLE: "true" - RUSTFS_ADDRESS: "0.0.0.0:9000" - RUSTFS_CONSOLE_ADDRESS: "0.0.0.0:9001" + RUSTFS_ADDRESS: ":9000" + RUSTFS_CONSOLE_ADDRESS: ":9001" + RUSTFS_OBS_LOGGER_LEVEL: error + RUSTFS_OBS_LOG_DIRECTORY: /var/log/rustfs/ expose: - "9000" - "9001" diff --git a/content/fr/developer/integration/reverse-proxy/nginx.md b/content/fr/developer/integration/reverse-proxy/nginx.md index 12eb5230..b7d025c3 100644 --- a/content/fr/developer/integration/reverse-proxy/nginx.md +++ b/content/fr/developer/integration/reverse-proxy/nginx.md @@ -167,8 +167,10 @@ services: RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY} RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY} RUSTFS_CONSOLE_ENABLE: "true" - RUSTFS_ADDRESS: "0.0.0.0:9000" - RUSTFS_CONSOLE_ADDRESS: "0.0.0.0:9001" + RUSTFS_ADDRESS: ":9000" + RUSTFS_CONSOLE_ADDRESS: ":9001" + RUSTFS_OBS_LOGGER_LEVEL: error + RUSTFS_OBS_LOG_DIRECTORY: /var/log/rustfs/ expose: - "9000" - "9001" diff --git a/content/fr/developer/integration/reverse-proxy/traefik.md b/content/fr/developer/integration/reverse-proxy/traefik.md index 7e319593..a40c7f42 100644 --- a/content/fr/developer/integration/reverse-proxy/traefik.md +++ b/content/fr/developer/integration/reverse-proxy/traefik.md @@ -83,8 +83,10 @@ services: RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY} RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY} RUSTFS_CONSOLE_ENABLE: "true" - RUSTFS_ADDRESS: "0.0.0.0:9000" - RUSTFS_CONSOLE_ADDRESS: "0.0.0.0:9001" + RUSTFS_ADDRESS: ":9000" + RUSTFS_CONSOLE_ADDRESS: ":9001" + RUSTFS_OBS_LOGGER_LEVEL: error + RUSTFS_OBS_LOG_DIRECTORY: /var/log/rustfs/ expose: - "9000" - "9001" diff --git a/content/fr/installation/container/docker.md b/content/fr/installation/container/docker.md index 26124785..8469df29 100644 --- a/content/fr/installation/container/docker.md +++ b/content/fr/installation/container/docker.md @@ -32,7 +32,11 @@ docker run -d \ -v rustfs-data:/data \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ + -e RUSTFS_ADDRESS=":9000" \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ rustfs/rustfs:latest \ /data ``` diff --git a/content/fr/installation/container/index.mdx b/content/fr/installation/container/index.mdx index b7528a27..27ed2b35 100644 --- a/content/fr/installation/container/index.mdx +++ b/content/fr/installation/container/index.mdx @@ -76,8 +76,11 @@ docker run -d \ -v /mnt/rustfs/data:/data \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ - -e RUSTFS_ADDRESS=:9000 \ + -e RUSTFS_ADDRESS=":9000" \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ rustfs/rustfs:latest \ /data ``` @@ -121,7 +124,11 @@ docker run -d \ -p 9000:9000 \ -p 9001:9001 \ -v /mnt/data:/data \ - -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_ADDRESS=":9000" \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ + -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ rustfs/rustfs:latest \ --console-enable \ /data @@ -173,7 +180,7 @@ Running the command under root directory, docker compose --profile observability up -d ``` -Providing the necessary permissions. An initialization container is necessary to grant the correct access rights to rustfs using the `depends_on` keyword. In the example below the `rustfs_perms` service is added to the `docker-compose.yml` to handle this. To ensure logs are persisted and accessible, we map the host log directory to the container's `/logs` path +Providing the necessary permissions. An initialization container is necessary to grant the correct access rights to rustfs using the `depends_on` keyword. In the example below the `rustfs_perms` service is added to the `docker-compose.yml` to handle this. To ensure logs are persisted and accessible, we map the host log directory to the container's `/var/log/rustfs/` path ```yaml title="docker-compose.yml" services: @@ -192,9 +199,13 @@ Providing the necessary permissions. An initialization container is necessary to condition: service_completed_successfully volumes: - /path/to_host_directory/volumes/data:/data - - /path/to_host_directory/volumes/logs:/logs + - /path/to_host_directory/volumes/logs:/var/log/rustfs/ environment: - - RUSTFS_OBS_LOG_DIRECTORY=/logs + - RUSTFS_ADDRESS=":9000" + - RUSTFS_CONSOLE_ADDRESS=":9001" + - RUSTFS_CONSOLE_ENABLE=true + - RUSTFS_OBS_LOGGER_LEVEL=error + - RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" # ... other configurations ``` @@ -269,7 +280,11 @@ docker run -d \ -v /mnt/rustfs/data:/data \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ + -e RUSTFS_ADDRESS=":9000" \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ -e RUSTFS_VOLUMES="http://node{1...4}:9000/data/rustfs{0...3}" \ rustfs/rustfs:latest ``` diff --git a/content/fr/installation/container/podman.md b/content/fr/installation/container/podman.md index fdcb320a..5c478328 100644 --- a/content/fr/installation/container/podman.md +++ b/content/fr/installation/container/podman.md @@ -31,7 +31,11 @@ podman run -d \ -v rustfs-data:/data \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ + -e RUSTFS_ADDRESS=":9000" \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ docker.io/rustfs/rustfs:latest \ /data ``` diff --git a/content/fr/installation/linux/multiple-node-multiple-disk.md b/content/fr/installation/linux/multiple-node-multiple-disk.md index eaf7bfb3..797c9cd9 100644 --- a/content/fr/installation/linux/multiple-node-multiple-disk.md +++ b/content/fr/installation/linux/multiple-node-multiple-disk.md @@ -68,8 +68,9 @@ RUSTFS_SECRET_KEY= RUSTFS_VOLUMES="http://node{1...4}:9000/data/rustfs{0...3}" RUSTFS_ADDRESS=":9000" RUSTFS_CONSOLE_ENABLE=true -RUST_LOG=error -RUSTFS_OBS_LOG_DIRECTORY="/var/logs/rustfs/" +RUSTFS_CONSOLE_ADDRESS=":9001" +RUSTFS_OBS_LOGGER_LEVEL=error +RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" ``` :::note @@ -81,8 +82,8 @@ The access key, secret key, and `RUSTFS_VOLUMES` value must be identical on all 2. Create the storage and log directories on every node: ```bash -sudo mkdir -p /data/rustfs{0..3} /var/logs/rustfs /opt/tls -sudo chmod -R 750 /data/rustfs* /var/logs/rustfs +sudo mkdir -p /data/rustfs{0..3} /var/log/rustfs /opt/tls +sudo chmod -R 750 /data/rustfs* /var/log/rustfs ``` ## Start Service and Verification @@ -108,7 +109,7 @@ netstat -ntpl 4. View log files: ```bash -tail -f /var/logs/rustfs/rustfs*.log +tail -f /var/log/rustfs/rustfs*.log ``` 5. Access the console: enter any node's IP address (or the load balancer address) and the console port (default 9001) in a browser. You should see: diff --git a/content/fr/installation/linux/prerequisites-and-service.md b/content/fr/installation/linux/prerequisites-and-service.md index 0714609f..8917c54e 100644 --- a/content/fr/installation/linux/prerequisites-and-service.md +++ b/content/fr/installation/linux/prerequisites-and-service.md @@ -206,8 +206,8 @@ RestrictSUIDSGID=true RestrictRealtime=true # service log configuration -StandardOutput=append:/var/logs/rustfs/rustfs.log -StandardError=append:/var/logs/rustfs/rustfs-err.log +StandardOutput=append:/var/log/rustfs/rustfs.log +StandardError=append:/var/log/rustfs/rustfs-err.log [Install] WantedBy=multi-user.target diff --git a/content/fr/installation/linux/single-node-multiple-disk.md b/content/fr/installation/linux/single-node-multiple-disk.md index 95dd8f00..4f4c2690 100644 --- a/content/fr/installation/linux/single-node-multiple-disk.md +++ b/content/fr/installation/linux/single-node-multiple-disk.md @@ -43,15 +43,16 @@ RUSTFS_SECRET_KEY= RUSTFS_VOLUMES="/data/rustfs{0...3}" RUSTFS_ADDRESS=":9000" RUSTFS_CONSOLE_ENABLE=true -RUST_LOG=error -RUSTFS_OBS_LOG_DIRECTORY="/var/logs/rustfs/" +RUSTFS_CONSOLE_ADDRESS=":9001" +RUSTFS_OBS_LOGGER_LEVEL=error +RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" ``` 2. Create the storage and log directories: ```bash -sudo mkdir -p /data/rustfs{0..3} /var/logs/rustfs /opt/tls -sudo chmod -R 750 /data/rustfs* /var/logs/rustfs +sudo mkdir -p /data/rustfs{0..3} /var/log/rustfs /opt/tls +sudo chmod -R 750 /data/rustfs* /var/log/rustfs ``` ## Start Service and Verification @@ -77,7 +78,7 @@ netstat -ntpl 4. View log files: ```bash -tail -f /var/logs/rustfs/rustfs*.log +tail -f /var/log/rustfs/rustfs*.log ``` 5. Access the console: enter the server's IP address and the console port (default 9001) in a browser. You should see: diff --git a/content/fr/installation/linux/single-node-single-disk.md b/content/fr/installation/linux/single-node-single-disk.md index cf912d2f..b6c96e62 100644 --- a/content/fr/installation/linux/single-node-single-disk.md +++ b/content/fr/installation/linux/single-node-single-disk.md @@ -42,15 +42,16 @@ RUSTFS_SECRET_KEY= RUSTFS_VOLUMES="/data/rustfs0" RUSTFS_ADDRESS=":9000" RUSTFS_CONSOLE_ENABLE=true -RUST_LOG=error -RUSTFS_OBS_LOG_DIRECTORY="/var/logs/rustfs/" +RUSTFS_CONSOLE_ADDRESS=":9001" +RUSTFS_OBS_LOGGER_LEVEL=error +RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" ``` 2. Create the storage and log directories: ```bash -sudo mkdir -p /data/rustfs0 /var/logs/rustfs /opt/tls -sudo chmod -R 750 /data/rustfs* /var/logs/rustfs +sudo mkdir -p /data/rustfs0 /var/log/rustfs /opt/tls +sudo chmod -R 750 /data/rustfs* /var/log/rustfs ``` ## Start Service and Verification @@ -76,7 +77,7 @@ netstat -ntpl 4. View log files: ```bash -tail -f /var/logs/rustfs/rustfs*.log +tail -f /var/log/rustfs/rustfs*.log ``` 5. Access the console: enter the server's IP address and the console port (default 9001) in a browser. You should see: diff --git a/content/fr/operations/observability.md b/content/fr/operations/observability.md index 2496cb2e..b0531ca3 100644 --- a/content/fr/operations/observability.md +++ b/content/fr/operations/observability.md @@ -209,13 +209,16 @@ Per-disk usage and disk online/offline state are currently surfaced through the Where logs go is controlled by `RUSTFS_OBS_LOG_DIRECTORY`: - **Unset** — logs go to stdout. In containers, use your log driver; on systemd hosts, stdout/stderr is captured by **journald**, so `journalctl -u rustfs -f` works without extra configuration. -- **A local directory** (e.g. `/logs`) — RustFS writes rotating log files there. Rotation is tuned with `RUSTFS_OBS_LOG_FILENAME`, `RUSTFS_OBS_LOG_ROTATION_SIZE_MB`, `RUSTFS_OBS_LOG_ROTATION_TIME`, and `RUSTFS_OBS_LOG_KEEP_FILES`. +- **A local directory** (e.g. `/var/log/rustfs/`) — RustFS writes rotating log files there. Rotation is tuned with `RUSTFS_OBS_LOG_FILENAME`, `RUSTFS_OBS_LOG_ROTATION_SIZE_MB`, `RUSTFS_OBS_LOG_ROTATION_TIME`, and `RUSTFS_OBS_LOG_KEEP_FILES`. - **A URL** (contains `://`) — logs are shipped to a remote endpoint. When `RUSTFS_OBS_ENDPOINT` is set and log export is enabled, logs are additionally exported via OTLP; the reference stack routes them into Loki for querying from Grafana. ```bash title="Example: file logs plus OTLP export" -RUSTFS_OBS_LOG_DIRECTORY=/var/log/rustfs -RUSTFS_OBS_LOGGER_LEVEL=info +RUSTFS_ADDRESS=":9000" +RUSTFS_CONSOLE_ADDRESS=":9001" +RUSTFS_CONSOLE_ENABLE=true +RUSTFS_OBS_LOGGER_LEVEL=error +RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" RUSTFS_OBS_ENDPOINT=http://otel-collector:4318 ``` diff --git a/content/fr/operations/upgrade/container/index.md b/content/fr/operations/upgrade/container/index.md index 071146bc..e9e388f1 100644 --- a/content/fr/operations/upgrade/container/index.md +++ b/content/fr/operations/upgrade/container/index.md @@ -50,7 +50,11 @@ docker run -d \ -v rustfs-data:/data \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ + -e RUSTFS_ADDRESS=":9000" \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ rustfs/rustfs: \ /data ``` @@ -84,7 +88,11 @@ podman run -d \ -v rustfs-data:/data \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ + -e RUSTFS_ADDRESS=":9000" \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ docker.io/rustfs/rustfs: \ /data ``` diff --git a/content/fr/troubleshooting/driver.md b/content/fr/troubleshooting/driver.md index 19176e8c..f0d48390 100644 --- a/content/fr/troubleshooting/driver.md +++ b/content/fr/troubleshooting/driver.md @@ -118,7 +118,7 @@ Once RustFS detects a freshly formatted disk at a known mount point, its backgro journalctl -u rustfs -f # Or view the log files under the directory set by RUSTFS_OBS_LOG_DIRECTORY -tail -f /var/logs/rustfs/rustfs.log +tail -f /var/log/rustfs/rustfs.log ``` You can also open the RustFS Console and check the disk status of the affected node. diff --git a/content/ja/administration/console/index.md b/content/ja/administration/console/index.md index 489ef506..e8af749f 100644 --- a/content/ja/administration/console/index.md +++ b/content/ja/administration/console/index.md @@ -10,8 +10,11 @@ The **RustFS Console** is the web administration interface for RustFS. Use this The Console is enabled by default and listens on port `9001`, separately from the S3 API on port `9000`. You can set the behavior explicitly with the following environment variables: ```ini title="/etc/default/rustfs" -RUSTFS_CONSOLE_ENABLE=true +RUSTFS_ADDRESS=":9000" RUSTFS_CONSOLE_ADDRESS=":9001" +RUSTFS_CONSOLE_ENABLE=true +RUSTFS_OBS_LOGGER_LEVEL=error +RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" ``` Restart RustFS after changing these values. Set `RUSTFS_CONSOLE_ENABLE=false` when the Console must not run. diff --git a/content/ja/developer/integration/big-data/iceberg.md b/content/ja/developer/integration/big-data/iceberg.md index 568a3699..9511170c 100644 --- a/content/ja/developer/integration/big-data/iceberg.md +++ b/content/ja/developer/integration/big-data/iceberg.md @@ -70,9 +70,11 @@ services: RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY} RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY} RUSTFS_VOLUMES: /data - RUSTFS_ADDRESS: 0.0.0.0:9000 - RUSTFS_CONSOLE_ADDRESS: 0.0.0.0:9001 + RUSTFS_ADDRESS: ":9000" + RUSTFS_CONSOLE_ADDRESS: ":9001" RUSTFS_CONSOLE_ENABLE: "true" + RUSTFS_OBS_LOGGER_LEVEL: error + RUSTFS_OBS_LOG_DIRECTORY: /var/log/rustfs/ volumes: - rustfs-data:/data ports: diff --git a/content/ja/developer/integration/big-data/milvus.md b/content/ja/developer/integration/big-data/milvus.md index 869be2d3..2b17701b 100644 --- a/content/ja/developer/integration/big-data/milvus.md +++ b/content/ja/developer/integration/big-data/milvus.md @@ -96,9 +96,11 @@ services: RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY} RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY} RUSTFS_VOLUMES: /data - RUSTFS_ADDRESS: 0.0.0.0:9000 - RUSTFS_CONSOLE_ADDRESS: 0.0.0.0:9001 + RUSTFS_ADDRESS: ":9000" + RUSTFS_CONSOLE_ADDRESS: ":9001" RUSTFS_CONSOLE_ENABLE: "true" + RUSTFS_OBS_LOGGER_LEVEL: error + RUSTFS_OBS_LOG_DIRECTORY: /var/log/rustfs/ volumes: - rustfs-data:/data ports: diff --git a/content/ja/developer/integration/reverse-proxy/caddy.md b/content/ja/developer/integration/reverse-proxy/caddy.md index 57c1a55b..cd1c2384 100644 --- a/content/ja/developer/integration/reverse-proxy/caddy.md +++ b/content/ja/developer/integration/reverse-proxy/caddy.md @@ -109,8 +109,10 @@ services: RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY} RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY} RUSTFS_CONSOLE_ENABLE: "true" - RUSTFS_ADDRESS: "0.0.0.0:9000" - RUSTFS_CONSOLE_ADDRESS: "0.0.0.0:9001" + RUSTFS_ADDRESS: ":9000" + RUSTFS_CONSOLE_ADDRESS: ":9001" + RUSTFS_OBS_LOGGER_LEVEL: error + RUSTFS_OBS_LOG_DIRECTORY: /var/log/rustfs/ expose: - "9000" - "9001" diff --git a/content/ja/developer/integration/reverse-proxy/haproxy.md b/content/ja/developer/integration/reverse-proxy/haproxy.md index faac09ef..265b88c6 100644 --- a/content/ja/developer/integration/reverse-proxy/haproxy.md +++ b/content/ja/developer/integration/reverse-proxy/haproxy.md @@ -128,8 +128,10 @@ services: RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY} RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY} RUSTFS_CONSOLE_ENABLE: "true" - RUSTFS_ADDRESS: "0.0.0.0:9000" - RUSTFS_CONSOLE_ADDRESS: "0.0.0.0:9001" + RUSTFS_ADDRESS: ":9000" + RUSTFS_CONSOLE_ADDRESS: ":9001" + RUSTFS_OBS_LOGGER_LEVEL: error + RUSTFS_OBS_LOG_DIRECTORY: /var/log/rustfs/ expose: - "9000" - "9001" diff --git a/content/ja/developer/integration/reverse-proxy/nginx.md b/content/ja/developer/integration/reverse-proxy/nginx.md index 12eb5230..b7d025c3 100644 --- a/content/ja/developer/integration/reverse-proxy/nginx.md +++ b/content/ja/developer/integration/reverse-proxy/nginx.md @@ -167,8 +167,10 @@ services: RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY} RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY} RUSTFS_CONSOLE_ENABLE: "true" - RUSTFS_ADDRESS: "0.0.0.0:9000" - RUSTFS_CONSOLE_ADDRESS: "0.0.0.0:9001" + RUSTFS_ADDRESS: ":9000" + RUSTFS_CONSOLE_ADDRESS: ":9001" + RUSTFS_OBS_LOGGER_LEVEL: error + RUSTFS_OBS_LOG_DIRECTORY: /var/log/rustfs/ expose: - "9000" - "9001" diff --git a/content/ja/developer/integration/reverse-proxy/traefik.md b/content/ja/developer/integration/reverse-proxy/traefik.md index 7e319593..a40c7f42 100644 --- a/content/ja/developer/integration/reverse-proxy/traefik.md +++ b/content/ja/developer/integration/reverse-proxy/traefik.md @@ -83,8 +83,10 @@ services: RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY} RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY} RUSTFS_CONSOLE_ENABLE: "true" - RUSTFS_ADDRESS: "0.0.0.0:9000" - RUSTFS_CONSOLE_ADDRESS: "0.0.0.0:9001" + RUSTFS_ADDRESS: ":9000" + RUSTFS_CONSOLE_ADDRESS: ":9001" + RUSTFS_OBS_LOGGER_LEVEL: error + RUSTFS_OBS_LOG_DIRECTORY: /var/log/rustfs/ expose: - "9000" - "9001" diff --git a/content/ja/installation/container/docker.md b/content/ja/installation/container/docker.md index 26124785..8469df29 100644 --- a/content/ja/installation/container/docker.md +++ b/content/ja/installation/container/docker.md @@ -32,7 +32,11 @@ docker run -d \ -v rustfs-data:/data \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ + -e RUSTFS_ADDRESS=":9000" \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ rustfs/rustfs:latest \ /data ``` diff --git a/content/ja/installation/container/index.mdx b/content/ja/installation/container/index.mdx index b7528a27..27ed2b35 100644 --- a/content/ja/installation/container/index.mdx +++ b/content/ja/installation/container/index.mdx @@ -76,8 +76,11 @@ docker run -d \ -v /mnt/rustfs/data:/data \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ - -e RUSTFS_ADDRESS=:9000 \ + -e RUSTFS_ADDRESS=":9000" \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ rustfs/rustfs:latest \ /data ``` @@ -121,7 +124,11 @@ docker run -d \ -p 9000:9000 \ -p 9001:9001 \ -v /mnt/data:/data \ - -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_ADDRESS=":9000" \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ + -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ rustfs/rustfs:latest \ --console-enable \ /data @@ -173,7 +180,7 @@ Running the command under root directory, docker compose --profile observability up -d ``` -Providing the necessary permissions. An initialization container is necessary to grant the correct access rights to rustfs using the `depends_on` keyword. In the example below the `rustfs_perms` service is added to the `docker-compose.yml` to handle this. To ensure logs are persisted and accessible, we map the host log directory to the container's `/logs` path +Providing the necessary permissions. An initialization container is necessary to grant the correct access rights to rustfs using the `depends_on` keyword. In the example below the `rustfs_perms` service is added to the `docker-compose.yml` to handle this. To ensure logs are persisted and accessible, we map the host log directory to the container's `/var/log/rustfs/` path ```yaml title="docker-compose.yml" services: @@ -192,9 +199,13 @@ Providing the necessary permissions. An initialization container is necessary to condition: service_completed_successfully volumes: - /path/to_host_directory/volumes/data:/data - - /path/to_host_directory/volumes/logs:/logs + - /path/to_host_directory/volumes/logs:/var/log/rustfs/ environment: - - RUSTFS_OBS_LOG_DIRECTORY=/logs + - RUSTFS_ADDRESS=":9000" + - RUSTFS_CONSOLE_ADDRESS=":9001" + - RUSTFS_CONSOLE_ENABLE=true + - RUSTFS_OBS_LOGGER_LEVEL=error + - RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" # ... other configurations ``` @@ -269,7 +280,11 @@ docker run -d \ -v /mnt/rustfs/data:/data \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ + -e RUSTFS_ADDRESS=":9000" \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ -e RUSTFS_VOLUMES="http://node{1...4}:9000/data/rustfs{0...3}" \ rustfs/rustfs:latest ``` diff --git a/content/ja/installation/container/podman.md b/content/ja/installation/container/podman.md index fdcb320a..5c478328 100644 --- a/content/ja/installation/container/podman.md +++ b/content/ja/installation/container/podman.md @@ -31,7 +31,11 @@ podman run -d \ -v rustfs-data:/data \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ + -e RUSTFS_ADDRESS=":9000" \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ docker.io/rustfs/rustfs:latest \ /data ``` diff --git a/content/ja/installation/linux/multiple-node-multiple-disk.md b/content/ja/installation/linux/multiple-node-multiple-disk.md index eaf7bfb3..797c9cd9 100644 --- a/content/ja/installation/linux/multiple-node-multiple-disk.md +++ b/content/ja/installation/linux/multiple-node-multiple-disk.md @@ -68,8 +68,9 @@ RUSTFS_SECRET_KEY= RUSTFS_VOLUMES="http://node{1...4}:9000/data/rustfs{0...3}" RUSTFS_ADDRESS=":9000" RUSTFS_CONSOLE_ENABLE=true -RUST_LOG=error -RUSTFS_OBS_LOG_DIRECTORY="/var/logs/rustfs/" +RUSTFS_CONSOLE_ADDRESS=":9001" +RUSTFS_OBS_LOGGER_LEVEL=error +RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" ``` :::note @@ -81,8 +82,8 @@ The access key, secret key, and `RUSTFS_VOLUMES` value must be identical on all 2. Create the storage and log directories on every node: ```bash -sudo mkdir -p /data/rustfs{0..3} /var/logs/rustfs /opt/tls -sudo chmod -R 750 /data/rustfs* /var/logs/rustfs +sudo mkdir -p /data/rustfs{0..3} /var/log/rustfs /opt/tls +sudo chmod -R 750 /data/rustfs* /var/log/rustfs ``` ## Start Service and Verification @@ -108,7 +109,7 @@ netstat -ntpl 4. View log files: ```bash -tail -f /var/logs/rustfs/rustfs*.log +tail -f /var/log/rustfs/rustfs*.log ``` 5. Access the console: enter any node's IP address (or the load balancer address) and the console port (default 9001) in a browser. You should see: diff --git a/content/ja/installation/linux/prerequisites-and-service.md b/content/ja/installation/linux/prerequisites-and-service.md index 0714609f..8917c54e 100644 --- a/content/ja/installation/linux/prerequisites-and-service.md +++ b/content/ja/installation/linux/prerequisites-and-service.md @@ -206,8 +206,8 @@ RestrictSUIDSGID=true RestrictRealtime=true # service log configuration -StandardOutput=append:/var/logs/rustfs/rustfs.log -StandardError=append:/var/logs/rustfs/rustfs-err.log +StandardOutput=append:/var/log/rustfs/rustfs.log +StandardError=append:/var/log/rustfs/rustfs-err.log [Install] WantedBy=multi-user.target diff --git a/content/ja/installation/linux/single-node-multiple-disk.md b/content/ja/installation/linux/single-node-multiple-disk.md index 95dd8f00..4f4c2690 100644 --- a/content/ja/installation/linux/single-node-multiple-disk.md +++ b/content/ja/installation/linux/single-node-multiple-disk.md @@ -43,15 +43,16 @@ RUSTFS_SECRET_KEY= RUSTFS_VOLUMES="/data/rustfs{0...3}" RUSTFS_ADDRESS=":9000" RUSTFS_CONSOLE_ENABLE=true -RUST_LOG=error -RUSTFS_OBS_LOG_DIRECTORY="/var/logs/rustfs/" +RUSTFS_CONSOLE_ADDRESS=":9001" +RUSTFS_OBS_LOGGER_LEVEL=error +RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" ``` 2. Create the storage and log directories: ```bash -sudo mkdir -p /data/rustfs{0..3} /var/logs/rustfs /opt/tls -sudo chmod -R 750 /data/rustfs* /var/logs/rustfs +sudo mkdir -p /data/rustfs{0..3} /var/log/rustfs /opt/tls +sudo chmod -R 750 /data/rustfs* /var/log/rustfs ``` ## Start Service and Verification @@ -77,7 +78,7 @@ netstat -ntpl 4. View log files: ```bash -tail -f /var/logs/rustfs/rustfs*.log +tail -f /var/log/rustfs/rustfs*.log ``` 5. Access the console: enter the server's IP address and the console port (default 9001) in a browser. You should see: diff --git a/content/ja/installation/linux/single-node-single-disk.md b/content/ja/installation/linux/single-node-single-disk.md index cf912d2f..b6c96e62 100644 --- a/content/ja/installation/linux/single-node-single-disk.md +++ b/content/ja/installation/linux/single-node-single-disk.md @@ -42,15 +42,16 @@ RUSTFS_SECRET_KEY= RUSTFS_VOLUMES="/data/rustfs0" RUSTFS_ADDRESS=":9000" RUSTFS_CONSOLE_ENABLE=true -RUST_LOG=error -RUSTFS_OBS_LOG_DIRECTORY="/var/logs/rustfs/" +RUSTFS_CONSOLE_ADDRESS=":9001" +RUSTFS_OBS_LOGGER_LEVEL=error +RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" ``` 2. Create the storage and log directories: ```bash -sudo mkdir -p /data/rustfs0 /var/logs/rustfs /opt/tls -sudo chmod -R 750 /data/rustfs* /var/logs/rustfs +sudo mkdir -p /data/rustfs0 /var/log/rustfs /opt/tls +sudo chmod -R 750 /data/rustfs* /var/log/rustfs ``` ## Start Service and Verification @@ -76,7 +77,7 @@ netstat -ntpl 4. View log files: ```bash -tail -f /var/logs/rustfs/rustfs*.log +tail -f /var/log/rustfs/rustfs*.log ``` 5. Access the console: enter the server's IP address and the console port (default 9001) in a browser. You should see: diff --git a/content/ja/operations/observability.md b/content/ja/operations/observability.md index 2496cb2e..b0531ca3 100644 --- a/content/ja/operations/observability.md +++ b/content/ja/operations/observability.md @@ -209,13 +209,16 @@ Per-disk usage and disk online/offline state are currently surfaced through the Where logs go is controlled by `RUSTFS_OBS_LOG_DIRECTORY`: - **Unset** — logs go to stdout. In containers, use your log driver; on systemd hosts, stdout/stderr is captured by **journald**, so `journalctl -u rustfs -f` works without extra configuration. -- **A local directory** (e.g. `/logs`) — RustFS writes rotating log files there. Rotation is tuned with `RUSTFS_OBS_LOG_FILENAME`, `RUSTFS_OBS_LOG_ROTATION_SIZE_MB`, `RUSTFS_OBS_LOG_ROTATION_TIME`, and `RUSTFS_OBS_LOG_KEEP_FILES`. +- **A local directory** (e.g. `/var/log/rustfs/`) — RustFS writes rotating log files there. Rotation is tuned with `RUSTFS_OBS_LOG_FILENAME`, `RUSTFS_OBS_LOG_ROTATION_SIZE_MB`, `RUSTFS_OBS_LOG_ROTATION_TIME`, and `RUSTFS_OBS_LOG_KEEP_FILES`. - **A URL** (contains `://`) — logs are shipped to a remote endpoint. When `RUSTFS_OBS_ENDPOINT` is set and log export is enabled, logs are additionally exported via OTLP; the reference stack routes them into Loki for querying from Grafana. ```bash title="Example: file logs plus OTLP export" -RUSTFS_OBS_LOG_DIRECTORY=/var/log/rustfs -RUSTFS_OBS_LOGGER_LEVEL=info +RUSTFS_ADDRESS=":9000" +RUSTFS_CONSOLE_ADDRESS=":9001" +RUSTFS_CONSOLE_ENABLE=true +RUSTFS_OBS_LOGGER_LEVEL=error +RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" RUSTFS_OBS_ENDPOINT=http://otel-collector:4318 ``` diff --git a/content/ja/operations/upgrade/container/index.md b/content/ja/operations/upgrade/container/index.md index 071146bc..e9e388f1 100644 --- a/content/ja/operations/upgrade/container/index.md +++ b/content/ja/operations/upgrade/container/index.md @@ -50,7 +50,11 @@ docker run -d \ -v rustfs-data:/data \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ + -e RUSTFS_ADDRESS=":9000" \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ rustfs/rustfs: \ /data ``` @@ -84,7 +88,11 @@ podman run -d \ -v rustfs-data:/data \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ + -e RUSTFS_ADDRESS=":9000" \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ docker.io/rustfs/rustfs: \ /data ``` diff --git a/content/ja/troubleshooting/driver.md b/content/ja/troubleshooting/driver.md index 19176e8c..f0d48390 100644 --- a/content/ja/troubleshooting/driver.md +++ b/content/ja/troubleshooting/driver.md @@ -118,7 +118,7 @@ Once RustFS detects a freshly formatted disk at a known mount point, its backgro journalctl -u rustfs -f # Or view the log files under the directory set by RUSTFS_OBS_LOG_DIRECTORY -tail -f /var/logs/rustfs/rustfs.log +tail -f /var/log/rustfs/rustfs.log ``` You can also open the RustFS Console and check the disk status of the affected node. diff --git a/content/zh/administration/console/index.md b/content/zh/administration/console/index.md index bd687705..7ec7101c 100644 --- a/content/zh/administration/console/index.md +++ b/content/zh/administration/console/index.md @@ -10,8 +10,11 @@ description: "启用 RustFS 控制台，将其连接到服务器并安全登录 控制台默认启用并监听端口 `9001`，与端口 `9000` 上的 S3 API 分开。你可以使用以下环境变量显式设置其行为： ```ini title="/etc/default/rustfs" -RUSTFS_CONSOLE_ENABLE=true +RUSTFS_ADDRESS=":9000" RUSTFS_CONSOLE_ADDRESS=":9001" +RUSTFS_CONSOLE_ENABLE=true +RUSTFS_OBS_LOGGER_LEVEL=error +RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" ``` 更改这些值后请重启 RustFS。如果不应运行控制台，请设置 `RUSTFS_CONSOLE_ENABLE=false`。 diff --git a/content/zh/developer/integration/big-data/iceberg.md b/content/zh/developer/integration/big-data/iceberg.md index bb45f445..521af853 100644 --- a/content/zh/developer/integration/big-data/iceberg.md +++ b/content/zh/developer/integration/big-data/iceberg.md @@ -70,9 +70,11 @@ services: RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY} RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY} RUSTFS_VOLUMES: /data - RUSTFS_ADDRESS: 0.0.0.0:9000 - RUSTFS_CONSOLE_ADDRESS: 0.0.0.0:9001 + RUSTFS_ADDRESS: ":9000" + RUSTFS_CONSOLE_ADDRESS: ":9001" RUSTFS_CONSOLE_ENABLE: "true" + RUSTFS_OBS_LOGGER_LEVEL: error + RUSTFS_OBS_LOG_DIRECTORY: /var/log/rustfs/ volumes: - rustfs-data:/data ports: diff --git a/content/zh/developer/integration/big-data/milvus.md b/content/zh/developer/integration/big-data/milvus.md index 3170a287..012218ee 100644 --- a/content/zh/developer/integration/big-data/milvus.md +++ b/content/zh/developer/integration/big-data/milvus.md @@ -96,9 +96,11 @@ services: RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY} RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY} RUSTFS_VOLUMES: /data - RUSTFS_ADDRESS: 0.0.0.0:9000 - RUSTFS_CONSOLE_ADDRESS: 0.0.0.0:9001 + RUSTFS_ADDRESS: ":9000" + RUSTFS_CONSOLE_ADDRESS: ":9001" RUSTFS_CONSOLE_ENABLE: "true" + RUSTFS_OBS_LOGGER_LEVEL: error + RUSTFS_OBS_LOG_DIRECTORY: /var/log/rustfs/ volumes: - rustfs-data:/data ports: diff --git a/content/zh/developer/integration/reverse-proxy/caddy.md b/content/zh/developer/integration/reverse-proxy/caddy.md index e2d3241b..2a1b6baf 100644 --- a/content/zh/developer/integration/reverse-proxy/caddy.md +++ b/content/zh/developer/integration/reverse-proxy/caddy.md @@ -109,8 +109,10 @@ services: RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY} RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY} RUSTFS_CONSOLE_ENABLE: "true" - RUSTFS_ADDRESS: "0.0.0.0:9000" - RUSTFS_CONSOLE_ADDRESS: "0.0.0.0:9001" + RUSTFS_ADDRESS: ":9000" + RUSTFS_CONSOLE_ADDRESS: ":9001" + RUSTFS_OBS_LOGGER_LEVEL: error + RUSTFS_OBS_LOG_DIRECTORY: /var/log/rustfs/ expose: - "9000" - "9001" diff --git a/content/zh/developer/integration/reverse-proxy/haproxy.md b/content/zh/developer/integration/reverse-proxy/haproxy.md index 2ec3e1c1..e21d0574 100644 --- a/content/zh/developer/integration/reverse-proxy/haproxy.md +++ b/content/zh/developer/integration/reverse-proxy/haproxy.md @@ -128,8 +128,10 @@ services: RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY} RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY} RUSTFS_CONSOLE_ENABLE: "true" - RUSTFS_ADDRESS: "0.0.0.0:9000" - RUSTFS_CONSOLE_ADDRESS: "0.0.0.0:9001" + RUSTFS_ADDRESS: ":9000" + RUSTFS_CONSOLE_ADDRESS: ":9001" + RUSTFS_OBS_LOGGER_LEVEL: error + RUSTFS_OBS_LOG_DIRECTORY: /var/log/rustfs/ expose: - "9000" - "9001" diff --git a/content/zh/developer/integration/reverse-proxy/nginx.md b/content/zh/developer/integration/reverse-proxy/nginx.md index eecc77f2..5986a7be 100644 --- a/content/zh/developer/integration/reverse-proxy/nginx.md +++ b/content/zh/developer/integration/reverse-proxy/nginx.md @@ -167,8 +167,10 @@ services: RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY} RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY} RUSTFS_CONSOLE_ENABLE: "true" - RUSTFS_ADDRESS: "0.0.0.0:9000" - RUSTFS_CONSOLE_ADDRESS: "0.0.0.0:9001" + RUSTFS_ADDRESS: ":9000" + RUSTFS_CONSOLE_ADDRESS: ":9001" + RUSTFS_OBS_LOGGER_LEVEL: error + RUSTFS_OBS_LOG_DIRECTORY: /var/log/rustfs/ expose: - "9000" - "9001" diff --git a/content/zh/developer/integration/reverse-proxy/traefik.md b/content/zh/developer/integration/reverse-proxy/traefik.md index 582a0454..4fb67c33 100644 --- a/content/zh/developer/integration/reverse-proxy/traefik.md +++ b/content/zh/developer/integration/reverse-proxy/traefik.md @@ -83,8 +83,10 @@ services: RUSTFS_ACCESS_KEY: ${RUSTFS_ACCESS_KEY} RUSTFS_SECRET_KEY: ${RUSTFS_SECRET_KEY} RUSTFS_CONSOLE_ENABLE: "true" - RUSTFS_ADDRESS: "0.0.0.0:9000" - RUSTFS_CONSOLE_ADDRESS: "0.0.0.0:9001" + RUSTFS_ADDRESS: ":9000" + RUSTFS_CONSOLE_ADDRESS: ":9001" + RUSTFS_OBS_LOGGER_LEVEL: error + RUSTFS_OBS_LOG_DIRECTORY: /var/log/rustfs/ expose: - "9000" - "9001" diff --git a/content/zh/installation/container/docker.md b/content/zh/installation/container/docker.md index be88b517..63fd2915 100644 --- a/content/zh/installation/container/docker.md +++ b/content/zh/installation/container/docker.md @@ -32,7 +32,11 @@ docker run -d \ -v rustfs-data:/data \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ + -e RUSTFS_ADDRESS=":9000" \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ rustfs/rustfs:latest \ /data ``` diff --git a/content/zh/installation/container/index.mdx b/content/zh/installation/container/index.mdx index 93e34b83..6c298bee 100644 --- a/content/zh/installation/container/index.mdx +++ b/content/zh/installation/container/index.mdx @@ -76,8 +76,11 @@ docker run -d \ -v /mnt/rustfs/data:/data \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ - -e RUSTFS_ADDRESS=:9000 \ + -e RUSTFS_ADDRESS=":9000" \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ rustfs/rustfs:latest \ /data ``` @@ -121,7 +124,11 @@ docker run -d \ -p 9000:9000 \ -p 9001:9001 \ -v /mnt/data:/data \ - -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_ADDRESS=":9000" \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ + -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ rustfs/rustfs:latest \ --console-enable \ /data @@ -173,7 +180,7 @@ git clone https://github.com/rustfs/rustfs.git docker compose --profile observability up -d ``` -提供必要的权限。需要使用初始化容器，通过 `depends_on` 关键字为 rustfs 授予正确的访问权限。以下示例将 `rustfs_perms` 服务添加到 `docker-compose.yml` 来处理权限。为了确保日志持久化且可访问，将主机日志目录映射到容器的 `/logs` 路径： +提供必要的权限。需要使用初始化容器，通过 `depends_on` 关键字为 rustfs 授予正确的访问权限。以下示例将 `rustfs_perms` 服务添加到 `docker-compose.yml` 来处理权限。为了确保日志持久化且可访问，将主机日志目录映射到容器的 `/var/log/rustfs/` 路径： ```yaml title="docker-compose.yml" services: @@ -192,9 +199,13 @@ docker compose --profile observability up -d condition: service_completed_successfully volumes: - /path/to_host_directory/volumes/data:/data - - /path/to_host_directory/volumes/logs:/logs + - /path/to_host_directory/volumes/logs:/var/log/rustfs/ environment: - - RUSTFS_OBS_LOG_DIRECTORY=/logs + - RUSTFS_ADDRESS=":9000" + - RUSTFS_CONSOLE_ADDRESS=":9001" + - RUSTFS_CONSOLE_ENABLE=true + - RUSTFS_OBS_LOGGER_LEVEL=error + - RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" # ... other configurations ``` @@ -269,7 +280,11 @@ docker run -d \ -v /mnt/rustfs/data:/data \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ + -e RUSTFS_ADDRESS=":9000" \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ -e RUSTFS_VOLUMES="http://node{1...4}:9000/data/rustfs{0...3}" \ rustfs/rustfs:latest ``` diff --git a/content/zh/installation/container/podman.md b/content/zh/installation/container/podman.md index 6d221434..c33620da 100644 --- a/content/zh/installation/container/podman.md +++ b/content/zh/installation/container/podman.md @@ -31,7 +31,11 @@ podman run -d \ -v rustfs-data:/data \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ + -e RUSTFS_ADDRESS=":9000" \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ docker.io/rustfs/rustfs:latest \ /data ``` diff --git a/content/zh/installation/linux/multiple-node-multiple-disk.md b/content/zh/installation/linux/multiple-node-multiple-disk.md index ec2da226..8d702d97 100644 --- a/content/zh/installation/linux/multiple-node-multiple-disk.md +++ b/content/zh/installation/linux/multiple-node-multiple-disk.md @@ -68,8 +68,9 @@ RUSTFS_SECRET_KEY= RUSTFS_VOLUMES="http://node{1...4}:9000/data/rustfs{0...3}" RUSTFS_ADDRESS=":9000" RUSTFS_CONSOLE_ENABLE=true -RUST_LOG=error -RUSTFS_OBS_LOG_DIRECTORY="/var/logs/rustfs/" +RUSTFS_CONSOLE_ADDRESS=":9001" +RUSTFS_OBS_LOGGER_LEVEL=error +RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" ``` :::note @@ -81,8 +82,8 @@ RUSTFS_OBS_LOG_DIRECTORY="/var/logs/rustfs/" 2. 在每个节点上创建存储和日志目录： ```bash -sudo mkdir -p /data/rustfs{0..3} /var/logs/rustfs /opt/tls -sudo chmod -R 750 /data/rustfs* /var/logs/rustfs +sudo mkdir -p /data/rustfs{0..3} /var/log/rustfs /opt/tls +sudo chmod -R 750 /data/rustfs* /var/log/rustfs ``` ## 启动服务并验证 @@ -108,7 +109,7 @@ netstat -ntpl 4. 查看日志文件： ```bash -tail -f /var/logs/rustfs/rustfs*.log +tail -f /var/log/rustfs/rustfs*.log ``` 5. 访问控制台：在浏览器中输入任一节点的 IP 地址（或负载均衡器地址）和控制台端口（默认 9001）。你将看到： diff --git a/content/zh/installation/linux/prerequisites-and-service.md b/content/zh/installation/linux/prerequisites-and-service.md index 366a6060..d14f1cc1 100644 --- a/content/zh/installation/linux/prerequisites-and-service.md +++ b/content/zh/installation/linux/prerequisites-and-service.md @@ -206,8 +206,8 @@ RestrictSUIDSGID=true RestrictRealtime=true # service log configuration -StandardOutput=append:/var/logs/rustfs/rustfs.log -StandardError=append:/var/logs/rustfs/rustfs-err.log +StandardOutput=append:/var/log/rustfs/rustfs.log +StandardError=append:/var/log/rustfs/rustfs-err.log [Install] WantedBy=multi-user.target diff --git a/content/zh/installation/linux/single-node-multiple-disk.md b/content/zh/installation/linux/single-node-multiple-disk.md index 98094044..1f33793d 100644 --- a/content/zh/installation/linux/single-node-multiple-disk.md +++ b/content/zh/installation/linux/single-node-multiple-disk.md @@ -43,15 +43,16 @@ RUSTFS_SECRET_KEY= RUSTFS_VOLUMES="/data/rustfs{0...3}" RUSTFS_ADDRESS=":9000" RUSTFS_CONSOLE_ENABLE=true -RUST_LOG=error -RUSTFS_OBS_LOG_DIRECTORY="/var/logs/rustfs/" +RUSTFS_CONSOLE_ADDRESS=":9001" +RUSTFS_OBS_LOGGER_LEVEL=error +RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" ``` 2. 创建存储和日志目录： ```bash -sudo mkdir -p /data/rustfs{0..3} /var/logs/rustfs /opt/tls -sudo chmod -R 750 /data/rustfs* /var/logs/rustfs +sudo mkdir -p /data/rustfs{0..3} /var/log/rustfs /opt/tls +sudo chmod -R 750 /data/rustfs* /var/log/rustfs ``` ## 启动服务并验证 @@ -77,7 +78,7 @@ netstat -ntpl 4. 查看日志文件： ```bash -tail -f /var/logs/rustfs/rustfs*.log +tail -f /var/log/rustfs/rustfs*.log ``` 5. 访问控制台：在浏览器中输入服务器 IP 地址和控制台端口（默认 9001）。你将看到： diff --git a/content/zh/installation/linux/single-node-single-disk.md b/content/zh/installation/linux/single-node-single-disk.md index a7e22f7e..66bc8751 100644 --- a/content/zh/installation/linux/single-node-single-disk.md +++ b/content/zh/installation/linux/single-node-single-disk.md @@ -42,15 +42,16 @@ RUSTFS_SECRET_KEY= RUSTFS_VOLUMES="/data/rustfs0" RUSTFS_ADDRESS=":9000" RUSTFS_CONSOLE_ENABLE=true -RUST_LOG=error -RUSTFS_OBS_LOG_DIRECTORY="/var/logs/rustfs/" +RUSTFS_CONSOLE_ADDRESS=":9001" +RUSTFS_OBS_LOGGER_LEVEL=error +RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" ``` 2. 创建存储和日志目录： ```bash -sudo mkdir -p /data/rustfs0 /var/logs/rustfs /opt/tls -sudo chmod -R 750 /data/rustfs* /var/logs/rustfs +sudo mkdir -p /data/rustfs0 /var/log/rustfs /opt/tls +sudo chmod -R 750 /data/rustfs* /var/log/rustfs ``` ## 启动服务并验证 @@ -76,7 +77,7 @@ netstat -ntpl 4. 查看日志文件： ```bash -tail -f /var/logs/rustfs/rustfs*.log +tail -f /var/log/rustfs/rustfs*.log ``` 5. 访问控制台：在浏览器中输入服务器 IP 地址和控制台端口（默认 9001）。你将看到： diff --git a/content/zh/operations/observability.md b/content/zh/operations/observability.md index 893f3139..22ea8414 100644 --- a/content/zh/operations/observability.md +++ b/content/zh/operations/observability.md @@ -209,13 +209,16 @@ scrape_configs: 日志去向由 `RUSTFS_OBS_LOG_DIRECTORY` 控制： - **未设置**：日志写入 stdout。在容器中使用日志驱动；在 systemd 主机上，stdout/stderr 由 **journald** 捕获，因此无需额外配置即可使用 `journalctl -u rustfs -f`。 -- **本地目录**（例如 `/logs`）：RustFS 在其中写入轮换日志文件。使用 `RUSTFS_OBS_LOG_FILENAME`、`RUSTFS_OBS_LOG_ROTATION_SIZE_MB`、`RUSTFS_OBS_LOG_ROTATION_TIME` 和 `RUSTFS_OBS_LOG_KEEP_FILES` 调整轮换。 +- **本地目录**（例如 `/var/log/rustfs/`）：RustFS 在其中写入轮换日志文件。使用 `RUSTFS_OBS_LOG_FILENAME`、`RUSTFS_OBS_LOG_ROTATION_SIZE_MB`、`RUSTFS_OBS_LOG_ROTATION_TIME` 和 `RUSTFS_OBS_LOG_KEEP_FILES` 调整轮换。 - **URL**（包含 `://`）：日志发送到远程端点。 设置 `RUSTFS_OBS_ENDPOINT` 并启用日志导出后，日志还会通过 OTLP 导出；参考栈将其路由到 Loki，以便从 Grafana 查询。 ```bash title="Example: file logs plus OTLP export" -RUSTFS_OBS_LOG_DIRECTORY=/var/log/rustfs -RUSTFS_OBS_LOGGER_LEVEL=info +RUSTFS_ADDRESS=":9000" +RUSTFS_CONSOLE_ADDRESS=":9001" +RUSTFS_CONSOLE_ENABLE=true +RUSTFS_OBS_LOGGER_LEVEL=error +RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" RUSTFS_OBS_ENDPOINT=http://otel-collector:4318 ``` \ No newline at end of file diff --git a/content/zh/operations/upgrade/container/index.md b/content/zh/operations/upgrade/container/index.md index 59a3bf4f..d0ea376f 100644 --- a/content/zh/operations/upgrade/container/index.md +++ b/content/zh/operations/upgrade/container/index.md @@ -50,7 +50,11 @@ docker run -d \ -v rustfs-data:/data \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ + -e RUSTFS_ADDRESS=":9000" \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ rustfs/rustfs: \ /data ``` @@ -84,7 +88,11 @@ podman run -d \ -v rustfs-data:/data \ -e RUSTFS_ACCESS_KEY="" \ -e RUSTFS_SECRET_KEY="" \ + -e RUSTFS_ADDRESS=":9000" \ + -e RUSTFS_CONSOLE_ADDRESS=":9001" \ -e RUSTFS_CONSOLE_ENABLE=true \ + -e RUSTFS_OBS_LOGGER_LEVEL=error \ + -e RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/" \ docker.io/rustfs/rustfs: \ /data ``` diff --git a/content/zh/troubleshooting/driver.md b/content/zh/troubleshooting/driver.md index 4a0d6c93..b0fa2c85 100644 --- a/content/zh/troubleshooting/driver.md +++ b/content/zh/troubleshooting/driver.md @@ -118,7 +118,7 @@ RustFS 在已知挂载点检测到新格式化的磁盘后，后台扫描器会 journalctl -u rustfs -f # Or view the log files under the directory set by RUSTFS_OBS_LOG_DIRECTORY -tail -f /var/logs/rustfs/rustfs.log +tail -f /var/log/rustfs/rustfs.log ``` 你也可以打开 RustFS 控制台，检查受影响节点的磁盘状态。