## Crawl Soda

URL: https://docs.atlan.com/apps/connectors/observability/soda/how-tos/crawl-soda

> Once you have [configured the Soda permissions](/apps/connectors/observability/soda/how-tos/set-up-soda), you can establish a connection between Atlan and Soda.

Once you have [configured the Soda permissions](https://docs.atlan.com/llms/connectors/soda/set-up-soda/llms.txt), you can establish a connection between Atlan and Soda.

To crawl metadata from Soda, review the [order of operations](https://docs.atlan.com/llms/catalog/connector-capabilities/order-workflows/llms.txt) and then complete the following steps.

## Select the source

To select Soda as your source:

1. In your Atlan workspace, click **Connectors** in the left sidebar.
 * If you are using the **Old UI (Classic)**, click **New Workflow** in the top navigation.

2. Click **Marketplace**.

3. Search for **Soda** and select it.

4. Click **Install**.

5. Once installation completes, click **Setup Workflow** on the same tile.

## Provide your credentials

To enter your Soda credentials:

1. For _Host Name_, enter the hostname or base URL of your Soda instance to connect to the Soda APIs - for example, [cloud.soda.io](https://cloud.soda.io), [cloud.us.soda.io](https://cloud.us.soda.io), or [demo.soda.io](https://demo.soda.io).

2. For _Authentication_, _API Key Authentication_ is the default selection.

3. For _API Key ID_, enter the [API key ID you copied](https://docs.atlan.com/llms/connectors/soda/set-up-soda/llms.txt).

4. For _API Secret_, enter the [API secret you copied](https://docs.atlan.com/llms/connectors/soda/set-up-soda/llms.txt).

5. Click the **Test Authentication** button to confirm connectivity to Soda.

6. Once authentication is successful, navigate to the bottom of the screen and click **Next**.

## Configure the connection

To complete the Soda connection configuration:

1. Provide a _Connection Name_ that represents your source environment. For example, you might use values like `production`,`development`,`gold`, or `analytics`.

2. (Optional) To change the users who are able to manage this connection, change the users or groups listed under _Connection Admins_.

 :::warning
 If you do not specify any user or group, no one will be able to manage the connection - not even admins.
 :::
3. Navigate to the bottom of the screen and click **Next** to proceed.

## Configure the crawler

Before running the Soda crawler, you can further configure it.
1. On the _Metadata_ page, you can override the defaults for any of these options:
 - To select the assets you want to include in crawling, click the **Include filter**. (This will default to all assets, if none are specified.)
 - To select the assets you want to exclude from crawling, click the **Exclude filter**. (This will default to no assets, if none specified.)
2. (Optional) For _Advanced Config_, keep _Default_ for the default configuration or click **Custom** to configure the enrichment:
 - To map Soda metadata enrichment to assets from specific connections only, for _Include Connections_, specify the connections in Atlan, or leave it blank to include all connections. If you have specified any connections, Atlan will map [Soda checks](https://docs.atlan.com/llms/connectors/soda/what-does-atlan-crawl-from-soda/llms.txt) only to the assets included in those connections.

:::info **Did you know?** 
 If an asset appears in both the include and exclude filters, the exclude filter takes precedence.
:::

## Run the crawler

To run the Soda crawler, after completing the steps above:

1. To check for any [permissions or other configuration issues](https://docs.atlan.com/llms/connectors/soda/preflight-checks-for-soda/llms.txt) before running the crawler, click **Preflight checks**.

2. You can either:
 - To run the crawler once immediately, at the bottom of the screen, click the **Run** button.
 - To schedule the crawler to run hourly, daily, weekly, or monthly, at the bottom of the screen, click the **Schedule Run** button.
Once the crawler has completed running, you will see the assets on Atlan's asset page! 🎉

---