Troubleshooting

Alation Cloud Service Applies to Alation Cloud Service instances of Alation

Customer Managed Applies to customer-managed instances of Alation

For information about logs, refer to Troubleshoot OCF Connectors.

for help with troubleshooting common issues.

Problem	Cause	Solution
Metadata Extraction
Metadata extraction doesn’t extract columns of non-ephemeral models	NA	Select the Generate docs on run option in the Execution settings section in your dbt job. Alternatively, add the dbt docs generate command in your dbt job.
No metadata extracted after running MDE for a project or for multiple. projects	You haven’t executed your models in last the 90 days across environments.	Execute your models across environments to update the information and then run MDE.
Column names are not extracted for ephemeral models.	NA	It is a known limitation as dbt discovery APIs do not provide this information.
Lineage Extraction
Column-level lineage is not generated for non-ephemeral models	NA	Select the Generate docs on run option in the Execution settings section in your dbt job. Alternatively, add the dbt docs generate command in your dbt job.
No lineage generated for a specific project, environment, or model after running lineage extraction.	You haven’t executed your models in the last 90 days across environments.	Execute your models across environments to update the information and then run MDE.