# Sentry.io

[<mark style="color:blue;">Sentry</mark>](https://sentry.io/) is a developer-first error tracking and performance monitoring platform that helps developers see what actually matters, solve quicker, and learn continuously about their applications.

Route detailed alerts from Sentry to the right users in Squadcast.

### Using Sentry 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 **Sentry.** Copy the displayed **Webhook URL** to [configure](#create-a-squadcast-callback-in-sentry) it within **Sentry**. 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-b12d3fd1bc82db30cf2c4ad87078bacbbc2548d1%2FSentry.png?alt=media)

{% hint style="warning" %} <mark style="color:orange;">**Important**</mark>**:**

When an alert source turns <mark style="color:green;">Active</mark>, 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 <mark style="color:green;">active</mark> if there is a recorded incident via that Alert Source for the Service.
{% endhint %}

### Create a Squadcast Callback in Sentry

1\. Now log in to your Sentry account and go to your **Project Settings**. Under the **Settings** tab, click **Integrations** and search for **Webhook**.

<figure><img src="https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-efb5e86035f50931062adddee2d0fc0e0f4c90e3%2FScreenshot%202022-12-20%20at%203.35.11%20PM.png?alt=media" alt=""><figcaption></figcaption></figure>

2\. Click on **Webhooks**. Click on **Add Project**, and select any project type.

<div><figure><img src="https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-c3453f0a8d8ded02933b174c00d4ab4eaa66feef%2FScreenshot%202022-12-20%20at%203.31.49%20PM.png?alt=media" alt=""><figcaption></figcaption></figure> <figure><img src="https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-f2b904b5786451de13fb4700c4d478607dd88cfe%2FScreenshot%202022-12-20%20at%203.32.13%20PM.png?alt=media" alt=""><figcaption></figcaption></figure></div>

3\. Under **Callback URLs**, paste the previously copied Squadcast Webhook URL.

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-38040db43b69ba2a656d4e548073a49569d4429d%2FScreenshot%202022-12-20%20at%203.33.04%20PM.png?alt=media)

4\. Under the **Alerts** section of the **Settings** tab

a. Click on **Create Alert**

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-b16f4c16789d0fddf4adc6557f8498d390aca034%2Fsentry_3.png?alt=media)

b. **Select Alert** and click on **Set Condition**

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-ccb098bd1f71262fb9f4425d97e1cdea06fb5298%2Fsentry_4.png?alt=media\&token=399ec441-6ef4-4e4c-8ae2-54174651781b)

c. Provide **Alert name**

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-49f8e8910fbcebd6927fbed62e39689ef166eac7%2Fsentry_5.png?alt=media)

d. Under the **Set Conditions** section choose Notification via **WebHooks**

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-994dc6f68f2855a0ea82d09ec93302fa610cc164%2Fsentry_6.png?alt=media)

When all of these conditions are met: An event is sent to Squadcast.

That's it! Your Sentry integration is now good to go.

### Steps to Integrate Squadcast with Custom Integration in Sentry for Performance/Metrics Tracking

Under the Settings tab, click on Custom Integrations and then click on Create New Integration.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcpwd58NQ1RBysP6-gEraVymyZzHbzraySLF4CQYaEiFF-WWXj0a8JrpYT-LAiOxf-CUoHLSdX3szLe0ehsi5VzZJhIBumWcTh6EwdsmLq7-JPHJOZvosAk_yGFz72sIWZXZKZB3Xpv9be4fUaPZn93jWSt?key=JmhVTAGM8CeL7Abnd4jgow" alt=""><figcaption></figcaption></figure>

Choose the integration type as Internal Integration and then click on Next.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeBF-M-0yUiwpmVsdWgNFgMIkhVtO6hBCQaHIUlRmWCAw1EdZe095maV0IvxZINansMh44ni8XoDDCZIBrXDWjHhgImAbWzjkYD5uFJ3tzWxaYqNJEUpR7mipTWVBOri_jtcD1p1pwMbw4TCDrSmsEEAz8M?key=JmhVTAGM8CeL7Abnd4jgow" alt=""><figcaption></figcaption></figure>

Give a meaningful name to your integration and then paste the Sentry Webhook URL copied from Squadcast. Important: Enable the Alert Rule Action toggle. Click on save.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcCo2hsv-wz3xnaKEL3FASewmZFlLSLKZx1x_n9Po0QLFIR1kqQJ0Q9CndxMChIgPDoh08m5sL4-mNg4ZKRvhrqKeN7SgdzEmyPSyISZC1OIOuh9pXkcemUibikCHoe3oFqK04DIUzsTtZn4i6Miwphv5zn?key=JmhVTAGM8CeL7Abnd4jgow" alt=""><figcaption></figcaption></figure>

Under the Alerts section of the settings tab, click on Create Alert. Select the alert from under the Performance metric and click on Set Conditions.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXe2KCBxgGv8hslHivrdH8zt3Mq2cDY---srs4WVOn9HJ_CxCXs54X_5H5KaVe1aZOoz7aKkJXT6gCVHHLu8BF_QM0uvBFHnz2StZt9wHp_Ffc80JQmf4VPSlKaYOJ1mCqci1J_NAQPxvVUr_74-hQA-az0R?key=JmhVTAGM8CeL7Abnd4jgow" alt=""><figcaption></figcaption></figure>

Under the Set Actions section, choose the custom integration created in the steps above. Click on Save Rule.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcQPdyO3nkoH2h41IphB1mqrgbsliuEeLWHOq3mffefxpzw4TMNP1xS6uCSlsG_rfKQWdxJq_JqMQTWKOKlYsKuQiW8oLATDm2OGN4YM3zvvYDrRpd80eGA-98A-LYhg8wEcui-6KucyqOvz8ZH4dKmcH7R?key=JmhVTAGM8CeL7Abnd4jgow" alt=""><figcaption></figcaption></figure>

When all of the defined conditions are met: An event is sent to Squadcast.

That's it! Your Sentry integration for metrics tracking is now good to go.

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