Troubleshoot Runs¶
Use this guide when a pipeline does not behave as expected.
Start with the run summary¶
Check:
- overall run status
- failed node
- error message
- start and finish time
- generated artifacts
- published runtime values
Common issues¶
Credential failure¶
Symptoms:
- authentication error
- 401 or 403 response
- connection refused
- token expired
Actions:
- Re-test the credential.
- Confirm the credential is assigned to the correct organization.
- Confirm the correct environment is being used.
Expression did not resolve¶
Symptoms:
- URL still contains
{{value}} - field resolves to blank
- named value not available
Actions:
- Confirm the field supports expressions.
- Confirm the named value exists.
- Confirm the upstream node is connected by graph lineage.
- Confirm SQL scalar values return zero or one row.
Destination write failure¶
Symptoms:
- permission denied
- locked file
- constraint violation
- duplicate key
Actions:
- Confirm destination credentials.
- Review the transformed output.
- Check destination-specific logs.
- Re-run in test before production.