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). You can either:
   1. Expand an alert rule to view its linked subscriptions.
   2. 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 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.

   
6. 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.

7. 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
8. For Error Threshold alert rules, use the up and down arrows to choose the allowable number of errors before an alert rule is triggered.

   
9. (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.

      
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, or click the Cancel button to discard the rule.
12. The Settings page for the new alert rule opens with its details. To start monitoring rule conditions, link an alert rule to one or more subscriptions.

1. Review any alert rules in the environment on the Alert Rules tab. Find the one you want to edit. Click the alert rule name or View details button.
2. The Settings page opens with the alert rule's details and links. Click the Edit button.

   
3. The Edit Alert Rule page opens. Edit the alert name, settings, or notifications.
4. Once you're finished, click the Save Edits button.

   

1. Review any alert rules in the environment on the Alert Rules tab. Find the one you want to edit. Click the alert rule name or View details button.
2. The Settings page opens with the alert rule's details and links.
3. At the bottom of the page, click the Delete button. Deleting an alert rule also deletes any associated subscription links.

   Deleting alert rule v deleting links

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

4. A confirmation modal appears. Click the Delete button to proceed or the Cancel button to keep the alert rule.

   

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

1. Review any alert rules in the environment on the Alert Rules tab. Find the one you want to link. Click the alert rule name or View details button.
2. The Settings page opens with the alert rule's details and links. Under the Links section, select the relevant connection from the drop-down menu.

   
3. 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.

4. Click the Link rule button to finish linking the alert rule to the subscription.

   
5. The new link appears in the table. Redox begins evaluating every 15 minutes for Error Threshold alerts or every 30 minutes for No Traffic alerts.
6. Whenever the alert rule conditions are met, we send a notification to the specified list of email addresses. The notification includes the alert rule type with a link to view the related log(s). The specified users also receive a notification when the triggered condition resolves.

   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.

7. Repeat these steps to link the alert rule to as many other subscriptions as needed.

Pausing a link temporarily halts subscription monitoring. The alert rule will still be linked to the subscription, but Redox won't watch for any of the specified conditions. So pausing only affects monitoring, not actual subscription traffic.

Deleting 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. Review any alert rules in the environment on the Alert Rules tab. Find the one with the link to modify. Click the drop-down arrow to expand the details.
2. Click the Pause or Delete button next to the relevant subscription link.

   
3. Alternatively, you can click the alert rule name to open its Settings page. Under the Links section, you can pause or delete subscriptions.

   
4. To resume monitoring, click the Resume 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 configured alert rules with any subscription links. Find the one 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.

   
5. 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.

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