SAP Cloud Platform (Neo)
Available Monitoring Content
| Category | Type | Description |
|---|---|---|
| Alert Notifications | Exceptions | Collects events sent from the Alert Notification Service |
| Java Neo Application | Exceptions | Collects exceptions in Java Logs for applications running in SAP Cloud Platform |
Setup Steps in SAP Cloud Platform (Neo)
Preparations for Java Application Error Monitoring
Determine Root URL
The API Root URL for SAP Cloud Platform depends on the host on which your account is hosted on. The host depends on the region as described here:
- SAP Cloud Platform Regions (e.g. If your host is us1.hana.ondemand.com, the Root URL to configure is https://publicapingplog.us1.hana.ondemand.com)
Create User for Java Log Monitoring
To connect to SAP Cloud Platform to collect Java application exceptions you need to provide Focused Run with a user that is allowed to read the default trace.
- The user needs at least the role 'Support User' in SAP Cloud Platform
Write Java Errors into Default Trace
This last preparation step starts already during the development of the SAP Cloud Platform application. To be able to collect application errors, these errors must exist in the default trace for the SAP Cloud Platform java application. Hence developers must write meaningful errors in this trace. The quality of the monitored exceptions completely depends on the quality of the exceptions written by the developer.
- Please see this blog for more information on logging for SAP Cloud Platform Java applications
Preparations for Alert Notifications
Enable SAP Cloud Platform Alert Notifications
Receiving alert notifications is done via the Alert Notification Service which can be enabled for your SAP Cloud Platform account.
Important: Please be aware that the use of this service is quota based (billable)!
To enable the service please follow the documentation:
Gather Connection Information
To authenticate towards the service you have to create an OAuth client in SAP Cloud Platform. Information how to do this you find here:
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.
- In your Subaccount navigate to Services → Alert Notification → Security
- Root URL: Use 'Consume Events' URL under Endpoints (up to .com)
- OAuth URL: Use 'OAuth Token' under Endpoints (full URL)
- Client ID: Use 'Client ID' of the created OAuth client
- Client Secret: Use client secret noted down during client creation
Setup Steps in SAP Cloud ALM
Create HTTP End-Points
You have to create two endpoints for the SAP Cloud Platform service. One for the collection of Java exceptions and one for Alert Notifications.
- Open the Landscape Management application from the launchpad
- Select your SAP Cloud Platform (Neo) service
- Press the > button at the end of the line
- On the tab "Endpoints" press the Add button to create a new end-point
- Enter a description
- Choose the use-case "Exception Monitoring"
- The Root URL will differ between the end-point for Java exceptions and Alert Notifications:
- Enter the Root URL that you determined earlier for the Java API or the 'Consume Events' URL
- Choose your authentication method and enter the respective connection information
- For Java Exceptions: Choose BASIC authentication and enter the user and password created in SAP CP
- For Alert Notifications: Choose OAuth authentication and enter the Token Service URL, client ID and client secret
- Repeat the steps above for the second end-point.
Activate Monitoring and Alerting
Because you have to choose the correct end-point for each of the categories in SAP Cloud Platform (Neo) you have to activate the monitoring manually.
- Open the Integration Monitoring application from the launchpad
- The scope selection will appear automatically
- Change the drop-down for Display Service to "All"
- Make sure to select your cloud service in the scope
- Click the Configuration button in the upper right corner to access the configuration
- Expand the Configuration panel
- In the configuration panel, click on the name of the cloud service
- The "Configuration of Services" screen opens
- 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
- Use the toggle button in the column Active to turn a monitoring category ON or OFF
- Choose the correct end-point for each category
Adjust Alerting
- Use the toggle button in the column Active to turn a standard alert ON or OFF
- 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
- Adjust the display name if desired
- Expand the Filter Configuration tray
- Enter a filter name
- Select the filter category
- Maintain the available filter fields (see details below)