How to Troubleshoot a Databasin Pipeline

This tutorial will guide you through the steps necessary to troubleshoot a pipeline in Databasin. By the end of this tutorial, you will be able to view logs and re-run pipelines or specific artifacts within Databasin.

Prerequisites

Before you start, ensure you have the following:

• Access to Databasin
• Basic understanding of pipeline and artifact concepts in Databasin

Viewing Logs

When a pipeline fails, the first step in troubleshooting is to examine the logs. These logs will help you understand what went wrong during the pipeline's execution.

Steps to View Pipeline Logs

1. Login to Databasin
   Begin by logging into your Databasin account.

2. Select the Project
   Navigate to the project where the pipeline is located.

3. Go to the Pipelines Page
   On the project’s page, select the pipeline from the list of pipelines.

4. Access the Logs
   Click the menu button in the top right corner and select View Logs.
   This will display a summary of the last pipeline run, showing key details and outcomes.

Steps to View Artifact Logs

To dive deeper, you may need to review logs specific to each artifact within the pipeline:

1. Login to Databasin
   Ensure you are logged into your Databasin account.

2. Select the Project
   Go to the project containing the pipeline.

3. Go to the Pipelines Page
   Find and select the pipeline that needs troubleshooting.

4. Select an Artifact
   Click on the specific artifact you want to examine.

5. View the Artifact Logs
   Click the View Logs button.
   A dialog box will appear, showing each step of the pipeline associated with the selected artifact.

Re-running the Pipeline

If you determine that the pipeline or certain artifacts need to be re-run after reviewing the logs, you can easily trigger a new run.

Steps to Re-run a Pipeline

1. Login to Databasin
   Start by logging into your Databasin account.

2. Select the Project
   Navigate to the relevant project.

3. Go to the Pipelines Page
   Select the pipeline you need to re-run from the list.

4. Trigger a New Run
   Click the menu button in the top right corner and select Trigger Run.

5. Configure the Run Options
   In the dialog that appears, choose the appropriate options (e.g., run all artifacts or just the failed ones).

6. Start the Pipeline Run
   Click the Trigger new pipeline run button.
   This action will schedule a new pipeline run with the specified parameters.