Skip to main content

Set up Alteryx

Set up real-time integration between Alteryx and Atlan using OpenLineage. This integration automatically catalogs assets and creates lineage in Atlan whenever workflows run in Alteryx, providing immediate visibility into your ETL processes.

Prerequisites​

Before you begin, make sure you have:

  • Admin or Workflow Admin permissions in Atlan to create workflows and generate API tokens
  • Administrator access in Atlan to configure OpenLineage integrations
  • An API token for authentication
  • Alteryx Server version 2025.2 or later
  • Alteryx One Platform, the unified deployment of Alteryx Designer, Server, and Alteryx Analytics Cloud

Create workflow in Atlan​

To set up the Alteryx integration, you first need to create a workflow in Atlan that listens for OpenLineage events sent from Alteryx.

  1. In your Atlan workspace, click New in the top-right corner and select New workflow.

  2. From the filters at the top, select Orchestrator.

  3. From the list of available packages, select Alteryx.

  4. Click Create Listener to create a listener workflow that receives OpenLineage events from Alteryx.

Configure the connection​

To connect Alteryx with Atlan, you need to configure a connection that receives OpenLineage events from Alteryx. This connection enables Atlan to automatically capture and catalog Alteryx assets whenever workflows run.

Important

Each connection (namespace) must be linked to only one Alteryx instance. Using the same connection across multiple instances can cause environment variables to update incorrectly and lead to unexpected behavior.

  1. In your Atlan workspace, go to the Connections page.

  2. Click New connection and select Alteryx as the source.

  3. In the Connection Name field, enter a name that represents your environment, for example, production, development, or analytics.

  4. (Optional) Under Connection Admins, specify the users or groups who can manage this connection. If no user or group is specified, the connection can't be managed, not even by admins.

  5. Click Create connection to save and activate it.

Once configured, Atlan begins listening for OpenLineage events sent from Alteryx and automatically creates Alteryx assets and lineage when workflows run.

Configure the integration in Alteryx​

An Alteryx administrator configures Atlan's OpenLineage integration in Alteryx as follows:

  1. In Alteryx, navigate to Admin Console → Data Lineage Connection.

  2. Under Data Consumer, click Set up for an external data catalog.

  3. On the Data Catalog Setup page, select Atlan as the external catalog.

  4. In the OpenLineage Endpoint field, enter the full URL where Alteryx sends OpenLineage event data:

    https://<instanceName>.atlan.com/events/openlineage/alteryx/api/v1/lineage

  5. In the OpenLineage Namespace field, enter the connection name of your Alteryx connector in Atlan.

  6. Under Auth Method, select Bearer Token and enter your Atlan API token for authentication.

  7. Under Data Lineage Level, choose Dataset or Column. If you don't select Column, Atlan only receives dataset-level information and creates lineage at the asset level.

Once this configuration is saved, Alteryx begins sending OpenLineage events to Atlan automatically whenever workflows run.

Verify the connection​

After you configure the integration, verify that Atlan is successfully receiving OpenLineage events from Alteryx.

  1. In Alteryx, run a workflow to trigger OpenLineage events.

  2. In Atlan, open the configured connection and check for newly created Alteryx assets.

  3. Open an asset to confirm that lineage information from the Alteryx workflow appears in the asset view.

  4. (Optional) Go to View event logs in Atlan to review the OpenLineage events and verify successful ingestion.

Atlan validates the connection by ensuring the connection name matches and the API token is valid. Once the workflow runs in Alteryx, corresponding assets and lineage are automatically created and updated in Atlan.

Next steps​