Create a traffic alert rule

Coming soon

This feature is coming soon, so you won't see it live in a production environment just yet. Stay tuned for the release!

We offer proactive monitoring for your organization in the Redox dashboard using traffic alert rules. When you create a traffic alert rule and the conditions of the rule are met in your system, we send an email to the designated users.

There are two types of traffic alert rules: No Traffic or Error Threshold.

We recommend using No Traffic alert rules if you want to know if traffic is actually flowing like it should in a given environment. This type of alert rule triggers a notification if a specified data flow hasn't had any logs reach a terminal state (i.e., Succeeded, Filtered, or Failed) in a designated amount of time (i.e., as little as 15 minutes up to 24 hours). If a log is pending, it doesn't count as completed traffic, so pending logs could be a condition of triggering this alert. But also keep in mind that since failed logs count as completed traffic, this type of alert rule doesn't necessarily help you track errors.

We recommend using Error Threshold rules if you want to address traffic errors in a given environment. This type of alert rule triggers a notification if X number of logs have reached a terminal state of Failed and will no longer be retried within a given period of time (i.e., as little as 15 minutes up to 24 hours).

Traffic alert rules allow you to receive alerts only when you want to know about an irregularity instead of having to constantly check the dashboard for yourself. Bonus, you can independently monitor the health of your integration without relying on Redox support.

Free Redox accounts

Traffic alert rules aren't available for free dashboard organizations. If you have a free Redox account, the Monitoring tab displays a message that this feature is unavailable. To create and monitor alerts, you must upgrade your Redox account.

These instructions are for creating one traffic alert rule at a time. If you want to create multiple traffic alert rules, you can create your own script and programmatically create a batch of alerts in an environment using the Platform API.

  1. Log in to the Redox dashboard.
  2. From the navigation menu, click the Monitoring page.
  3. By default, the Traffic Alert Rules tab opens and displays any configured alerts. You can search for, filter, and see the latest status of any configured alerts for the current environment.
    The Monitoring tab
    The Monitoring tab

    Available environment types and connections

    If you don't see an option for creating a traffic alert rule, you may have selected 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.
    Create rule button
    Create rule button
  5. The Create New Alert page opens. Select the options for the Connection Scope section.
    1. Connection: Select the connection you want to create a rule for.
    2. Data Flow: Click the Select Data Flow link to open the dialog with all the data flow options for the connection you selected. You can also use the search bar to locate the data flow you're looking for or page through the options using the FIRST, PREV, NEXT, and LAST buttons.
      Connection scope details
      Connection scope details
  6. Next, select the options for the Alert Settings and Alert Name section.
    1. Alert Type: Select either No Traffic or Error Threshold. Depending on which you select, you also must populate the fields that appear for time or number of errors.

      Allowable number of alert types

      You may only create one alert of a given type for the specified data flow. In other words, there can't be two No Traffic alerts or two Error Threshold alerts for the same data flow.

    2. In the Alert Name section, enter a descriptive name for the new alert.
      Alert settings and name details
      Alert settings and name details
  7. In the Notifications section, you can choose who should be notified when an alert is triggered. Enter the email address(es) for the alert notification to be delivered to. Use commas to separate email addresses if the alert notification should go to more than one address.
  8. Click the Create Rule button to save the new alert.
    Notification details and saving a new alert rule
    Notification details and saving a new alert rule

    Programmatic option

    You can also use the Platform API to create a traffic alert rule. Or, you can build your own script to programmatically create a batch of traffic alert rules for a given environment using the Platform API, too.

  9. The Alert Rules tab opens again and displays the new alert. You can click on the alert to expand and view the details like the alert type and time window, along with the name of the user that created the rule. If you're the creator of the alert rule or an organization owner, you can also edit, pause, or delete the alert.
    Traffic alert rule details and options
    Traffic alert rule details and options
  10. Alerts are evaluated every 15 minutes for Error Threshold alerts or every 30 minutes for No Traffic alerts. Whenever the conditions of the alert are met, Redox sends an email to the specified list of email addresses. The email includes the alert type with a link to view the related logs. 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.