# Runscope

Follow the steps below to configure a service so as to extract its related alert data from Runscope.

Squadcast will then process this information to create incidents for this service as per your preferences.

### Using Runscope as an Alert Source

1. Navigate to **Services** -> **Service Overview** -> select or search for your Service. Expand the accordion -> In the Alert Sources section, click **Add**.

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-4fbd74e7ca0b30173c47a1d58ed6a0804a0465aa%2FAlert_Sources.png?alt=media\&token=aaca6610-9d18-4dd4-9cf5-320042f326f1)

2\. Select **Runscope.** Copy the displayed **Webhook URL** to [configure](#in-runscope) it within **Runscope**. Finish by clicking **Add Alert Source** -> **Done.**

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-76f6332d8bae0d782ead79e327da74dad6962b0c%2FRunscope.png?alt=media\&token=a1ddbc69-3749-4233-9bae-3d357c455960)

{% hint style="warning" %}
**Important:**

When an alert source turns Active, it’ll show up under Configured Alert Sources, you can either generate a test alert from the integration or wait for a real-time alert to be generated by the Alert Source. An Alert Source is active if there is a recorded incident via that Alert Source for the Service.
{% endhint %}

### In Runscope:

Now login to you Runscope dashboard and click on the Runscope icon at the top right corner and select **Connected Services** from the resulting options.

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-9a68831abb19d0e58bbe7ccd1b2241f20c0f5e46%2Frunscope_2.png?alt=media\&token=7a9119f4-2508-42d5-98be-4e077abe8f36)

In the list of options available, scroll to **Webhooks** and click **Connect**.

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-d1ce1ede677ac56ee8033d9c73d318586046b8f3%2Frunscope_3.png?alt=media\&token=d164bdfa-8b6b-424f-92d9-50454289ceaf)

In the Advanced Webhooks window, Enter a Description such as **Squadcast Incidents** and select the Threshold as per your requirement.

For best results, select **Notify after a test fails in location atleast 1 times(s)** and enable the checkbox labeled **and again after a test returns to passing**. This will help Squadcast **Auto-Resolve** an Incident once the parameters are back to normal.

Then paste the webhook url for the Runscope service and click **Save Changes**.

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-3c2cb1c21b4f5ab87ae4b3c84a960ad555a4dced%2Frunscope_4.png?alt=media\&token=217176ca-4679-4c4c-9fc9-8e280bde9c03)

Click **Edit** on the test needs to be integrated with Squadcast and click on **Test Settings**.

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-2b908f9c10549bd9fdf285fe75175a7e7786ba7a%2Frunscope_5.png?alt=media\&token=a0036bc6-ab57-4ec5-837a-1fe35156037d)

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-209c606700c4d3f2cf460b899b745ce3d326c183%2Frunscope_6.png?alt=media\&token=41b855e5-f545-498c-ac1d-fcabfce2b829)

In the **Test Settings**, go to **Integrations** and Toggle on the switch near to Squadcast Incidents webhook.

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-b76947de567629e4c0c8f5aa593a736699e18033%2Frunscope_7.png?alt=media\&token=48fc128b-a001-4fa3-a5f2-d0a025a994db)

The Runscope integration is good to go and if there are any failed tests, it will automatically trigger an incident in Squadcast and if the test passes again, the incident will get **Auto-Resolved** in Squadcast.

*Have any questions?* [*Ask the community*](https://community.squadcast.com/view/home)*.*