# Create alert rules and links

The <u>Monitoring</u> page in the Redox dashboard allows you to view and manage your traffic alert rules. [Learn about monitoring data exchange health](https://docs.redoxengine.com/permalink/RqjicoYocYtUDfFmaaoSt/#monitor-data-exchange-health). 

> **Traffic alert rules vs. Redox system alerts**
>
> Remember that <u>traffic alert rules</u> are unique rules you create to proactively monitor your integration health.
>
> <u>System alerts</u> also monitor integration health, but they’re Redox-managed and Redox-resolved. [Learn about Redox system alerts](/how-to-use-redox/check-redox-system-alerts).

## Prerequisites

- All environment users can view traffic alert rules. However, a user must be assigned to an <u>**engineer**</u> or a <u>**support**</u> role to manage alert rules. [Learn about user roles](/basics/managing-access-for-your-redox-organization/what-are-user-roles).
- You must have a paid Redox account to use alert rules. If you have a free Redox account, alert rules won’t be visible in the dashboard or available via API. 

## Overview

Review the types of alert rules and the purpose of links before you start creating. 

### Types of alert rules

There are different traffic alert rule types that watch for different scenarios in your data exchange. You can create one or more types based on your unique needs. 

<details>
<summary>No traffic alert rule</summary>

A <u>No traffic</u> alert rule monitors whether traffic is flowing appropriately in a given subscription. 

With this type of alert rule, you receive a notification when no logs reach a terminal state (i.e., `Succeeded`, `Filtered`, `Failed`) during a given time period (i.e., as little as 30 minutes up to 72 hours). 

This type of alert isn’t meant for tracking errors since failed logs count as completed traffic. 

> **Pending logs not included**
>
> This doesn’t include pending logs since they aren’t in a terminal state.

</details>

<details>
<summary>Low traffic alert rule</summary>

A <u>Low traffic</u> alert rule monitors whether traffic is flowing as anticipated in a given subscription. 

With this type of alert rule, you receive a notification if less than X number of logs reach a terminal state (i.e., `Succeeded`, `Filtered`, `Failed`) within a specified time (i.e., as little as 30 minutes up to 72 hours).

This type of alert rule is one step more preemptive than a <u>no traffic</u> alert type since it can help you catch an unexpected dip in traffic before reaching no traffic at all. However, it still isn’t meant for tracking errors since failed logs count as completed traffic. 

> **Pending logs not included**
>
> This doesn’t include pending logs since they aren’t in a terminal state.

</details>

<details>
<summary>Error threshold alert rules</summary>

An <u>Error Threshold</u> alert rule monitors the number of errors in a given subscription. 

With this type of alert rule, you receive a notification if X number of logs reach a terminal state of `Failed` and will no longer be retried within a specified time (i.e., as little as 15 minutes up to 24 hours).

</details>

<details>
<summary>Retry threshold alert rule</summary>

A <u>Retry threshold</u> alert rule monitors the number of retries for any log in a given subscription. 

With this type of alert rule, you receive a notification if one or more logs has been retried more than X number of times within 15 minutes (this is a static lookback time).

For example, if you configure an alert rule with a retry threshold of 10, the alert rule triggers if one or more logs have reached at least 10 retries within the last 15 minutes. These logs might continue retrying, but the alert rule doesn’t clear until all logs for the linked subscription reach a terminal state or have fewer than 10 retries within 15 minutes. 

> **What’s not included**
>
> A <u>Retry threshold</u> alert doesn’t measure the cumulative number of retries for all logs combined, nor does it measure the number of individual logs that are retrying.

</details>

### What an alert rule link means

You must <u>link</u> an alert rule to a subscription to actively watch for the rule’s defined conditions. If the conditions are met, you receive a notification. That way, you can preemptively monitor the health of your subscriptions. 

An alert rule can be linked to multiple subscriptions. You can pause or delete a link at any time.

If an alert rule isn’t linked, it’s not actively monitoring anything. You can see if an alert rule has any subscription links on the <u>Monitoring</u> \> <u>Alert rules</u> tab of the dashboard. 

![The "Linked subscriptions" column shows "No subscriptions" if an alert rule doesn't have any links.](https://images.ctfassets.net/cl3wt5ehhnlv/2EffjFUSP6FbJXoPZQYRWA/b91f975b9aab888e5810ab5e88b48ad2/alert-rules-no-subscriptions.png)

*Alert rule without subscription links*

## View alert rules and statuses

1. Log in to the Redox dashboard.
2. From the navigation menu, click the **Monitoring** page.
3. By default, the <u>Alert rules</u> tab opens with any configured alert rules and their latest status (statuses won’t display if there aren’t any subscription links). If linked to multiple subscriptions, the status is a global one.  


![An alert rule's global status appears in the first column.](https://images.ctfassets.net/cl3wt5ehhnlv/7k6v0mG7Yl9LPmPswhlEhG/394f8af3a889956b6d3ae694c5df12ca/alert-rules-global-statuses.png)

*Global statuses of linked alert rules*



> **Available environment types and connections**
>
> If you see a warning message instead a list of alert rules or a <u>New</u> button:
>
> - Make sure you’re not in a development environment. Alert rules are only available in staging or production environments.
> - Check if you have any connections configured for the staging or production environment. If not, [request a new connection](/how-to-use-redox/manage-your-redox-setup/request-a-connection-or-subscription) for the environment first.


4. Search for or use the filters to narrow down the list of displayed alert rules. 
5. Click the **subscription** **links** to expand the alert rule to see each individual subscription links and status. 


![The expanded view of an alert rule shows all its individual subscription links and statuses.](https://images.ctfassets.net/cl3wt5ehhnlv/108JbEeBoiLoG8J8DP2Trn/eb3c6e2098d4c1a4e10e36b82806fb49/alert-rules-individual-statuses.png)

*Expanded details of alert rules*




> **Alert statuses**
>
> Individual statuses display for each alert rule link:
>
> - <u>Okay</u>: Traffic in the subscription hasn’t met the conditions defined by the alert rule. This means the alert rule hasn’t ever been triggered or was resolved after being triggered previously.
> - <u>Triggered</u>: Traffic in the subscription has met the conditions defined by the alert rule. An alert notification has been sent to the designated users, unless it was triggered during an ignored day.
> - <u>Unknown</u>: The subscription isn’t being actively monitored. This can happen if the alert rule was recently created and hasn’t run yet.
> - <u>Paused</u>: The subscription isn’t being actively monitored because a user in your Redox organization has paused the alert rule. Only monitoring is paused, not actual traffic flow of the subscription.
>
> Individual link statuses are evaluated to create a global status for the alert rule. If all links have the same status, the global status matches. 
>
> - <u>Okay</u>: No links have triggered alerts. 
> - <u>Triggered</u>: At least one link has a triggered alert.
> - <u>Paused</u>: All links have a paused status.
> - <u>Unknown</u>: All links have an unknown status or a combination of <u>Unknown</u> and <u>Paused</u>.


6. To review a specific alert rule, click anywhere its **row** to open the <u>Details</u> page. 

## Create an alert rule

1. Follow the steps to view alert rules.
2. Click the **New** button.
3. The create form opens. Under <u>Alert settings</u>, fill out the details:
   1. <u>Name</u>: Enter a **human-friendly name** for the alert rule. This name displays on the <u>Alert rules</u> tab, so choose a descriptive enough name to easily identify it. 
   2. <u>Type</u>: Select one of the following:
      - **No traffic**
      - **Low traffic**
      - **Error threshold**
      - **Retry threshold** 


> **Multiple alert rules for a subscription**
>
> It’s possible to create multiple alert rules of the same type for a given subscription. For example, you could link two different <u>No traffic</u> alert rules to one subscription. However, you’d then receive multiple notifications for the same type of issue at potentially different times.


   3. <u>Within</u> (only for <u>No traffic</u>, <u>Low traffic</u>, <u>Error threshold</u>): Select the **time interval** for the <u>**look-back window**</u> Redox should use when checking for the alert rule conditions. 
<u>Retry threshold</u> alerts uses a static look-back, so this field won’t appear.


<details>
<summary>No traffic or Low traffic - Supported time intervals </summary>

For <u>No traffic</u> or <u>Low traffic</u> alert rules, select any of these time intervals: 

- 30 minutes
- 1 hour
- 2 hours
- 6 hours
- 12 hours
- 24 hours
- 48 hours
- 72 hours

</details>




<details>
<summary>Error threshold - Supported time intervals</summary>

For <u>Error threshold</u> alert rules, select any of these time intervals: 

- 15 minutes
- 30 minutes
- 1 hour
- 2 hours
- 6 hours
- 12 hours
- 24 hours

</details>


   4. <u>Number of logs or errors</u> (only for <u>Low traffic</u>, <u>Error threshold</u>, <u>Retry threshold</u>): Use the **up and down arrows** to choose the allowable **number of logs or errors** before an alert rule is triggered. 


![A user starts to create an error threshold alert rule. ](https://images.ctfassets.net/cl3wt5ehhnlv/1jaV189lUwJ7zyRmrOnJAk/65731eae8d8bfc63bd2983e95756ca07/alert-rules-create.gif)

*Create an alert rule*


   5. (_Optional_) <u>Skip notifications on</u>: Select any **days of the week** or **holidays** you don’t want to receive notifications for triggered alert rules. 


> **Monitoring doesn’t stop on skipped days**
>
> Monitoring doesn’t ever stop—only _notifications_ stop on skipped days. Any triggered alerts still display in the dashboard no matter what.
>
> Let’s say you select Saturday and Sunday as your <u>skipped days</u>. If an alert rule is triggered on Saturday morning, you won’t get a notification about it, but it will appear in the dashboard. On Monday, you might get a notification when the triggered alert resolves.
>
> Also keep in mind that you might not find out about a triggered alert if it’s both triggered and resolved on a skipped day, unless you happen to check the dashboard while it’s active.




> **Multi-region holiday lists**
>
> The holiday list changes depending on the region of the currently selected Redox organization. If you have a multi-region organization, you’ll see holiday lists for both the U.S. and Canada.

 
      1. Select a **time zone** for the skipped days.


> **Default time zone for different subscriptions**
>
> The <u>**default**</u> time zone is your connection’s time zone (i.e., in their Redox organization settings). If your connection doesn’t specify a time zone, U.S. Central time serves as the default. 
>
> If an alert rule is linked to subscriptions with different time zones, notifications are triggered based on the respective time zone of each subscription. 
>
> For example, you might have an alert rule that’s linked to subscriptions in Central and Pacific time, but you chose to skip notifications on Saturday. If the alert is triggered at 12:30 AM Eastern on a Saturday, you’ll still receive a notification for both subscriptions because it’s only 11:30 PM Central or 9:30 PM Pacific on a Friday. However, if another alert rule is triggered for both subscriptions just an hour later, you’d only get a notification for the second subscription.


4. Under <u>Notifications</u>, enter the **email address(es)** that should receive a notification when the conditions of the alert rule are met. Use commas to separate email addresses if the alert notification should go to more than one address.
5. Click the **Create** button. 
6. A modal opens with a reminder to link the alert rule to activate it. Click the **Confirm** button. 


![A user selects holidays to skip notifications on and types a comma-separated list of email addresses to send alert notifications to.](https://images.ctfassets.net/cl3wt5ehhnlv/OYBMkI1XtYfJBKspYadav/c6e50c94e7a1d369fd0bb6f7dd329eea/alert-rules-create-notifications.gif)

*Configure notification settings*


7. The <u>Details</u> page opens. To start monitoring rule conditions, [link an alert rule](https://docs.redoxengine.com/permalink/39Lf3qtqeHmCZkFaKf5jKz/#link-an-alert-rule) to one or more subscriptions. 

## Edit an alert rule

1. Follow the steps to view alert rules.
2. Find the alert rule you want to edit and click anywhere in its **row.** 
3. The <u>Details</u> page opens. Click the **Edit** button. 
4. The edit form opens. Edit the alert rule name, type, time intervals, skip notifications, or notification email addresses.
5. Once you’re finished, click the **Save** button.


![A user edits the time interval of an existing alert rule.](https://images.ctfassets.net/cl3wt5ehhnlv/1lLtBURIlri22JoRrRvZTK/4da7e6c4facd1376353f666a1e75f219/alert-rule-edit.gif)

*Edit an alert rule*



## Delete an alert rule

1. Follow the steps to view alert rules.
2. Find the alert rule you want to delete**.** Click the t**hree-dots** icon, then the **Delete** option. Deleting an alert rule also deletes any associated subscription links. 
Alternatively, click anywhere in its **row** to open the <u>Details</u> page to review any details prior to deleting. Click the **Delete** button. 


> **Deleting alert rule vs. deleting links**
>
> This is different from the delete options for each alert rule link, which you can find in the table of links. 


3. A confirmation modal appears. Click the **Delete** button to continue.


![A user deletes a configured alert rule.](https://images.ctfassets.net/cl3wt5ehhnlv/2AGbdZ965fk99lHFBiWYkN/e76540a7b5cc4427c0fb604bc363851d/alert-rule-delete.gif)

*Delete an alert rule*



## Link an alert rule

Once you’ve created an alert rule, you must link it to one or more subscriptions to begin monitoring for the rule’s conditions.

> **Linking the same alert twice**
>
> You can link one alert rule to multiple subscriptions. You can also have one subscription with multiple links. However, you can’t link the same alert rule to the same subscription more than once.

1. Follow the steps to view alert rules.
2. Find the alert rule you want to link and click anywhere in its **row.** 
3. The <u>Details</u> page opens. Under the <u>Alert rule links</u> section, select the relevant **connection** from the drop-down menu. 
4. Click the **Select subscription** link.
5. A modal opens with the available subscriptions for the connection you selected. Use the <u>Search</u> field or the <u>Connection</u> drop-down to narrow down the available options. If needed, use the page options at the bottom of the modal to navigate through the pages. Then select the **radio button** of the subscription you want to link an alert rule to.
6. Click the **Select** button. 
7. Click the **Link rule** button to finish linking the alert rule to the subscription. 


![A user selects two subscriptions to link the alert rule to.](https://images.ctfassets.net/cl3wt5ehhnlv/5nKuJKpgP8nvxwAFCTk0St/ad12e1977ce1bf3290190e34ebbf4e8b/alert-rules-create-link.gif)

*Link an alert rule*


8. The new link appears in the table. Redox begins evaluating for the alert rule conditions every **15 minutes** (<u>Error threshold</u> or <u>Retry threshold</u> alert rules) or every 30 minutes (<u>No traffic</u> or <u>Low traffic</u> alert rules).
9. Repeat these steps to link the alert rule to as many other subscriptions as needed. 
10. When the alert rule conditions are met, we send a notification to the specified list of email addresses. The notification includes the information and related links for the triggered alert rule. 


> **Redox email address**
>
> The alert notification is sent from `alerts@redoxengine.com`. Make sure to allow-list that email address as a sender, or check your spam folder if the alert notification doesn't show up in your inbox.



![An example of an email notification for a triggered alert rule.](https://images.ctfassets.net/cl3wt5ehhnlv/3ybLHtxvoOwgdoyu96NRdM/8b2f28f0683b1afef6639f275b7e9c7d/Alert-triggered-email.png)

*Triggered alert email notification*


The specified users also receive a notification when the triggered condition resolves.  


![An example of an email notification for a resolved alert rule.](https://images.ctfassets.net/cl3wt5ehhnlv/6EILI5abyQm6HZHg2jGueq/c225bd4a6848f51899aabc7b91aaf957/Alert-resolved-email.png)

*Resolved alert email notification*



## Pause an alert rule link

<u>Pausing</u> a link temporarily halts subscription monitoring. The alert rule is still linked to the subscription, but Redox won’t watch for any of the specified conditions. Pausing only affects monitoring, not actual subscription traffic.

1. Follow the steps to view alert rules.
2. Find the alert rule with the link you want to modify**.** Click the **subscription links** to expand it. 
3. Click the **Pause** button next to the subscription link. 


![A user pauses a link for an alert rule from the Alert Rules tab.](https://images.ctfassets.net/cl3wt5ehhnlv/1J55UqfJzUggw0fRWC9u5i/17efd48b9aff7ac4486deab547902259/alert-rule-pause-link-option-1.gif)

*Option 1: Pause an alert rule link*


4. Alternatively, you can click in the **alert rule row** to open the <u>Details</u> page. Under the <u>Alert rule links</u> section, you can pause subscription links. 


![A user pauses a link for an alert rule from its Details page.](https://images.ctfassets.net/cl3wt5ehhnlv/2RLiG6CkDx5oxEO0EHUDO7/37542a7009f4c1a8182b48bfa2213ace/alert-rules-pause-link-option-2.gif)

*Option 2: Pause an alert rule link*


5. To resume monitoring in either location, click the **Resume** button. 


![The Resume option appears on the right side of each paused subscription. ](https://images.ctfassets.net/cl3wt5ehhnlv/4c7ZMptkr1oCWUrfcTOrY5/b17af16abb6d9dd96dade82d1e073121/alert-rules-resume-link.png)

*Resume monitoring a subscription link*



## Delete an alert rule link

<u>Deleting</u> a link removes the subscription from the alert rule, meaning the subscription won’t be monitored anymore. Deleting the link doesn’t delete the alert rule itself, though.

1. Follow the steps to view alert rules.
2. Find the alert rule with the link you want to delete and click anywhere in its **row.**
3. Under the <u>Alert rule links</u> section, click the **three-dots icon**, then the **Delete** option next to the relevant subscription link. 
4. A confirmation modal opens. Click the **Delete** button to confirm and successfully delete the alert rule link.
 

![A user deletes a link for an alert rule from the Details page.](https://images.ctfassets.net/cl3wt5ehhnlv/2xkE1vNcDzX3WIqis308xe/7a9f9181d4cc9a81e48ba81bfb6a882d/alert-rules-delete-link.gif)

*Delete an alert rule link*



> **Platform API endpoints**
>
> This article describes how to manage traffic alert rules in the <u>**Redox dashboard**</u>. To manage alert rules via <u>**API**</u>, use these <u>**Redox Platform API**</u> endpoints instead:
>
> - [Create alert rule](https://docs.redoxengine.com/permalink/fc31e290-f81a-52c0-a697-eed528b3ecde-create-alert-v-2)
> - [Update alert rule](https://docs.redoxengine.com/permalink/c1f1667f-7bb5-5166-bc93-bfb70e41ae27-update-alert-v-2)
> - [Delete alert rule](https://docs.redoxengine.com/permalink/3d921228-18ab-5417-a6dc-b3fac9e895d3-delete-alert-v-2)
> - [Create link](https://docs.redoxengine.com/permalink/865472af-f08c-50c5-8bc5-6acc206c3733-create-link-v-2)
> - [Update link](https://docs.redoxengine.com/permalink/20147b12-a464-5489-9a30-f8c4b8ca7ea0-update-link-v-2)
> - [Delete link](https://docs.redoxengine.com/permalink/2c7429ec-3a23-5283-b64c-355d55bf044e-delete-link-v-2)
