メインコンテンツへスキップ

OpenTofuのデバッグ

OpenTofuには詳細なログ機能があり、TF_LOG 環境変数を任意の値に設定することで有効にできます。この設定を有効にすると、詳細なログが stderr に表示されます。

TF_LOG をログレベル(詳細度が高い順に)TRACEDEBUGINFOWARN、または ERROR のいずれかに設定すると、ログの詳細度を変更できます。

TF_LOGJSON に設定すると、TRACE レベル以上のログが、解析可能なJSONエンコーディングでフォーマットされて出力されます。

ログは、tofu自体とプロバイダープラグインで個別に有効にすることができ、TF_LOG_CORE または TF_LOG_PROVIDER 環境変数を使用します。これらは TF_LOG と同じレベルの引数を取りますが、ログのサブセットのみをアクティブにします。

ログ出力を永続化するには、TF_LOG_PATH を設定して、ログが有効になっている場合に常に特定のファイルにログが追加されるように強制できます。TF_LOG_PATH が設定されている場合でも、ログを有効にするには TF_LOG を設定する必要があることに注意してください。

OpenTofuのバグを発見した場合は、gistなどのサービスを利用して詳細なログを含めてください。