Enable SAP Business Technology Platform Alert Notifications

Receiving alert notifications is done via the Alert Notification Service which can be enabled for your SAP Business Technology Platform account. 

Important: Please be aware that the use of this service is quota based (billable)!

To enable the service please follow the documentation:

• SAP Cloud Platform Alert Notification → Administration → Initial Setup

Gather Connection Information

To authenticate towards the service you have to create an OAuth client in SAP Business Technology Platform. Information how to do this you find here:

• SAP Cloud Platform Alert Notification → Administration → Credential Management

Please make sure to note down or copy the client secret, as it cannot be retrieved later on. 

You will need the following connection information to connect SAP Cloud ALM.

1. Select your sub-account and find the Alert Notification Service
2. Navigate to Service Keys → Create Service Key
3. Root URL: Use 'url' value of the service key (up to .com)
4. OAuth URL: Use 'oauth_url' of the service key
5. Client ID: Use 'client_id' of the service key
6. Client Secret: Use 'client_secret' of the service key

Create Custom Alerts

SAP Business Technology Platform Cloud Foundry doesn't have any available event that come out of the box. Hence to actually receive alerts from application in SAP Business Technology Platform Cloud Foundry you have to implement the alert creation in your application.

Find more information here:

• SAP Cloud Platform Alert Notification → Integration → Integrating with a Custom Application

1. Open the Landscape Management application from the launchpad
2. Select your SAP Business Technology Platform (Cloud Foundry) service
3. Press the > button at the end of the line
4. On the tab "Endpoints" press the Add button to create a new end-point
5. Enter a description
6. Choose the use-case "Exception Monitoring"
7. Root URL: Enter the 'Consume Events' URL
8. Choose OAuth authentication and enter the Token Service URL, client ID and client secret

In SAP Cloud ALM you can easily activate the standard monitoring content without any additional setup effort. 

1. Open the Integration & Exception Monitoring application from the launchpad
2. Open the scope selection via the target icon in the upper right corner
3. Change the drop-down for Display Service to "All"
4. Make sure to select your cloud service in the scope
5. Click the rack-wheel icon in the upper right corner to access the configuration
6. Expand the Configuration panel
7. Change the toggle button next to the cloud service from OFF to ON

You can change which parts of the standard content are activated for each cloud service, activate and deactivate alerts or create own alerts with specific filters. 

1. In the configuration panel, click on the name of the cloud service
2. The "Configuration of Services" screen opens
3. In the "Configuration for Services" screen, click the > button at the end of the line for the cloud service you want to change

Adjust Monitoring Categories

1. Use the toggle button in the column Active to turn a monitoring category ON or OFF

Adjust Alerting

1. Use the toggle button in the column Active to turn a standard alert ON or OFF
2. Press the > button at the end of the line to access the detail setup for an existing alert or use the + button to create a new alert
3. Adjust the display name if desired
4. Expand the Filter Configuration tray
5. Enter a filter name
6. Select the filter category
7. Maintain the available filter fields (see details below)

Available Alerts for SAP Business Technology Platform - Cloud Foundry

• Erroneous Alert Notification (Alert notifications w/o close event)
• Erroneous Stateful Alert Notification (Alert notification w/ close event)

Available Filter Fields for SAP Business Technology Platform - Cloud Foundry

The filter fields depend on the monitoring category the alert is created for and additional on the filter category, if there is more than one available.

Alert Notifications

• Body: Alert Notification long text
• Category: ALERT, EXCEPTION, NOTIFICATION
• Event Type: Type of the event (Find more information here)
• Resource Name: Name of the resource causing the event 
• Resource Group: Name of the resource group causing the event 
• Severity: ERROR or WARNING
• Source Event ID: ID of the source event
• Status: Errors, Warnings, Resolved
• Subject: Alert notification short text