# Monte Carlo

{% hint style="info" %}
The Monte Carlo integration is in beta. Please reach out to <mark style="color:blue;"><support@getselectstar.com></mark> to get started.
{% endhint %}

The Monte Carlo integration helps surface data quality information into Select Star, the place most users go to find and discovery datasets and get more context. This integration helps spread awareness of data quality and guides decisions on what data to use.

The integration surfaces data quality information from Monte Carlo monitors directly on the tables themselves.

Note: only monitors that are enabled and active are shown. Any monitors that are disabled, snoozed, in training, have insufficient data, misconfigured or otherwise unable to run are not displayed.

<figure><img src="https://3470314135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MgAiVthA_yg9UXKuhyY%2Fuploads%2Fgit-blob-239219af0893cfe679c7c234cb828dc21a169b36%2Fimage.png?alt=media" alt=""><figcaption><p>Monte Carlo monitor status on the Select Star table page</p></figcaption></figure>

## Getting Connected

### 1. Generate an Account Service Key in Monte Carlo

To create an account-service API key for connecting to Monte Carlo:

1. In Monte Carlo, go to **Settings** in the top header.
2. In the left menu click **API** and then click **Account Service Keys** at the top.
3. From the *Account Service Keys* page, click **Create Key** and enter the following:
   1. In *Description*, add a useful description for your API key — i.e. `Select Star`.
   2. For the *Authorization Groups* dropdown, select **Editors (All)** to provide [minimum permissions](https://docs.getmontecarlo.com/docs/authorization#managed-roles-and-groups) for crawling Monte Carlo.
   3. For *Expires After*, keep the default selection or select a preferred option.
   4. Click **Create** to finish creating the account-service API key.
4. Copy the *Key ID* and *Secret* and store them securely.

### 2. Configure the Integration in Select Star

In Select Star, configure Monte Carlo as an **App** to set up the integration. Note - this must be done by an admin.

1. Click **your profile** in the top right, and go to **Settings**.
2. Go to **Admin > Apps** and on the Monte Carlo tile, click **Connect.**
3. Enter the **API Key** and **Secret** and click **Save**.

It will take a few minutes to ingest the monitor information from Monte Carlo.\\

### Integration Details

Once a day Select Star will ingest all monitors and latest statuses for any alerts. Select Star uses webhooks that will appear as **Audiences** within Monte Carlo to be able to get fast updates when an alert is created or status has changed.

Select Star maps the Monte Carlo Alert Status to a status for the Monitor, so you can quickly see where your data issues are.

| Monte Carlo Alert Status | Select Star Monitor Status |
| ------------------------ | -------------------------- |
| No Status                | ❌ Failed                   |
| Investigating            | ❌ Failed                   |
| Work in Progress         | ❌ Failed                   |
| Fixed                    | ✅ Passed                   |
| Expected                 | ✅ Passed                   |
| No Action Needed         | ✅ Passed                   |
| False Positive           | ✅ Passed                   |
