diff --git a/docs/ui-ingestion.md b/docs/ui-ingestion.md index 521d8db26011c..b87841e661f05 100644 --- a/docs/ui-ingestion.md +++ b/docs/ui-ingestion.md @@ -283,17 +283,23 @@ Once cancelled, you can view the output of the ingestion run by clicking **Detai A variety of things can cause an ingestion run to fail. Common reasons for failure include: -1. **Recipe Misconfiguration**: A recipe has not provided the required or expected configurations for the ingestion source. You can refer +1. **Failures in Source or Sink**: If any failures are reported by the source or sink during the ingestion process, the pipeline can be marked as failed. + +2. **Uncaught Exceptions**: Uncaught exceptions during pipeline execution result in a failure status. + +3. **Commit Policy**: The commit policy affects pipeline status, particularly if errors or warnings prevent meeting commit policy requirements. + +4. **Recipe Misconfiguration**: A recipe has not provided the required or expected configurations for the ingestion source. You can refer to the [Metadata Ingestion Framework](https://datahubproject.io/docs/metadata-ingestion) source docs to learn more about the configurations required for your source type. -2. **Failure to resolve Secrets**: If DataHub is unable to find secrets that were referenced by your Recipe configuration, the ingestion run will fail. +5. **Failure to resolve Secrets**: If DataHub is unable to find secrets that were referenced by your Recipe configuration, the ingestion run will fail. Verify that the names of the secrets referenced in your recipe match those which have been created. -3. **Connectivity / Network Reachability**: If DataHub is unable to reach a data source, for example due to DNS resolution +6. **Connectivity / Network Reachability**: If DataHub is unable to reach a data source, for example due to DNS resolution failures, metadata ingestion will fail. Ensure that the network where DataHub is deployed has access to the data source which you are trying to reach. -4. **Authentication**: If you've enabled [Metadata Service Authentication](authentication/introducing-metadata-service-authentication.md), you'll need to provide a Personal Access Token +7. **Authentication**: If you've enabled [Metadata Service Authentication](authentication/introducing-metadata-service-authentication.md), you'll need to provide a Personal Access Token in your Recipe Configuration. To so this, set the 'token' field of the sink configuration to contain a Personal Access Token: