- OpenTofu 内部结构
- 调试 OpenTofu
调试 OpenTofu
OpenTofu 有详细的日志,您可以通过将 TF_LOG
环境变量设置为任何值来启用它。启用此设置会导致详细日志出现在 stderr
上。
您可以将 TF_LOG
设置为其中一个日志级别(按详细程度降序排列)TRACE
、DEBUG
、INFO
、WARN
或 ERROR
来更改日志的详细程度。
警告
使用 TRACE
级别生成的日志可能包含敏感信息,例如凭据,应谨慎对待。
将 TF_LOG
设置为 JSON
会以 TRACE
级别或更高的级别输出日志,并使用可解析的 JSON 编码作为格式。
警告
日志文件的 JSON 编码不被认为是稳定的接口。它可能随时更改,恕不另行通知。它旨在支持即将推出的工具,并且该工具是与 JSON 格式日志交互的唯一支持方式。
可以使用 TF_LOG_CORE
或 TF_LOG_PROVIDER
环境变量分别为 tofu 本身和提供者插件启用日志记录。这些变量接受与 TF_LOG
相同的级别参数,但仅激活日志的子集。
要持久保存记录的输出,您可以设置 TF_LOG_PATH
,以便在启用日志记录时始终将日志追加到特定文件。请注意,即使设置了 TF_LOG_PATH
,也必须设置 TF_LOG
才能启用任何日志记录。
如果您发现 OpenTofu 的错误,请使用 gist 等服务包含详细日志。