# Check Redox system alerts

A Redox <u>system alert</u> is triggered when a production destination doesn’t receive expected data due to:

- VPN heartbeat failure ([check VPN statuses](/how-to-use-redox/check-a-vpn-status))
- log failure

System alerts help you see where or how the issue happened. [Learn about monitoring data exchange health](https://docs.redoxengine.com/permalink/RqjicoYocYtUDfFmaaoSt/#monitor-data-exchange-health).

## Prerequisites

- A user must be assigned an environment role to view system alerts. Any environment role allows them to view Redox system alerts for either organization in a subscription (i.e., for their organization and their connection’s).
- Log in to a <u>**production**</u> environment to check system alerts. They don’t appear in development or staging environments. 

## Set your alert email address

When a VPN or log fails and hinders production traffic, we send a notification to your Redox organization’s <u>alert email address</u>. To add or change this email address: 

1. Log in to the Redox dashboard.
2. Your username displays at the bottom of the navigation menu. Click **your username** for the user menu to appear.
3. From the user menu, select the **Organization Profile** option. 
4. Add or change the **alert email address**. You can only enter one email address in this field. 
5. Click the **Submit** button. 

![The Alert Email field is the third option on the Organization Info tab. ](https://images.ctfassets.net/cl3wt5ehhnlv/iSMbTNaNu6wBImRIE4ruB/38621534e14ed44f18c933bfac15f46a/organization-profile-alert-email.png)

*Alert email address in the Organization Profile*

In the event of a triggered system alert, we send an email notification that looks something like this:

![Example alert email](https://images.ctfassets.net/cl3wt5ehhnlv/1F34LbStTlaFmCZKzeMpte/44a10c653846095e6ed72ef89afb997b/Email-example-tcp.png)

*Example alert email*

## Check system alerts

You can preemptively check triggered or historical system alerts on the <u>Monitoring</u> \> <u>System alerts</u> tab of the Redox dashboard. We retain historical alerts up to 60 days. You can also see system alerts sent to your connection on this page. 

To actively monitor your integration health, you can [check a VPN status](/how-to-use-redox/check-a-vpn-status) in real-time. Or, to dig into more details after reviewing a system alert, [run log inspector](/how-to-use-redox/run-log-inspector).

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. Click the **System** **alerts** tab. Any system alerts from the last 60 days display.


> **Only for production environments**
>
> Remember that system alerts are only available in <u>production</u> environments. If you navigate to the <u>Monitoring</u> page in a development or staging environment, this warning appears. 
>
> ![Displays the warnings users get if they attempt to check system alerts in a dev or staging environment.](https://images.ctfassets.net/cl3wt5ehhnlv/5xlZ0CSu8ntGhNo4MTKu15/de0cd2c346680383b692da364bf6c493/system-alerts-unavailable-environment.png)


4. (Optional) Use any of the following filters to narrow down the list of system alerts. At any point, you can click the **Clear all** button to reset the filters to their defaults.
   - <u>Alerting organization</u>: Set to <u>All</u> by default. 
To filter by a particular organization, click the drop-down field and select the **organization name**. In the drop-down list, your organization appears first and your connections display below. You can only select one organization if using filters. 
   - <u>Alert type</u>: Set to <u>All</u> by default. 
To filter by type, click the drop-down field and select either **Log Failure** ([read about automatic retries](https://docs.redoxengine.com/permalink/6PstyPW2ES4e5dSALwG5Uv/#automatic-retries)) or **VPN Heartbeat Failure** ([read about VPN tests and status definitions](https://docs.redoxengine.com/permalink/4vBFw9TgLrlKJceh46xIwU/#vpn-test-types)).
   - <u>Date range</u>: Set to empty by default. 
To filter by timestamp (i.e., when the issue occurred), select a **start date** up to 60 days prior and an **end date**. 
   - <u>Status</u>: Set to <u>All</u> by default. 
To filter by status, click the drop-down field and select either **Resolved** (the issue was fixed) or **Triggered** (the issue is active and ongoing).


![A user uses filters to narrow down the list of visible alerts. ](https://images.ctfassets.net/cl3wt5ehhnlv/33lpShWy8rv9EQl3cXKNSh/d6224f46fd6fb96e40c4efa269b234d5/system-alerts.png)

*Use the system alert filters*


5. Review the table with the following columns for details about system alerts. 
   - <u>Alerting organization</u>: The name of the organization where the alert was triggered. 
This is the organization that should’ve received an email notification. The system alert type displays below the organization name. 
   - <u>Related links</u>: (Only for log failures) Links to logs or other related information for more details.  
   - <u>Subscription</u>: Links to the relevant traffic details based on the alert type. 
     - For a log failure, the link(s) open the subscription details. 
     - For VPN heartbeat failure, the link(s) open the production destination details. 
   - <u>Error status</u>: The current system alert status, which is either triggered (i.e., active alert) or resolved.
   - <u>Timestamp</u>: The date/time that the system alert was triggered. 

> **Troubleshooting**
>
> [Review our tips](/troubleshooting/troubleshoot-alert-errors-in-the-redox-dashboard) to troubleshoot active system alerts.
