Environment Health Notifications

Overview

Environment Health Notifications send email alerts when the health of your monitored devices or applications changes. You choose whether to receive an immediate email for each health change, a scheduled digest, or both, and you control which recipients receive them and which organizations are monitored. Notifications are off by default and must be enabled before any email is sent. All settings are configured on the Health Notifications page and apply to the recipient list and organizations you select there.

Enabling Environment Health Notifications

1. Log in to the AgileBlue Portal.
2. Navigate to Settings.
3. In the General Configuration section, select Health Notifications.
4. Enable the Send email when monitored devices or applications become unhealthy or recover toggle at the top of the page.
5. Configure the sections below, then select Save settings in the bottom right corner of the page.

Choosing When to Send

1. Locate the When to send section.
2. Select the Send an immediate email for each health change checkbox to receive an email as each health change is detected.
3. Open the Scheduled digest dropdown and select one of the following:
   1. Daily digest
   2. Weekly digest
   3. Monthly digest
4. Note that scheduled digests include changes that occurred during the period as well as all items that are still unhealthy.
5. Select Save settings.

Selecting Which Health Changes to Notify On

1. Locate the Health changes section.
2. Select the Notify when a component becomes unhealthy checkbox to receive notifications when a component enters an unhealthy state.
3. Select the Notify when a component recovers checkbox to receive notifications when a component returns to a healthy state.
4. Select Save settings.

Adding Recipients

1. Locate the Recipients section.
2. Enter the recipient's address in the Email address field.
3. Select Add recipient.
4. Repeat steps 2 and 3 for each additional recipient you want to enroll.
5. Note that all selected organizations use this same recipient list and schedule.
6. Select Save settings.

Selecting Organizations to Monitor

1. Locate the Organizations to monitor section.
2. Select the checkbox next to each organization you want monitored.
3. Select Save settings.

What Gets Monitored

Environment Health Notifications cover the following health states:

1. Elastic process health - The state of the Elastic process on the monitored device.
2. Agent health - The state of the Agent on the monitored device.
3. Fleet health - The state of Fleet for the monitored device.
4. Endpoint health - The state of the Endpoint for the monitored device.
5. Individual integration health - The state of each individual integration, reported separately from its parent device or application.

What's Included in a Notification Email

Each notification email includes the following details:

1. Client - The organization the affected device or application belongs to.
2. Device or application - The monitored item whose health changed.
3. Affected component - The specific component that changed state.
4. Previous and current state - The state the component was in and the state it is in now.
5. Error summary - A sanitized summary of the reported error.
6. First-observed time - When the state was first observed.
7. Portal link - A link to the relevant page in the AgileBlue Portal.

How Health Notifications Are Processed

1. Health state changes are collected as they are observed and processed on a recurring 30-minute cycle.
2. Before a notification is sent, the current state is verified so that resolved conditions are not reported as active.
3. Parent and integration failures are correlated so that a single underlying failure is not reported as multiple unrelated issues.
4. Duplicate notifications for the same condition are suppressed.
5. Degraded and unknown states are held for a configurable grace period before a notification is sent, so brief fluctuations do not generate email.
6. Failed email deliveries are retried.
7. A separate check identifies devices and applications that have stopped reporting check-ins or state entirely.

Turning Off Notifications

1. Navigate to Settings > Configuration > Health Notifications.
2. Turn off the Send email when monitored devices or applications become unhealthy or recover toggle at the top of the page.
3. Select Save settings.
4. Confirm the toggle remains off. No further health notification emails will be sent to the recipients on the list.

Need Help?

If you have any questions about this feature, please don't hesitate to reach out. AgileBlue Support is also here to assist with any setup questions and can be reached at support@agileblue.com or by submitting a ticket.