You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/product/alerts/alert-types.mdx
+14-2Lines changed: 14 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,13 +1,14 @@
1
1
---
2
2
title: Alert Types
3
3
sidebar_order: 10
4
-
description: "Learn about the two types of alerts Sentry provides: issue alertsand metric alerts."
4
+
description: "Learn about the three types of alerts Sentry provides: issue alerts, metric alerts, and uptime monitoring alerts."
5
5
---
6
6
7
-
You can create two types of alerts:
7
+
You can create three types of alerts:
8
8
9
9
1.**Issue alerts**: Trigger when an issue matches a specific criteria.
10
10
2.**Metric alerts**: Trigger when macro-level metrics cross specific thresholds.
11
+
3.**Uptime alerts**: Trigger when an HTTP request doesn't return a successful response.
11
12
12
13
## Issue Alerts
13
14
@@ -112,3 +113,14 @@ The **Alert Details** page shows you the history of a metric alert rule for the
112
113
113
114
114
115
The **Alert Details** page also includes a list of suspect issues or transactions related to the metric, to help pinpoint the root problem more quickly. You can see what might have caused the alert to be triggered, and then open the metric in **[Discover](/product/explore/discover-queries)** to find more information.
116
+
117
+
## Uptime Alerts
118
+
119
+
<Includename="feature-stage-beta-uptime.mdx" />
120
+
121
+
Uptime alerts trigger whenever an uptime check request fails to meet our [uptime check criteria](/product/alerts/uptime-monitoring/#uptime-check-criteria). You'll be able to see the latest uptime check request status ("Up" or "Down") in the “Alert Rules” tab.
122
+
123
+
124
+
### Alert Details Page
125
+
126
+
The **Alert Details** page shows a list of uptime issues that were created by the alert. Clicking on any of the issues will take you to a page with additional information that may help you debug that issue.
Copy file name to clipboardExpand all lines: docs/product/alerts/create-alerts/index.mdx
+3-2Lines changed: 3 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -13,13 +13,14 @@ The minimum role required to create alerts is member. Sentry users with manager
13
13
To create alerts:
14
14
15
15
1. Navigate to **Alerts** and click "Create Alert Rule".
16
-
1. Choose what you want to be alerted about. Selecting “Issues” creates an [issue alert](/product/alerts/alert-types/#issue-alerts), while selecting any other option creates a [metric alert](/product/alerts/alert-types/#metric-alerts).
16
+
1. Choose what you want to be alerted about. Selecting “Issues” creates an [issue alert](/product/alerts/alert-types/#issue-alerts), selecting “Uptime Monitor” creates an [uptime alert](/product/alerts/alert-types/#uptime-alerts), while selecting any other option creates a [metric alert](/product/alerts/alert-types/#metric-alerts).
17
17
18
18
19
19
1. Click "Set Conditions".
20
20
1. On the alert configuration page, set the conditions of the alert:
@@ -30,4 +31,4 @@ You can also create an alert by duplicating an existing issue or metric alert ru
30
31
## Alert Limits
31
32
32
33
[Issue alerts](/product/alerts/alert-types/#issue-alerts) are limited to 100 alerts with "slow" conditions, and 500 alerts with "fast" conditions.
33
-
A "slow" condition is a [change](/product/alerts/create-alerts/issue-alert-config/#change-alerts) or [percent based](/product/alerts/create-alerts/issue-alert-config/#percent-based-alerts) alert. These take more processing time than the "fast" conditions, which are related to issue state changes.
34
+
A "slow" condition is a [change](/product/alerts/create-alerts/issue-alert-config/#change-alerts) or [percent based](/product/alerts/create-alerts/issue-alert-config/#percent-based-alerts) alert. These take more processing time than the "fast" conditions, which are related to issue state changes.[Uptime alerts](/product/alerts/alert-types/#uptime-alerts) are limited to 100 alerts.
description: "Learn more about the options for configuring an uptime alert."
5
+
---
6
+
7
+
<Includename="feature-stage-beta-uptime.mdx" />
8
+
9
+
Sentry provides several configuration options for creating an uptime alert based on your organization's needs as explained below.
10
+
11
+
## 1. Environment
12
+
13
+
First, specify which <PlatformLinkto="/configuration/environments/">environment</PlatformLink> this alert rule belongs to. Any [uptime issues](/product/issues/issue-details/uptime-issues/) that will be created from this alert rule will then be set to your specified environment.
14
+
15
+
You'll notice that the “Environment” dropdown list you see here shows the same environments as the “Environment” dropdown in your project (not including hidden environments).
16
+
17
+
## 2. Project
18
+
19
+
Specify which project your alert rule belongs to so that any [uptime issues](/product/issues/issue-details/uptime-issues/) you create will show up for that specific project.
20
+
21
+
## 3. Request Configuration
22
+
23
+
Configure how Sentry should execute an HTTP uptime check, by specifying:
24
+
25
+
-**URL**: The URL for which Sentry should execute an uptime check request.
26
+
-**Method**: The request method used to execute the uptime check. Available options are `GET`, `POST`, `HEAD`, `PUT`, `DELETE`, `PATCH`, and `OPTIONS`.
27
+
-**Headers**: The request headers included in the uptime check request.
28
+
-**Body**: The body message to include in the uptime check request. (This is only available when the method is set to `POST`, `PUT`, and `PATCH`.)
29
+
30
+
Make sure to include a `Content-Type` header in your headers configuration in case the specified URL requires it. For example, a JSON message body would have a `Content-Type` header of `application/json`.
31
+
32
+
<Alertlevel="warning">
33
+
34
+
If the specified URL is behind a firewall, make sure Sentry's Uptime Bot can execute requests to it. [Learn more](/product/alerts/uptime-monitoring/troubleshooting/#verify-firewall-configuration).
35
+
36
+
</Alert>
37
+
38
+
## 4. Alert Name
39
+
40
+
Give your alert a descriptive name, for example, "Landing Page" or "Contact Page".
41
+
42
+
## 5. Ownership
43
+
44
+
Lastly, choose a team to associate with your alert so that members of that team are able to edit the alert if they want to. Note, that you can only add teams that you're a member of. If no team is assigned, anyone will be able to edit the alert.
Copy file name to clipboardExpand all lines: docs/product/alerts/uptime-monitoring/automatic-detection.mdx
+8-14Lines changed: 8 additions & 14 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,25 +4,23 @@ sidebar_order: 51
4
4
description: "Learn how automatic detection of uptime monitoring works."
5
5
---
6
6
7
-
<Includename="feature-stage-alpha-uptime.mdx" />
7
+
<Includename="feature-stage-beta-uptime.mdx" />
8
8
9
-
The automatic detection of uptime alerts sets up uptime alerts for the most frequently encountered
10
-
hostnames in all URLs of your error data. This helps ensure that critical hostnames are continuously monitored,
11
-
enhancing the reliability and availability of your web services.
9
+
In order to be able to automatically detect uptime alerts, we analyze all the URLs detected in your project's captured error data to find the hostname that appears most frequently. This helps ensure that your most critical hostname is continuously monitored, enhancing the reliability and availability of your web services. We then create an uptime alert if it passes our [uptime check criteria](/product/alerts/uptime-monitoring/#uptime-check-criteria). Automatic uptime checks are configured to run once a minute as GET requests.
12
10
13
-
## How It Works
14
11
15
-
We analyze all the URLs detected in your project's captured error data to find the hostname that appears most frequently. We then create an uptime alert if it passes our [uptime check criteria](/product/alerts/uptime-monitoring/#uptime-check-criteria).
16
12
17
-
To avoid creating flaky alerts, the hostname undergoes an "onboarding period" of three days. During this period, we send HTTP requests to the hostname every hour. If the request fails at least three times, the hostname is dropped and re-evaluated after seven days.
13
+
To avoid creating flaky alerts, the hostname undergoes an "onboarding period" of three days. During this period, we send HTTP requests to the hostname every hour. If the request fails three times or more, the hostname will be dropped and re-evaluated after seven days.
18
14
19
15
<Alertlevel="info">
20
-
Sentry will execute uptime checks against the hostname root path of the most frequentlyseen URLs. For example, if the most seen URL in your events is `GET https://www.example.com/docs/introduction` the check will be `GET https://www.example.com/`.
16
+
Sentry will execute uptime checks against the hostname root path of the most frequently-seen URLs. For example, if the most frequently-seen URL in your events is `GET https://www.example.com/docs/introduction`, the check will be `GET https://www.example.com/`.
21
17
</Alert>
22
18
19
+
Once an automatically detected uptime alert has been created, you'll be able to [customize its configuration](/product/alerts/create-alerts/uptime-alert-config/), including the HTTP request method, headers, and request body.
20
+
23
21
## Disabling Automatic Detection
24
22
25
-
If you prefer not to use automatically detected uptime alerts, you have two options to disable them:
23
+
If you prefer not to use automatically detected uptime alerts, you have two options for disabling them:
26
24
27
25
1.**Deleting Uptime Alerts:** You can directly delete existing automatically detected uptime alerts from your [Alerts page](https://sentry.io/orgredirect/organizations/:orgslug/alerts/rules). Once deleted, these alerts will not be re-created automatically in the future.
28
26
2.**Blocking Sentry via `robots.txt`:** Another method to prevent automatic detection is by updating your hostname's robots.txt file to block Sentry’s uptime monitoring bot. To do this, add the following lines to your robots.txt file:
@@ -33,9 +31,5 @@ Disallow: *
33
31
```
34
32
35
33
<Alertlevel="warning">
36
-
**Note:** The `robots.txt` file will only prevent Sentry from detecting URLs that it encounters in the future. Existing URLs that have already been detected will continue to have uptime alerts unless they are manually deleted.
34
+
**Note:** The `robots.txt` file only prevents Sentry from detecting URLs that it encounters after its been implemented. Existing URLs that have already been detected will continue to have uptime alerts unless they're manually deleted.
37
35
</Alert>
38
-
39
-
## Current Limitations
40
-
41
-
At present, automatically detected uptime alerts have limited editability. You cannot update the URLs associated with these alerts. Only the alert name and owner can be modified. The ability to edit URLs and other alert settings is planned for a future release. Additionally, each organization is limited to one automatically detected hostname.
Copy file name to clipboardExpand all lines: docs/product/alerts/uptime-monitoring/index.mdx
+17-12Lines changed: 17 additions & 12 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,31 +4,36 @@ sidebar_order: 50
4
4
description: "Learn how to help maintain uptime for your web services by monitoring relevant URLs with Sentry's Uptime Monitoring."
5
5
---
6
6
7
-
<Includename="feature-stage-alpha-uptime.mdx" />
7
+
<Includename="feature-stage-beta-uptime.mdx" />
8
8
9
-
Sentry's Uptime Monitoring lets you monitor the availability and reliability of your web services effortlessly.
10
-
In the current version, uptime is [automatically configured](/product/alerts/uptime-monitoring/automatic-detection/) as a new alert for only the most relevant URL detected in your organization. In future updates, you'll have the flexibility to add and monitor additional URLs.
9
+
Sentry's Uptime Monitoring lets you monitor the availability and reliability of your web services effortlessly. Once enabled, it continuously tracks configured URLs, delivering instant alerts and insights to quickly identify downtime and troubleshoot issues.
10
+
11
+
By leveraging [distributed tracing](/concepts/key-terms/tracing/distributed-tracing/), Sentry enables you to pinpoint any errors that occur during an uptime check, simplifying triage and accelerating root cause analysis. This helps you enhance both the reliability and uptime of your web services.
12
+
13
+
## Set Up
14
+
15
+
Uptime is [automatically configured](/product/alerts/uptime-monitoring/automatic-detection/) as a new alert for the most frequently encountered hostname in all URLs of your error data, ensuring continuous monitoring of your most critical hostname right out of the box.
16
+
17
+
You can also [create uptime monitoring alerts](/product/alerts/create-alerts/) for specific URLs. They're fully customizable with request details such as the HTTP method, headers, and body.
11
18
12
19
## Uptime Check Criteria
13
20
14
-
Our uptime monitoring system verifies the availability of your URLs
15
-
by performing GET requests at regular 5-minute intervals.
16
-
For a URL to be considered up and running, the response must meet the following criteria:
21
+
Our uptime monitoring system verifies the availability of your URLs by performing HTTP requests at regular, pre-configured intervals. For a URL to be considered up and running, the response must meet the following criteria:
17
22
18
23
1.**Successful Response (2xx Status Codes):**
19
-
The URL must return an HTTP status code in the 200–299 range, indicating a successful request.
24
+
The URL must return an HTTP status code in the 200–299 range, indicating a successful request.
20
25
2.**Automatic Handling of Redirects (3xx Status Codes):** Sentry will follow redirects for URLs returning an HTTP status code in the 300–399 range and verify that the final destination URL returns a successful response. This ensures that redirects won't falsely trigger downtime alerts.
21
26
3.**Timeout Setting:** Each request has a timeout threshold of 10 seconds.
22
-
If the server doesn't respond within this period, the check will be marked as a failure,
23
-
indicating a potential downtime or performance issues.
27
+
If the server doesn't respond within this period, the check will be marked as a failure,
28
+
indicating a potential downtime or performance issues.
24
29
4.**DNS Issue Detection:** Our monitoring also includes the detection of DNS resolution issues.
25
-
If a DNS issue is detected, the check will be marked as a failure,
26
-
allowing you to address the underlying connectivity problems.
30
+
If a DNS issue is detected, the check will be marked as a failure,
31
+
allowing you to address the underlying connectivity problems.
27
32
28
33
## Notifications
29
34
30
35
An uptime alert continuously monitors the configured URL with the criteria defined above. If a failure is detected,
31
-
a new [uptime issue](/product/issues/issue-details/uptime-issues/) with failed check and related errors details will be created.
36
+
a new [uptime issue](/product/issues/issue-details/uptime-issues/) with the failed check and related error details will be created. To avoid triggering false alerts due to transient issues like network glitches, new issues will only be created after a minimum of three consecutive failures have been detected, following the initial downtime detection.
32
37
33
38
To start getting notifications for a new downtime issue, [configure an issue alert](/product/alerts/create-alerts/issue-alert-config/) and choose the issue category "uptime". Then choose how you'd like to be notified (via email, Slack, and so on).
Copy file name to clipboardExpand all lines: docs/product/alerts/uptime-monitoring/troubleshooting.mdx
+1-5Lines changed: 1 addition & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,11 +4,7 @@ sidebar_order: 52
4
4
description: "Learn how to troubleshoot potential Uptime Monitoring problems."
5
5
---
6
6
7
-
<Includename="feature-stage-alpha-uptime.mdx" />
8
-
9
-
## Verify Feature Eligibility
10
-
11
-
Uptime alerts are only available for organizations that have early adopter features enabled. They must also have URLs that match our [auto detection criteria](/product/alerts/uptime-monitoring/automatic-detection/#how-it-works). In the current version, organizations are limited to a single uptime alert.
0 commit comments