Bring Your Own Notifications

The Bring Your Own Notifications (BYON) feature, introduced in the 2024-04-12 release, enables brownfield customers to utilize their existing Action Groups (AGs) and Alert Processing Rules (APRs) without mandating the use of notification assets deployed by the Notification Assets initiative or the Deploy Service Health Action Group policy definition in the ALZ pattern. This feature also allows brownfield customers who deployed the ALZ pattern before this feature was available to switch to it.

The BYON feature operates by setting the necessary parameter values before deploying the ALZ pattern. Customers can either specify existing AGs and one APR or provide target values to create the AG and APR using the actions specified in the parameter file. If no values are specified, an empty AG will be created.

For brownfield customers opting to use their own notification assets, they need to enter the AG resource IDs and the APR resource ID in the parameters BYOActionGroup and BYOAlertProcessingRule, respectively, while leaving the parameters ALZMonitorActionGroupEmail, ALZLogicappResourceId, ALZLogicappCallbackUrl, ALZArmRoleId, ALZEventHubResourceId, ALZWebhookServiceUri, ALZFunctionResourceId, and ALZFunctionTriggerUrl empty:

Conversely, if they choose to use the assets provided by AMBA-ALZ or if they are greenfield customers, they should leave the BYOActionGroup and BYOAlertProcessingRule parameters empty and populate the other parameters (ALZMonitorActionGroupEmail, ALZLogicappResourceId, ALZLogicappCallbackUrl, ALZArmRoleId, ALZEventHubResourceId, ALZWebhookServiceUri, ALZFunctionResourceId, and ALZFunctionTriggerUrl):

The deployment code includes conditions that control the deployment behavior based on the following scenarios:

A. Use your own AGs with the AMBA APR:

• Does not deploy the AMBA SH AG.
• Deploys the AMBA APR with the customer’s AGs.
• Deploys SH alerts pointing to the customer’s AGs.

Example parameter file for this scenario:

B. Use your own AGs and APR:

• Does not deploy any AMBA notification AG or APR assets or AMBA SH AG.
• Deploys SH alerts pointing to the customer’s AGs.

Example parameter file for this scenario:

C. Use AMBA notification assets:

• Deploys notification assets for SH alerts and wide notifications

Example parameter file for this scenario:

The conditional deployment behavior allows brownfield customers to switch from the initial notification assets scenario (available until the 2024-03-01 release) to the new BYON feature and vice versa.

To switch, customers need to:

• Update the parameter file to match one of the three scenarios discussed.
• Redeploy the ALZ pattern.
• Run the remediation for both Notification Assets and Alerting-ServiceHealth policy initiatives.
• Remove notification assets deployed by ALZ patterns using the Start-AMBA-ALZ-Maintenance.ps1 script (*** only if moving from ALZ notification assets to BYON)

The code will reconfigure the Service Health alerts to use either the customer’s action groups or the ALZ pattern notification assets based on the selected scenario.