## Crawl Monte Carlo

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

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

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

To crawl metadata from Monte Carlo, 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 Monte Carlo 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 **Monte Carlo** and select it.

4. Click **Install**.

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

## Provide your credentials

To enter your Monte Carlo credentials:

1. For _Authentication_, **API Key Authentication** is the default selection.

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

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

4. Click the **Test Authentication** button to confirm connectivity to Monte Carlo.

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

## Configure the connection

To complete the Monte Carlo 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 Monte Carlo crawler, you can further configure it.

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.)
- To enable crawling assets with specific [incident statuses](https://docs.getmontecarlo.com/docs/interacting-with-incidents), click **Include Incident Statuses** and select the relevant option(s). To include unresolved incidents by default, we recommend selecting the **No Status** and **Acknowledged** filters. (This will default to all incident statuses, if none are specified.)
- For _Incidents and Alerts time range_, specify a date range for which you want to crawl alerts and incidents from Monte Carlo. The default date range is set to the last 30 days, you can either keep the default selection or change to the last 14 or 45 days.
- (Optional) For _Advanced Config_, keep _Default_ for the default configuration or click **Custom** to configure the enrichment:
 - To map Monte Carlo 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 monitors, alerts, and incidents 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 Monte Carlo crawler, after completing the steps above:

1. To check for any [permissions or other configuration issues](https://docs.atlan.com/llms/connectors/monte-carlo/preflight-checks-for-monte-carlo/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! 🎉

---