Archiving the v2.6/v2.7 zh docs. Updating the zh sidebar version JSON files to reflect archived messaging in navigation dropdown.

Signed-off-by: Sunil Singh <sunil.singh@suse.com>
2026-05-05 20:53:33 +00:00 · 2025-06-11 16:10:14 -07:00
parent 5069378133
commit af77fc8954
1047 changed files with 28 additions and 1572 deletions
@@ -0,0 +1,72 @@
+---
+title: Logging
+---
+
+## 日志级别
+
+Rancher 使用了以下日志级别：
+
+| 名称 | 描述 |
+|---------|-------------|
+| `info` | 记录信息性消息。这是默认的日志级别。 |
+| `debug` | 记录可用于调试的更详细消息。 |
+| `trace` | 记录内部功能的非常详细的消息。非常冗长，并且可能包含敏感信息。 |
+
+### 如何配置日志级别
+
+#### Kubernetes 安装
+
+* 配置 debug 日志级别
+
+```
+$ KUBECONFIG=./kube_config_cluster.yml
+$ kubectl -n cattle-system get pods -l app=rancher --no-headers -o custom-columns=name:.metadata.name | while read rancherpod; do kubectl -n cattle-system exec $rancherpod -c rancher -- loglevel --set debug; done
+OK
+OK
+OK
+$ kubectl -n cattle-system logs -l app=rancher -c rancher
+```
+
+* 配置 info 日志级别
+
+```
+$ KUBECONFIG=./kube_config_cluster.yml
+$ kubectl -n cattle-system get pods -l app=rancher --no-headers -o custom-columns=name:.metadata.name | while read rancherpod; do kubectl -n cattle-system exec $rancherpod -c rancher -- loglevel --set info; done
+OK
+OK
+OK
+```
+
+#### Docker 安装
+
+* 配置 debug 日志级别
+
+```
+$ docker exec -ti <container_id> loglevel --set debug
+OK
+$ docker logs -f <container_id>
+```
+
+* 配置 info 日志级别
+
+```
+$ docker exec -ti <container_id> loglevel --set info
+OK
+```
+
+## Rancher 主机调试日志
+如果需要解决在基础设施提供商中创建对象的问题，你可以使用 `rancher-machine` 调试日志。
+
+你可以在启动 Rancher 时设置环境变量来为 `rancher-machine` 启用调试日志。
+
+`CATTLE_WHITELIST_ENVVARS` 环境变量允许用户将特定环境变量列入白名单，让它们能在配置期间传递给 `rancher-machine`。
+
+`MACHINE_DEBUG` 变量在 `rancher-machine` 中启用调试日志。
+
+因此，通过设置 `MACHINE_DEBUG=true` 并将 `MACHINE_DEBUG` 添加到 `CATTLE_WHITELIST_ENVVARS` 中的变量默认列表（例如 `CATTLE_WHITELIST_ENVVARS=HTTP_PROXY,HTTPS_PROXY,NO_PROXY,MACHINE_DEBUG`），你可以在配置 RKE1、RKE2 和 K3s 集群时在 `rancher-machine` 中启用调试日志。
+
+:::caution
+
+像上面的 `trace` 日志级别一样，`rancher-machine` 调试日志可以包含敏感信息。
+
+:::