## Monitor workflow runs

URL: https://docs.atlan.com/product/connections/how-tos/monitor-connectivity

> Monitor your data connection workflows and identify failures for troubleshooting.

Monitor your data connection workflows to track progress, verify successful execution, and identify any failures that need attention.

## Prerequisites

Before you begin, make sure you have:
* Access to the Workflow center in Atlan
* At least one configured data connection
* Appropriate permissions to view workflow runs

## View workflow runs

Monitor your workflow runs in real-time or review historical executions.

1. Navigate to the workflow monitoring page:
 * **During execution**: You're automatically redirected within 5 seconds
 * **Any other time**: Click **Connectors** from the left menu.
 * If you are using the **Old UI (Classic)**, from the left menu, click **Workflows**.

2. Find your specific workflow run:
 * Use the date filter (defaults to last 24 hours)
 * Filter by status (Running, Success, Failed)
 * Search by workflow name or connector type

3. Click the workflow run to open the monitoring view.

## Review workflow execution

The monitoring interface depends on your connector type. Standard connectors (Snowflake, BigQuery, Databricks) provide enhanced monitoring with AI features, while custom connectors use DAG-based visualization.

### Standard connectors

1. View the process graph showing **Setup → Extract → Transform → Publish** steps.
2. Hover over each step to see:
 * Start and finish times
 * Elapsed duration
 * Total assets extracted, transformed, updated, and archived
3. Toggle between **Hour** and **Day** views using the graph toggle.
4. Check the **Summary** tab on the left for:
 * Current workflow status
 * Overall start and finish times
 * Total elapsed time
 * Trigger information (who triggered it and how)

### Custom connectors

1. Review the DAG (directed acyclic graph) visualization showing individual tasks.
2. Check the **Summary** tab on the left for:
 * Current workflow status
 * Start and finish times
 * Elapsed duration
 * Trigger information (manually or automatically)
3. Click individual task nodes to see:
 * Task dependencies
 * Execution order
 * Current state (pending, running, complete, failed)

## Identify failures

Atlan makes it simple to understand and resolve issues when a workflow fails.

1. Open the failed workflow run.
2. Click **View Failed tasks** in the Summary tab.
3. Navigate to the **Failed Tasks** tab to review specific failures.

### Standard connectors

When a workflow fails, you get:

* **Failure visualization**: The exact step where the error occurred is highlighted
* **AI-analyzed errors**: Complex system errors translated into clear, human-friendly explanations
* **Guided troubleshooting**: Step-by-step AI suggestions to resolve issues faster
* **Proactive recommendations**: Early flagging of possible misconfigurations or permission issues

If AI workflow analysis encounters an error, you can retry the analysis or reach out to Atlan Support.

### Custom connectors

* Locate failed nodes in the DAG visualization
* Check the **Message** field for each failed task for error details
* Review task dependencies to identify cascading failures
* Analyze error patterns across multiple failed tasks

## Access error logs

View detailed logs for troubleshooting workflow failures.

### Standard connectors

1. Click **View Error Log** to see detailed logs for the failed run.
2. Logs are displayed directly in the workflow monitoring view for quick access.
3. If unable to resolve, click **Contact Atlan Support** to raise a ticket directly from the interface.

### Custom connectors

1. Click the failed task (activity node) in the DAG visualization.
2. Click the **Logs** button to the right of each failed step.
3. Review the log output if available.

Not every failed activity produces a log. Check the Message field for error details when logs aren't available.

## See also

* [Workflow health](https://docs.atlan.com/llms/catalog/connector-capabilities/workflow-center/llms.txt): How Atlan flags workflows that keep failing and autopauses chronic failures
* [Manage connectivity](https://docs.atlan.com/llms/catalog/connector-capabilities/manage-connectivity/llms.txt): Modify workflow configuration and settings
* [Workflow FAQ](https://docs.atlan.com/llms/catalog/connector-capabilities/odbc-jdbc-driver/llms.txt): Common workflow troubleshooting questions

---