# Integrate Spike.sh with Sentry

<figure><img src="https://1743514643-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ln3jS1bJTTsE3yoEcOu%2Fuploads%2Fgit-blob-0ffad9975d31598e36d36cc5fb6de14e9c14c7b7%2FSentry%20cover.png?alt=media" alt=""><figcaption></figcaption></figure>

[Sentry](https://github.com/spikehq/gitbook-docs/blob/main/integrations-guideline/https/sentry.io) is a powerful error monitoring and performance tracking platform designed for developers. It provides real-time insights into application issues, helping teams identify, troubleshoot, and resolve errors quickly. With detailed stack traces, performance metrics, and contextual data, Sentry ensures that you can proactively manage your application's health and deliver a seamless user experience.

## Overview

The Spike integration with Sentry bridges error monitoring and incident response. Connect Sentry to Spike to automatically trigger real-time incident alerts for critical errors.

You can setup Spike with Sentry in two ways.

1. Single-click install on Sentry
2. Connect with Spike webhook (*paste webhook on Sentry*)

### Integrating with multiple projects on Sentry

![Multiple projects on Sentry](https://1743514643-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ln3jS1bJTTsE3yoEcOu%2Fuploads%2Fgit-blob-f88dba45ffaae332b748d68ecce7e50910d75a54%2Fsentry-multiple-projects.png?alt=media)

To integrate multiple projects on Sentry with Spike, you will need to use both Spike app on Sentry and the webhook integration.

Consider you have services A,B, and C to integrate with Sentry.

**Service A**: Utilize Sentry's 1-click app for a streamlined integration. This is limited to a single project on Sentry.

**Services B, C and so on..**: Establish a webhook integration by creating it on [Spike](https://app.spike.sh/integrations/new) and subsequently configuring it in Sentry.

The 1-click app offers an effortless setup for one project, while the webhook integration allows for unrestricted application across multiple projects.

***

## How to set up?

To set up, you will need a Sentry integration on Spike no matter which way you choose. So please make sure you have created one on [Spike](https://github.com/spikehq/gitbook-docs/blob/main/integrations-guideline/https/app.spike.sh/integrations/README.md)

### 1. Single-click install on Sentry

{% tabs %}
{% tab title="Installation steps" %}

* **Install and connect**
  * On Sentry, go to settings > Integrations
  * Locate the Spike integration and click to begin setup.
  * Sentry will redirect you to Spike, where you can select an existing Sentry integration to connect with your Sentry account.
  * Choose your integration on Spike and complete the installation process.
* **Route alerts from Sentry**
  * Once the installation is verified, go to the Alerts section in Sentry and configure alert rules to start receiving alerts on Spike.
  * Add your conditions for alerts and in actions select **Send a notification via an integration and then Select Spike.**
    {% endtab %}

{% tab title="Installation with images" %}

* On Sentry, go to settings > Integrations and install our native Spike Integration

![Select Spike in your Sentry account](https://1743514643-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ln3jS1bJTTsE3yoEcOu%2Fuploads%2Fgit-blob-54c45fef32e34da40bbe239709a07469e5f67f19%2Fsentry-native-1.png?alt=media\&token=fd4fbb2a-a2f4-4544-8bd0-08da1ba0a6b1)

* Sentry will redirect you to Spike to select an existing Sentry integration that should be connected to your Sentry account.

![Select integration on Spike](https://1743514643-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ln3jS1bJTTsE3yoEcOu%2Fuploads%2Fgit-blob-fc2cf69cd4735df0d8a5c66df5b1ad21418d9d79%2Fselect%20integration%20on%20spike.png?alt=media)

* Once you have installed and the installation is verified, visit Alerts section in your Sentry account and click on **Create Alert rule.**

![Select alerts from sidebar](https://1743514643-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ln3jS1bJTTsE3yoEcOu%2Fuploads%2Fgit-blob-a628f024bd40e80df904ebf9b1829663a83762fd%2Fimage.png?alt=media\&token=ad73b5cd-4d58-4636-8b2a-bf3a1d642178)

* Add your conditions for alerts and in actions select **Send a notification via an integration and then Select Spike.** ![](https://1743514643-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ln3jS1bJTTsE3yoEcOu%2Fuploads%2Fgit-blob-f36e6bd2bca27873e0b1930e854ade62b6a54aaf%2Fimage.png?alt=media\&token=f5a30b3d-9398-45b4-ae72-246ab7bab535)
  {% endtab %}
  {% endtabs %}

* Test by generating a new error on Sentry.

***

### 2. Integrating with Sentry's webhook

{% tabs %}
{% tab title="Set up steps" %}

* **On Sentry**
  * On your Sentry account, navigate to Settings > Integrations and select Webhook.
  * Paste the webhook URL copied from Spike into the Webhook field in Sentry's integration settings.
  * Enable the plugin to activate the integration.
* **Configure alert rules**
  * Go to the Alerts section in the Sentry sidebar and select Create Alert Rule.
  * Define the conditions under which alerts should be triggered.
  * In the Actions section, select Send a notification via an integration and choose the Spike webhook integration.
    {% endtab %}

{% tab title="Set up with images" %}
**Step 1:** On [Sentry](https://sentry.io), go to settings > Integrations and **select Webhook**

![Webhooks on Sentry](https://1743514643-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ln3jS1bJTTsE3yoEcOu%2Fuploads%2Fgit-blob-9fa7f15c46311a494ec2658ea4f06083b9baba97%2Fsentry-webhook.png?alt=media\&token=488291d7-3dc0-4649-92fe-a670f23f78dc)

![Add to project](https://1743514643-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ln3jS1bJTTsE3yoEcOu%2Fuploads%2Fgit-blob-0b39216c8df5b47a9beba7a697fca51e0fd99028%2Fimage.png?alt=media\&token=1ef976f6-99e5-4629-a683-01c5b8ed6412)

Paste your copied webhook from Spike to Sentry's webhook integration.

![Paste Spike webhook on Sentry](https://1743514643-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ln3jS1bJTTsE3yoEcOu%2Fuploads%2Fgit-blob-027a9c9cdffb320c7bba8075fcf19c8b0bc8235f%2Fimage.png?alt=media\&token=80ca110b-c23d-4e70-b5d7-7183f73edd16)

{% hint style="warning" %}
Do not forget to **Enable** the plugin
{% endhint %}

**Step 2: Set up alerts**

Visit Sentry's new Alerts section from the sidebar and select **Create Alert Rule**

![](https://1743514643-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ln3jS1bJTTsE3yoEcOu%2Fuploads%2Fgit-blob-f36e6bd2bca27873e0b1930e854ade62b6a54aaf%2Fimage.png?alt=media\&token=f5a30b3d-9398-45b4-ae72-246ab7bab535)

Add your conditions for alerts and in actions select **Send a notification via an integration**

![Select notification via Integration for Webhook](https://1743514643-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ln3jS1bJTTsE3yoEcOu%2Fuploads%2Fgit-blob-41c1383e912c5fd91403a2ea6cf7153f4575edd5%2Fsentry-alert-2.png?alt=media\&token=731d207b-8d24-47e3-8a87-fb72942bb763)

This is how the end result might look

![Spike webook integration on Sentry](https://1743514643-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ln3jS1bJTTsE3yoEcOu%2Fuploads%2Fgit-blob-12cef9d5c387327bfd2321c5cdf6d5bf99025878%2Fimage%20\(39\)%20\(2\).png?alt=media\&token=2fbaf95a-803e-4144-8627-5509285e3fa4)
{% endtab %}
{% endtabs %}

* Test by generating a new error on Sentry.

### FAQs

<details>

<summary>Why create a Sentry integration on Spike?</summary>

Creating a Sentry integration on Spike allows you to group and suppress incidents effectively, ensuring better incident management.

</details>

<details>

<summary>Is there a limit on Sentry integrations?</summary>

**Single-click install**: Only one integration is allowed per Sentry account.

**Sentry webhook integration**: Unlimited integrations are supported.

</details>

<details>

<summary>Does resolving the incident on Spike resolve the error on Sentry?</summary>

No. Sorry, we currently don't support bi-directional integration with Sentry.

</details>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.spike.sh/integrations-guideline/integrate-spike-with-sentry.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
