Stay organized with collections
Save and categorize content based on your preferences.
This page shows you how to resolve issues with Cloud Data Fusion.
Retrieve error information for a failed pipeline run
When a pipeline run fails, you can retrieve detailed error information.
Cloud Data Fusion 6.11.0 classifies pipeline errors by category,
reason, and message. This classification speeds up resolution and reduces the
need to examine complex logs.
To get error details, follow these steps:
Console
In the Google Cloud console, open your Cloud Data Fusion
instance and go to your pipeline on the Studio page.
On the node where the error occurred, click View errors.
Review the error details, which include the error category, error reason,
and error message.
Optional: To download raw logs for further analysis, click
Download raw logs.
The following is a sample response for a plugin error:
[
{
"stageName": "Stage Name",
"errorCategory": "Plugin-x",
"errorReason": "Input path gs://x does not exist",
"errorMessage": "Input path gs://x does not exist",
"errorType": "SYSTEM/USER/UNKNOWN",
"dependency": "true/false"
}
]
```
You can also [view advanced logs for your pipelines](/data-fusion/docs/how-to/viewing-stackdriver-logs).
Resolve issues with creating Cloud Data Fusion instance
When you create a Cloud Data Fusion instance, you might encounter the
following issue:
Read access to project PROJECT_ID was denied.
To resolve this issue, disable and re-enable the
Cloud Data Fusion API, and
then create the instance.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-07 UTC."],[[["\u003cp\u003eThis page provides guidance on resolving issues within Cloud Data Fusion, specifically focusing on retrieving error information for failed pipeline runs and addressing instance creation problems.\u003c/p\u003e\n"],["\u003cp\u003eWhen a pipeline run fails, you can access detailed error information through the Cloud Data Fusion console by navigating to the pipeline in the Studio and clicking "View errors" on the relevant node, which then displays categorized error details.\u003c/p\u003e\n"],["\u003cp\u003eYou can retrieve error details programmatically for failed pipeline runs using a REST API \u003ccode\u003ePOST\u003c/code\u003e request, which categorizes errors into \u003ccode\u003eerrorCategory\u003c/code\u003e, \u003ccode\u003eerrorReason\u003c/code\u003e, and \u003ccode\u003eerrorMessage\u003c/code\u003e properties.\u003c/p\u003e\n"],["\u003cp\u003eIf you encounter a "Read access to project" error when creating a Cloud Data Fusion instance, the solution is to disable and then re-enable the Cloud Data Fusion API before attempting to create the instance again.\u003c/p\u003e\n"]]],[],null,[]]
