User Notifications and Alert Settings

Harness provides granular control of notifications, allowing you to control alert conditions, users, and groups across your account and in individual Workflows.

There are three major notification features:

  • Notification Settings for User Groups – Set the notification channels for User Group members. These include group or individual email addresses, and Slack channels. When User Groups are used in an Alert Notification Rule or in a Workflow Notification Strategy, these channels will be used to notify the group members.
  • Alert Notification Rules – Set which types of alerts are sent to different User Groups. You can also set up a default Catch-All Notification User Group to receive all alerts.
  • Workflows Notification Strategy – Set notification conditions in a Workflow or Workflow Phase, and the User Groups to notify when these conditions are met.

Notification Settings for User Groups

You can add notification settings to Harness User Groups, including group email addresses and Slack channels. When the User Group is assigned an Alert Notification Rule, or added to a Workflow Notification Strategy, the channels you set here will be used to notify them.

To add notification settings to Harness User Groups, do the following:

  1. In Harness Manager, click Continuous Security, and then click Access Management.
  2. In Access Management, click User Groups.
  3. Click the name of an existing User Group, or create a new User Group with the steps in Managing Users and Groups (RBAC).
  4. Locate the Notification Settings section.
  5. Click the vertical ellipsis and click Edit. The Notification Settings dialog appears.
  6. Configure the following notification settings and click SUBMIT.
  • Use Members' Individual Email Addresses – Enable this setting to have notifications sent to the individual email addresses of the group's configured Member Users.
  • Send an Email Notification to Members Newly Added to This Group – Enable this setting to notify new members when they're added to the group.
  • Group Email Addresses – Enter any group email addresses where Harness can send notifications. The Group Email Addresses are always used, regardless of whether Use Members' Individual Email Addresses is enabled.
  • Slack Channel Name – Enter the name of a Slack channel where Harness can post notifications. You do not need to enter the exact name, as the Slack Webhook URL will point to the exact channel.
  • Slack Webhook URL – Enter the Slack channel Incoming Webhook URL. For steps on obtaining a Slack channel Incoming Webhook, see Incoming Webhooks from Slack.
  • PagerDuty Integration Key – Enter the key for a PagerDuty Account/Service to which Harness can send notifications. You can copy/paste this key from PagerDuty's Configuration > Services > Service Details dialog > Integrations tab, as shown below. (For details, see PagerDuty's documentation on Creating Integrations.)

When you are done, the Notification Settings dialog will look something like this:

Once you click SUBMIT, the Notification Settings appear in the User Group page.

Alert Notification Rules

The Alert Notification Rules determine which alerts to send to specific User Groups, such as an alert that a Harness Delegate is down.

To set up an Alert Notification Rule, do the following:

  1. In Harness Manager, click Setup, and then click Alert Notification Rules. The Alert Notification Rules settings appear.

The options here are outlined in the following sections:

Alert Notification Status Toggle

The Alert Notification Status slider at upper right is a global panic button for situations where your users are receiving too-frequent notifications. By sliding this to its OFF position, you restrict notifications to Harness Manager's adjacent bell-shaped Alerts indicator, only. This prevents notifications from being forwarded to any of the channels configured below.

While set to OFF, this Status toggle will suppress notifications to all User Groups—those configured under both the Catch-All Notification Rule and Alert Notification Rules sections.

Catch-All Notification Rule Setup

In Catch-All Notification Rule, you specify the User Groups to use as the Catch-All Notification Groups, and the alert rules for those Groups. Whatever rules are not covered by the parallel Alert Notification Rules section are applied to the User Groups in the Catch-All Notification Rule section.

For example, if the rule Matching (Alert Type: No Eligible Delegates) is not applied to any User Group in the Alert Notification Rules section, then that alert is sent to the User Groups set up in the Catch-All Notification Rule section.

At least one Catch-All Notification Rule User Group is required. By default, the Account Administrator User Group is used.

To set up a Catch-All Notification Rule User Group, do the following:

  1. In the Alert Notification Rules page, click the pencil icon next to the Catch-All Notification User Group. The Notification Settings dialog appears.

  1. In User Group(s), select the User Groups to set as the Catch-All Notification User Groups.
  2. Click SUBMIT. The groups you selected are listed.
For the Catch-All group, the Notification Settings dialog's Alert Category selection is locked to All alerts.

Alert Notification Rules Setup

The Alert Notification Rules determine how alerts are routed to User Groups.

To begin defining an alert notification rule, do the following:

  1. In the Alert Notification Rules section, click Add New Rule. The Notification Settings dialog appears.

  1. Set the Alert Filter to either Matching or Not Matching, depending on the type of rule you want to create.

  1. In Alert Category, select a category.

The dialog now displays different controls, depending on which category you selected:

  • Setup – These alerts are triggered by events within Harness.
  • 24/7 Service Guard – These alerts are triggered by Harness' analysis of data from your configured third-party monitoring and verification tools.

Setup Alerts

Selecting an Alert Category of Setup keeps the Notification Settings dialog compact. To finish defining your notification rule:

  1. In Alert Type, select the specific alert for this rule, such as No Active Delegates.
  2. In User Groups, select the User Groups that will receive the alert.

    When you are done, the dialog will look something like this:
  3. Click SUBMIT. The new rule is displayed.

24/7 Service Guard Alerts

Setting the Alert Category to 24/7 Service Guard expands the Notification Settings dialog. Use the additional controls here to fine-tune how this rule will send alerts to your User Groups. (For details, see Alert Thresholds.) To continue defining the rule:

Set the Alert Type to 24/7 Service Guard.

  1. Leave the Application multi-select drop-down set to All, or limit this rule by selecting one or more specific Harness Applications.
  2. Leave the Environment drop-down set to All, or limit this rule by selecting one or more specific Harness Environments.
  3. If you have modified the Application and/or Environment defaults, select corresponding Service Verification(s).
  4. Drag the Alert Threshold slider to set the minimum severity level for User Groups to receive these alerts. For details, see Alert Thresholds.
  5. Select the User Groups(s) to receive the alert.

    When you are done, the dialog will look something like this:
  6. Click SUBMIT. The new rule is displayed.

Alert Thresholds

When you create a 24/7 Service Guard alert rule, you use the Alert Threshold slider to define a severity level. When Harness determines that this severity threshold has been met or exceeded, it will send alerts to the User Group(s) you configure.

You can create multiple rules to route the same Alert Type to different User Groups, depending on severity. For example, you might set three rules, using the following thresholds on the slider's 0–1.0 scale:

  • 0.2+: Send to developers (via Slack, email, etc.).
  • 0.5+: Send to DevOps.
  • 0.8+: Send to engineering managers.
Thresholds and Overall Risk Level

The slider's scale represents Harness' analyzed risk level, based on metrics, transaction history, and machine-learning models. While third-party Verification Providers' alerts are typically based on static rules, Harness' alerts are dynamic. Over time, Harness will escalate or decrease alerts, as we observe anomalies, regressions, and other factors.

To set the Overall Risk Level at which Harness originally triggers alerts—based on our analysis of data from your third-party Verification Providers—each provider's Alert Notification dialog provides a similar Alert Threshold slider. For details, see 24/7 Service Guard.

Alert Examples

Here is an example of an alert in Slack:

Here is an example of an alert in email:

Workflow and Phase Notifications

Workflow notifications are set up in the Workflow Notification Strategy settings. For information on setting the Workflow Notification Strategy, see Notification Strategy.


How did we do?