Centralised notification

Prerequisites

Before you begin, ensure you have the PL_CENTRAL_NOTIFICATIONS feature flag enabled. Contact Harness Support to enable this feature flag.

Overview

Harness Centralised Notifications allow you to send notifications based on rules and conditions across pipelines and delegates. You can configure and manage alerts to stay informed about critical events in your Harness environment.

You can configure centralised notifications for:

• Pipelines: Get notified about pipeline events like success, failure, or stage completion
• Delegates: Receive alerts when delegates disconnect, expire, or are about to expire

Pipeline Notifications

Prerequisites

Before you begin, ensure you have the PIPE_CENTRALISED_NOTIFICATION feature flag enabled. Contact Harness Support to enable this feature flag.

Centralised Notifications for pipelines allow you to configure notifications for multiple pipelines at once instead of setting them up individually. You can create rules at different scopes—Account, Organisation, or Project—with each scope providing appropriate targeting options for the pipelines within its hierarchy.

These notifications are beneficial for tracking pipeline start, success, and failure events, as well as stage-level events (start, success, failure). This helps you monitor pipeline health and quickly identify issues across your deployment processes.

Configuration Steps

Interactive

Manual

1. Access Notification Management

   • Navigate to Account Settings → General → Notifications Management
   • Click + New Notification to create a new rule

2. Set up Pipeline Notification Rule

   • Provide a Notification Name and click Continue
   • Select Pipeline as the Resource Type
   • Choose your scope: All Organizations or Specified Organizations
   • Click Continue

3. Set Conditions

   • Click + Add Condition to specify when notifications trigger
   • Enter a Condition Name
   • Select relevant Pipeline Events (start, success, failure, etc.)
   • (Optional) Add a custom Notification Template
   • Click Continue

4. Configure Channels

   • Select notification channels.
   • Choose existing channels or create new ones
   • Click Submit to save your configuration

Delegate Notifications

Central Delegate notifications provide proactive monitoring of Harness delegates, ensuring that you are immediately aware of connectivity issues and expiration. Rules configured at higher scopes automatically apply to delegates at lower scopes, based on your rule configuration.

These notifications help track delegate disconnection, expiration, and expiring soon events, allowing you to monitor delegate health and quickly identify connectivity issues that could impact your deployments.

Configuration Steps

Interactive

Manual

1. Access Notification Management

   • Navigate to Account Settings → General → Notifications Management
   • Click + New Notification to create a new rule

2. Set up Delegate Notification Rule

   • Provide a Notification Name and click Continue
   • Select Delegate as the Resource Type
   • Choose your scope: All Delegates or Specific Tags
   • If using tags, specify up to five delegate tags
   • Click Continue

3. Define Conditions

   • Click + Add Condition to specify when notifications trigger
   • Enter a Condition Name
   • Select Delegate Events:
     • Delegate Disconnected: Immediate notification when disconnection occurs
     • Delegate Expired: Daily notification for expired delegates
     • Delegate Expires in [X] Weeks: Advance warning (1-4 weeks)
   • Click Continue

4. Configure Channels

   • Select notification channels.
   • Choose existing channels or create new ones
   • Click Submit to save your configuration.