Diagnose image import and export issues

Diagnose the cause of image import or export issues by reviewing theCloud Build logs and the serial port output of the temporaryVMs (or worker VMs).

Review Cloud Build logs

The image import tool uses the Cloud Build API to import and export images.Review the Cloud Build logs to get the status of the running process.

To view Cloud Build logs, do one of the following:

• If you import or export images by using Google Cloud console, view logs on theImages page in the Google Cloud console, in theImage import history orImage export history tab.Click the Cloud Build ID to view the logs.

  Go to Images

• If you import or export images by using Google Cloud CLI, you can view theCloud Build log location at the standard output after running the process.

Review serial port output

Reviewing the serial port output of the worker VMs that are created during the imageimport or export process might be useful to troubleshoot issues with system-levelentities. For more information about these logs,seeViewing serial port output.

Common errors

The following are examples of common errors you might encounter when you importor export images.

ExportFailed error when exporting images larger than 2 TB

The maximum size for images invmdk,vpc, andvhd formats is limited to2 TB. Therefore, when you export images larger than 2 TB in these formats, youmight see an error message similar to the following in the log:

Error message:

[image -export]: 2022 - 01 - 27T16: 08: 24Z Error running workflow: step"image-export-export-disk" run error: step "wait-for-inst-image-export-export-disk"run error: WaitForInstancesSignal FailureMatch found for"WORKER_VM_NAME--SUFFIX":"ExportFailed: Failed to export disk source toDESTINATION_URI"

Resolution:

To resolve this issue, specify the image format asvdi,vhdx, orqcow2 andset the--timeout value as24h when you run thegcloud compute images export command.

If the issue persists, contactGoogle Cloud Support forassistance.