Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Nesta página, você verá como resolver problemas com o Cloud Data Fusion.
Extrair informações de erro de uma execução de pipeline com falha
Quando uma execução de pipeline falha, é possível recuperar informações detalhadas sobre o erro.
O Cloud Data Fusion 6.11.0 classifica os erros do pipeline por categoria, motivo e mensagem. Essa classificação acelera a resolução e reduz a
necessidade de examinar registros complexos.
Para conferir os detalhes do erro, siga estas etapas:
Console
No Google Cloud console, abra sua instância do Cloud Data Fusion e acesse o pipeline na página Studio.
No nó em que o erro ocorreu, clique em Ver erros.
Revise os detalhes do erro, que incluem a categoria, o motivo e a mensagem.
Opcional: para fazer o download de registros brutos para análise posterior, clique em
Fazer o download de registros brutos.
Opcional: para conferir os registros brutos, clique em Visualizar registros.
REST
Envie uma solicitação POST para o seguinte endpoint:
Confira a seguir um exemplo de resposta para um erro de plug-in:
[
{
"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).
Resolver problemas com a criação de instâncias do Cloud Data Fusion
Ao criar uma instância do Cloud Data Fusion, você pode encontrar o seguinte problema:
Read access to project PROJECT_ID was denied.
Para resolver esse problema, desative e reative a
API Cloud Data Fusion e
crie a instância.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-12 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,["# Troubleshoot Cloud Data Fusion\n\nThis page shows you how to resolve issues with Cloud Data Fusion.\n\nRetrieve error information for a failed pipeline run\n----------------------------------------------------\n\nWhen a pipeline run fails, you can retrieve detailed error information.\nCloud Data Fusion 6.11.0 classifies pipeline errors by category,\nreason, and message. This classification speeds up resolution and reduces the\nneed to examine complex logs.\n\nTo get error details, follow these steps: \n\n### Console\n\n1. In the Google Cloud console, open your Cloud Data Fusion\n instance and go to your pipeline on the **Studio** page.\n\n2. On the node where the error occurred, click **View errors**.\n\n3. Review the error details, which include the error category, error reason,\n and error message.\n\n4. Optional: To download raw logs for further analysis, click\n **Download raw logs**.\n\n5. Optional: To view raw logs, click **View logs**.\n\n### REST\n\nSend a `POST` request to the following endpoint: \n\n curl -H \"Authorization: Bearer $(gcloud auth print-access-token)\"\n -H \"Content-Type: application/json\" \n ${CDAP_ENDPOINT}/v3/namespaces/\u003cvar translate=\"no\"\u003eNAMESPACE_ID\u003c/var\u003e/apps/\u003cvar translate=\"no\"\u003ePIPELINE_NAME\u003c/var\u003e/workflows/DataPipelineWorkflow/runs/\u003cvar translate=\"no\"\u003eRUN_ID\u003c/var\u003e/classify -X POST\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003eNAMESPACE_ID\u003c/var\u003e: the ID of the namespace\n- \u003cvar translate=\"no\"\u003ePIPELINE_NAME\u003c/var\u003e: the name of the pipeline\n- \u003cvar translate=\"no\"\u003eRUN_ID\u003c/var\u003e: the run ID of the pipeline\n\nThe following is a sample response for a plugin error: \n\n [\n {\n \"stageName\": \"Stage Name\",\n \"errorCategory\": \"Plugin-x\",\n \"errorReason\": \"Input path gs://x does not exist\",\n \"errorMessage\": \"Input path gs://x does not exist\",\n \"errorType\": \"SYSTEM/USER/UNKNOWN\",\n \"dependency\": \"true/false\"\n }\n ]\n ```\n You can also [view advanced logs for your pipelines](/data-fusion/docs/how-to/viewing-stackdriver-logs).\n\nResolve issues with creating Cloud Data Fusion instance\n-------------------------------------------------------\n\nWhen you create a Cloud Data Fusion instance, you might encounter the\nfollowing issue: \n\n Read access to project \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e was denied.\n\nTo resolve this issue, disable and re-enable the\n[Cloud Data Fusion API](/data-fusion/docs/how-to/enable-service), and\nthen create the instance."]]
