本文档采用自动化机器翻译技术翻译。 尽管我们力求提供准确的译文，但不对翻译内容的完整性、准确性或可靠性作出任何保证。 若出现任何内容不一致情况，请以原始 英文 版本为准，且原始英文版本为权威文本。

查错

日志级别

Rancher 中使用以下日志级别：

名称 说明

info

记录信息性讯息。这是默认日志级别。

debug

记录更详细的消息，可用于调试。

trace

记录内部功能的非常详细的消息。这非常冗长，可能包含敏感信息。

如何配置日志级别

Kubernetes 安装

  • 配置调试日志级别

    $ 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

  • 配置信息日志级别

    $ 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 安装

  • 配置调试日志级别

    $ docker exec -ti <container_id> loglevel --set debug
OK
$ docker logs -f <container_id>

  • 配置信息日志级别

    $ 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 的调试日志。

与上述 trace 日志级别一样，rancher-machine 调试日志可能包含敏感信息。

Cattle-cluster-agent 调试日志

在初始化下游集群时，可以设置 cattle-cluster-agent 日志级别。

当您在 集群配置  代理环境变量 下创建集群时，可以设置变量以定义日志级别。

  • 跟踪级别日志：将 CATTLE_TRACE 或 RANCHER_TRACE 设置为 true

  • 调试级别日志：将 CATTLE_DEBUG 或 RANCHER_DEBUG 设置为 true

cattle-cluster-agent 调试日志可能包含敏感信息。