跳至主要内容

调试 OpenTofu

OpenTofu 有详细的日志,您可以通过将 TF_LOG 环境变量设置为任何值来启用它。启用此设置会导致详细日志出现在 stderr 上。

您可以将 TF_LOG 设置为其中一个日志级别(按详细程度降序排列)TRACEDEBUGINFOWARNERROR 来更改日志的详细程度。

TF_LOG 设置为 JSON 会以 TRACE 级别或更高的级别输出日志,并使用可解析的 JSON 编码作为格式。

可以使用 TF_LOG_CORETF_LOG_PROVIDER 环境变量分别为 tofu 本身和提供者插件启用日志记录。这些变量接受与 TF_LOG 相同的级别参数,但仅激活日志的子集。

要持久保存记录的输出,您可以设置 TF_LOG_PATH,以便在启用日志记录时始终将日志追加到特定文件。请注意,即使设置了 TF_LOG_PATH,也必须设置 TF_LOG 才能启用任何日志记录。

如果您发现 OpenTofu 的错误,请使用 gist 等服务包含详细日志。