Skip to content

Using Maia for root cause analysis

When a pipeline fails in the Data Productivity Cloud, identifying the exact cause can be time-consuming. Maia simplifies this by providing intelligent, context-aware diagnostics. Maia can also recommend fixes to help you get your pipelines running again.

This guide walks you through how to use Maia to troubleshoot failed pipeline runs directly in the Data Productivity Cloud.


Where to start

  1. Log in to the Data Productivity Cloud.
  2. Click the Activity icon to open the Activity menu.
  3. Click Pipeline Runs.

From here you can view a list of recent pipeline executions, along with their status (Success or Failed).

Pipeline runs activity


Troubleshooting failed pipelines with Maia

To analyze the root cause of a failure:

  1. Click on any pipeline that has a Failed status. You'll be taken to the Pipeline run details page.
  2. At the top of the page, you’ll see the Troubleshoot with Maia banner.

Maia automatically analyzes the error, summarizes the issue, and suggests recommended fixes.


Example: SQL compilation error

In this example, a user encountered a SQL compilation error caused by incorrect usage of a variable in a Snowflake query. Maia is able to:

  • Identify the exact line where the syntax error occurred.
  • Highlight the type of issue (e.g., variable name, size limit, or data mismatch).
  • Suggest an appropriate fix.

Troubleshoot with Maia