Troubleshooting Basics

When troubleshooting or getting support for the OCI Terraform provider, it's often useful to first check the status of the OCI services, the version of Terraform and the provider, and enable and collect verbose logging.

Tip

Checking service status and verbose log output can help you determine whether an issue is related to the Terraform provider or the OCI service the provider is using.

Refer to the list of common issues after you start with the basics.

Checking OCI Service Status and Outages

To check on the latest status and whether there are any outages in OCI, see OCI Status.

Checking the Terraform and OCI Terraform Provider Versions

To verify the version of Terraform and the OCI Terraform provider, initialize Terraform from a directory with your configurations and then run the -version command. For example:

terraform init
terraform -version

The versions are displayed:

Terraform v0.12.20
+ provider registry.terraform.io/hashicorp/oci v3.95.0
Tip

Newer versions of the OCI Terraform provider include the version of the provider in error messages.

The OCI Terraform provider documentation reflects the latest version. You can view documentation for earlier provider versions by visiting the HashiCorp reference and selecting a specific version. You can also download and install a specific version of the provider.

Verbose Logging for OCI Terraform Provider

To get verbose console output when the provider is running, precede your Terraform command with the TF_LOG and OCI_GO_SDK_DEBUG flags. For example:

TF_LOG=DEBUG OCI_GO_SDK_DEBUG=v terraform plan

The TF_LOG level and OCI_GO_SDK_DEBUG flags can also be set as environment variables.