Enabling debug and trace run logs in Terraform Enterprise

Increasing the log level for runs in Terraform Enterprise can help with troubleshooting Terraform issues. To increase the log level:

1. Log into Terraform Enterprise.
2. Navigate to the organization and workspace experiencing the issue.
3. Select the Variables area of the workspace.
4. In the “Environment Variables” section, click the “Edit” slider
5. Add an environment variable named TF_LOG and set its value to DEBUG (case sensitive), then save the variables.

In some cases it may be necessary to further increase the logging by setting the value to TRACE.

Once the environment variable TF_LOG is set, execute another run to generate the debug or trace log. If you need to send the log to HashiCorp support, use View raw log and save the raw log to a file. Compress the file if it’s large; log files compress well.

Once the issue is resolved, delete the TF_LOG environment variable to disable the enhanced logging.