Create and link a traffic alert rule

The Monitoring page in the Redox dashboard allows you to view and manage your traffic alert rules. Learn about alert rules.

You may create alert rules for two scenarios: No Traffic or Error Threshold.

You must link the relevant subscription(s) to an alert rule to begin monitoring. You can pause or delete subscription links at any time.

You may only create one alert rule at a time.

1. Log in to the Redox dashboard.
2. From the navigation menu, click the Monitoring page.
3. By default, the Alert Rules tab opens and displays any configured alert rules with their latest status (statuses won't display for alerts that aren't linked to at least one subscription). Expand an alert rule to view its linked subscriptions. You can also search for or filter to change which configured alert rules display for the current environment.

   Available environment types and connections

   If you don't see an option for creating a traffic alert rule, you may be operating in the wrong environment type, or the selected environment doesn't have any configured connections.

   If you're in a development environment, you may see a message like the one below. Make sure to select either a staging or production environment.

   

   If you don't have any connections in the selected staging or production environment, you may see a message like the one below. Double check you're in the right environment, or request a new connection for the environment first.

   

4. To create a new alert rule, click the Create Rule button.
5. The Create New Alert page opens. In the Alert Type drop-down field, select either No Traffic or Error Threshold.

   Alert rule definitions

   A No Traffic alert rule monitors whether traffic is flowing appropriately in a given subscription. For this type of alert, we send a notification if no logs reach a terminal state (i.e., Succeeded, Filtered, or Failed) in a specified amount of time (i.e., as little as 30 minutes up to 72 hours). Since pending logs don't count as completed traffic, pending traffic could be a condition you define to trigger an alert. Failed logs do count as completed traffic, so this type of alert isn't for tracking errors.

   An Error Threshold rule monitors the number of errors in a given subscription. This type of alert rule triggers 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).

   Multiple No Traffic or Error Threshold alert rules

   It’s possible to create more than one No Traffic or Error Threshold alert rule for the same subscription. Just keep in mind that you’d then receive multiple alert notifications for the same type of issue at potentially different times.

6. In the Within drop-down field, select the time interval that Redox should check for the alert rule conditions.
   • For No Traffic alert rules, select any of these time intervals:
     • 30 minutes
     • 1 hour
     • 2 hours
     • 6 hours
     • 12 hours
     • 24 hours
     • 48 hours
     • 72 hours
   • For Error Threshold alert rules, select any of these time intervals:
     • 15 minutes
     • 30 minutes
     • 1 hour
     • 2 hours
     • 6 hours
     • 12 hours
     • 24 hours
7. For Error Threshold alert rules, use the up and down arrows to choose the allowable number of errors before an alert rule is triggered.
8. (Optional) Select any relevant Ignore options. Notifications for triggered alerts won't be sent on ignored days.

   Monitoring on ignored days

   Redox continuously monitors subscription(s) for alert rule conditions, but we don’t send notifications if an alert is triggered on an ignored day. However, any triggered alerts still display in the dashboard.

   If you choose to ignore certain days, you may see an active alert in the dashboard that you didn’t receive a notification for. This could happen if the alert was initially triggered on an ignored day. Or, you may not find out about a triggered alert if it’s both triggered and resolved on an ignored day, unless you happen to check the dashboard while it’s active.

   Multi-region holiday lists

   The holiday list will change depending on which region the selected Redox organization is configured for. If your organization is configured for multiple regions, you'll see holiday lists for both the U.S. and Canada.

   1. If you select ignore options, you must also select the appropriate time zone to determine the boundaries of the ignored days.

      Default time zone for different subscriptions

      Default is the time zone designated by your connection's organization settings. If not designated, U.S. Central time will be the default instead.

      Let's say you create an alert rule that ignores Saturdays. Your organization uses Eastern time zone, but you select Default for the alert rule's time zone. That means the time zone for ignored days will be determined by your connection's organization.

      If you link the alert rule to two subscriptions, one with an organization that uses Central time and one that uses Pacific time, the alert rule will trigger notifications based on Central and Pacific time respectively.

      So, if the alert rule is triggered at 12:30 AM Eastern on a Saturday, you'll still receive an alert notification for both subscriptions because it's only it's 11:30 PM Central or 9:30 PM Pacific on a Friday. However, if another alert rule is triggered just an hour later, you'd only get a notification for the second subscription.

9. In the Alert Name field, enter a human-friendly name for the alert. This name will be displayed on the Alert Rules tab, so we recommend choosing a name that will be descriptive enough for you to keep track of which rule it's for.
10. In the Notifications section, 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.
11. Click the Create Rule button to save the new alert. Or, click the Cancel button to discard the rule.
12. The Alert Rules tab opens again and displays the new alert. Since the alert is new and doesn't have any linked subscriptions, you won't see an alert status yet.
13. To start monitoring rule conditions, follow the instructions for linking an alert to one or more subscriptions.

