Once you have configured the Anomalo settings, you can establish a connection between Atlan and Anomalo.
To integrate Anomalo with Atlan, review the order of operations and then complete the following steps.
Create an API token in Atlan
Before running the workflow, you will need to create an API token in Atlan.
Configure the integration in Atlan
Select the source
To select Anomalo as your source, from within Atlan:
- In the top right of any screen, click New and then click New workflow.
- From the list of packages, select Anomalo Assets and then click Setup Workflow.
Create the connection
You will only need to create a connection once to enable Atlan to receive incoming webhook events from Anomalo. Once you have set up the connection, you neither have to rerun the workflow nor schedule it. Atlan will process the Anomalo events as and when your checks run in Anomalo to catalog your check metadata.
To configure the Anomalo connection, from within Atlan:
- For Connection Name, provide a connection name that represents your source environment. For example, you might use values like
production
,development
,gold
, oranalytics
. - (Optional) To change the users who are able to manage this connection, change the users or groups listed under Connection Admins.
🚨 Careful! If you do not specify any user or group, no one will be able to manage the connection — not even admins.
- For Host Name, enter the URL of your Anomalo instance.
- For API Key, enter the API key you copied in Anomalo.
- Click the Test Authentication button to confirm connectivity to Anomalo.
- Once authentication is successful, navigate to the bottom of the screen and click Next.
Configure the connection
On the Metadata page, you can override the defaults for any of these options:
- To select the warehouses you want to include in crawling, click Include warehouses. (This will default to all warehouses, if none are specified.)
- To select the warehouses you want to exclude from crawling, click Exclude warehouses. (This will default to no warehouses, if none are specified.)
- To check for any permissions or other configuration issues before running the crawler, click Preflight checks.
- Navigate to the bottom of the screen and click Next.
Configure a webhook in Anomalo
To configure a webhook in Anomalo:
- For Configure Anomalo to send webhook events to this URL, you can either:
- Click the clipboard icon to copy the JSON string and use it to configure a webhook in your Anomalo instance. Replace
<API_KEY>
with the API token you generated in Atlan. - If you have already configured the webhook while setting up Anomalo, you can skip this step.
- Click the clipboard icon to copy the JSON string and use it to configure a webhook in your Anomalo instance. Replace
- To run the crawler, at the bottom of the screen, click the Run button.
Once you have integrated Anomalo and your checks have completed running in Anomalo, Atlan will start receiving and processing webhook events from Anomalo. You will see your Anomalo checks cataloged in Atlan! 🎉
Note that Atlan does not fetch any historical check metadata. As new events are received from Anomalo, Atlan will process these events and catalog your Anomalo checks.