Stay organized with collectionsSave and categorize content based on your preferences.
This page shows you how to resolve issues with Cloud Data Fusion
Dataplex Universal Catalog asset lineage integrations.
Runtime errors
To find relevant logs for your data pipelines, go to your instance in the
Cloud Data Fusion web interface and clickSystem Admin>Management>Metadata Service.
The Data Lineage API isn't enabled or role isn't granted
The following issue occurs when the Data Lineage API hasn't been enabled in
the project or the Cloud Data Fusion service account hasn't been granted
the Data Lineage Events Producer role:
Error calling the metadata consumer data-catalog-consumer:
io.grpc.StatusRuntimeException: PERMISSION_DENIED: Data Lineage API has not been
used in project <project_id> before or it is disabled. Enable it by visiting
https://console.developers.google.com/apis/api/datalineage.googleapis.com/overview?project=<project_id>
then retry. If you enabled this API recently, wait a few minutes for the action
to propagate to our systems and retry.
To resolve this issue, enable the Data Lineage API and grant the Data
Lineage Events Producer role to the Cloud Data Fusion Service Agent. For
more information, seeView lineage in Dataplex Universal Catalog.
Pipeline runs in an unsupported Cloud Data Fusion version
The following issue occurs when the Cloud Data Fusion instance is upgraded
to a version greater than 6.8.0, but the pipeline hasn't been upgraded:
Error calling the metadata consumer data-catalog-consumer:
java.lang.IllegalArgumentException: FQN for the asset is null.
[[["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-09-04 UTC."],[[["\u003cp\u003eThis page provides solutions for resolving issues related to Cloud Data Fusion Dataplex asset lineage integrations.\u003c/p\u003e\n"],["\u003cp\u003eRuntime errors can be investigated through the Cloud Data Fusion web interface's Metadata Service logs.\u003c/p\u003e\n"],["\u003cp\u003eIssues arising from the Data Lineage API not being enabled or the service account lacking the necessary role can be fixed by enabling the API and granting the Data Lineage Events Producer role.\u003c/p\u003e\n"],["\u003cp\u003ePipelines running on Cloud Data Fusion versions above 6.8.0 may require upgrading to resolve lineage-related errors.\u003c/p\u003e\n"],["\u003cp\u003eA lack of messages in logs and missing lineage in Dataplex suggests that the pipeline may be using unsupported plugins, necessitating the use of plugins that support data lineage.\u003c/p\u003e\n"]]],[],null,["# Troubleshoot Dataplex Universal Catalog asset lineage integrations\n\nThis page shows you how to resolve issues with Cloud Data Fusion\nDataplex Universal Catalog asset lineage integrations.\n\nRuntime errors\n--------------\n\nTo find relevant logs for your data pipelines, go to your instance in the\nCloud Data Fusion web interface and click **System Admin** \\\u003e\n**Management** \\\u003e **Metadata Service**.\n\n### The Data Lineage API isn't enabled or role isn't granted\n\nThe following issue occurs when the Data Lineage API hasn't been enabled in\nthe project or the Cloud Data Fusion service account hasn't been granted\nthe Data Lineage Events Producer role: \n\n Error calling the metadata consumer data-catalog-consumer:\n io.grpc.StatusRuntimeException: PERMISSION_DENIED: Data Lineage API has not been\n used in project \u003cproject_id\u003e before or it is disabled. Enable it by visiting\n https://console.developers.google.com/apis/api/datalineage.googleapis.com/overview?project=\u003cproject_id\u003e\n then retry. If you enabled this API recently, wait a few minutes for the action\n to propagate to our systems and retry.\n\nTo resolve this issue, enable the Data Lineage API and grant the Data\nLineage Events Producer role to the Cloud Data Fusion Service Agent. For\nmore information, see [View lineage in Dataplex Universal Catalog](/data-fusion/docs/how-to/view-lineage-in-dataplex#before_you_begin).\n\n### Pipeline runs in an unsupported Cloud Data Fusion version\n\nThe following issue occurs when the Cloud Data Fusion instance is upgraded\nto a version greater than 6.8.0, but the pipeline hasn't been upgraded: \n\n Error calling the metadata consumer data-catalog-consumer:\n java.lang.IllegalArgumentException: FQN for the asset is null.\n\nTo resolve this issue, [upgrade the pipeline](/data-fusion/docs/how-to/upgrading)\nto the latest version.\n\n### No messages in logs and no lineage in Dataplex Universal Catalog\n\nThe following issue occurs when one of the plugins used in the pipeline doesn't\nsupport lineage egress to Dataplex Universal Catalog:\n\nThere aren't error or success messages in the logs and there's no lineage in\nDataplex Universal Catalog.\n\nTo resolve this issue, your pipeline must contain only the\n[plugins that support data lineage in Dataplex Universal Catalog](/data-fusion/docs/how-to/view-lineage-in-dataplex#supported_plugins)."]]