1. Log in to the Redox dashboard.
2. From the navigation menu, click the Monitoring page.
3. By default, the Alert Rules tab opens and displays any configured alerts. Find the alert you want to edit. You have two options for editing:
   1. Click the Edit button on the alert. The edit page opens so you can modify the alert, name, or notification settings.
   2. Click the alert name to open the details page. Under the Settings section, click the Edit button. The edit page opens so you can modify the alert, name, or notification settings.
4. Once you're finished making edits, click the Save button.

1. Log in to the Redox dashboard.
2. From the navigation menu, click the Monitoring page.
3. By default, the Alert Rules tab opens and displays any configured alerts. Find the alert you want to delete. Click the Edit button or alert name to open the details page.
4. At the bottom of the page, click the Delete button. This is different from the Delete options for each alert rule link, which you can find in the table of links. Deleting an alert rule also deletes any associated subscription links.

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

1. Log in to the Redox dashboard.
2. From the navigation menu, click the Monitoring page.
3. By default, the Alert Rules tab opens and displays any configured alerts. Find the alert you want to link. Click the Edit button or alert name to open the details page.
4. Under the Links section, select the relevant connection from the drop-down menu.
5. Click the Select Subscription link to open the dialog with all the subscription options for the connection you selected. Click the radio button of the relevant subscription, then click the Select Subscription button.

   Subscription search options

   You can use the search bar to locate the subscription you're looking for or page through the options using the FIRST, PREV, NEXT, and LAST buttons.

6. Click the Add button to finish linking the alert rule to the subscription.
7. The new link appears in the table below. Redox begins evaluating every 15 minutes for Error Threshold alerts or every 30 minutes for No Traffic alerts. Whenever the alert rule conditions are met, we send an email to the specified list of email addresses. The email includes the alert type with a link to view the related log(s). The specified users also receive an email when an alert has been cleared.

   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.

   Getting removed from the email list

   Only the alert creator or an organization owner can modify the email notification list. If a user wants to stop receiving the email notifications, they must work with either of those persons to remove their email address from the alert notification list.

8. Repeat these steps for to link the alert to as many other subscriptions as needed.

Pausing a link temporarily halts subscription monitoring. The subscription will still be attached to the alert rule, but Redox won't watch for the conditions specified by the alert rule. This only affects monitoring, not actual subscription traffic.

Deleting a link removes the subscription from the alert rule, meaning the subscription will no longer be monitored. This doesn't delete the alert rule itself.

1. Log in to the Redox dashboard.
2. From the navigation menu, click the Monitoring page.
3. By default, the Alert Rules tab opens and displays any configured alerts. Find the alert with the subscription link you want to pause or delete.
4. Click the drop-down arrow to expand the alert rule details. Click the Pause or Delete button next to the relevant subscription link. Alternatively, you can click the alert rule name to open its Settings page. Under the Links section, you may pause or delete subscriptions.

1. Log in to the Redox dashboard.
2. From the navigation menu, click the Monitoring page.
3. By default, the Alert Rules tab opens and displays any configured alerts. Find the alert you want to monitor.
4. View the alert rule's global status on the righthand side. This global status will only be visible if there are one or more subscriptions already linked to the alert rule. Click the drop-down arrow for a quick view of linked subscriptions, which includes an individual status for each subscription.

   Alert statuses

   Individual statuses display for each subscription link:

   • Okay: Traffic is flowing without the errors defined by the alert rule. This could mean the alert rule hasn't ever been triggered or was resolved after being triggered previously.
   • Triggered: The conditions of the alert rule have been met (i.e., no traffic or a certain number of errors have occurred within the specified time frame). An alert notification has been sent to the designated users, unless it was triggered during an ignored day.
   • Unknown: The conditions of the alert rule aren't being monitored because the status is unknown. This may happen if the alert rule was recently created, so it hasn’t run yet.
   • Paused: A user in your Redox organization has paused the alert, so the rule conditions aren’t being monitored. This only affects monitoring of the subscription, not actual traffic flow.

   Individual link statuses are evaluated to create a global status for the alert rule.

   • All links have the same status, so the global status matches.
   • All links have active alerts, so the global status equals Triggered - All.
   • Links have different statuses with at least one Triggered, so the global status equals Triggered - Partial.
   • One or more links are Paused, so the global status equals the status of any unpaused links.
   • One or more links are Unknown, so the global status equals the status of any known links.
     • The global status may equal Unknown if all links have an Unknown status or links have a combination of Unknown and Paused.

5. To manage alert rule links and edit alert details, click the alert name to open its Settings page.