1. SAP Support Portal Home
  2. Application Lifecycle Management
  3. SAP Solution Manager
  4. Expert Portal
  5. Public Cloud Operations

SAP Cloud Platform

SAP Cloud Platform

SAP Cloud Platform, the in-memory Platform-as-a-Service offering from SAP, enables customers and developers to build, extend, and run applications on SAP HANA in the cloud. It provides access to a development environment in the cloud. The platform includes a comprehensive set of services for integration, enterprise mobility, collaboration, and analytics. 

Integration Scenario

Please, select...

For most cloud services, SAP Solution Manager is able to collect and monitor exceptions happening in the cloud service. But to fully monitor a cloud service scenario it is also important to monitor the integration between the cloud service and the on-premise backend system. This integration consists of different point-to-point interfaces of different usually more traditional types.

The following section describes the different integration options for the cloud service. Please choose the integration option you are using and consider also setting up the monitoring for the relevant interface types that are part of the integration scenario for the cloud service.

On this page we describe the monitoring setup this specific cloud service type. For information on how to set up the monitoring for the interface types supporting the integration, please refer to the setup documentation of the respective interface type which you can here.

 

For SAP Cloud Platform the following integration scenarios are possible:

The different scenarios contain the following exceptions and point-to-point connections:

  1. Integrating SAP Cloud Platform via SAP Cloud Platform Integration: 1, 3
  2. Integrating SAP Cloud Platform via SAP Cloud Platform Integration for data services: 1, 2
  3. Integrating SAP Cloud Platform via SAP Cloud Connector Integration: 1, 4 
 

Scenario Components Monitored Content Interface Channel Type Since SP
1  Cloud Services: SAP Cloud Platform Application errors and alert notifications from SAP CP Cloud: Cloud (SAP Cloud Platform) 7.2 SP03
2  Cloud Services: SAP Cloud Platform Integration for data services Exceptions in tasks in SAP CPI for data services Cloud: Cloud (SAP HCI DS)  7.2 SP03 
3  Cloud Services: SAP Cloud Platform Integration Exceptions in integration flows (iFlow) in SAP CPI Cloud: Cloud (SAP Cloud Platform Integration) 7.1 SP12*
4  On-premise: SAP Cloud Connector  Availability and Performance for SAP Cloud Connector  Available monitoring content in System Monitoring  7.2 SP06 

*) Monitoring content was extended with later support packages (see monitoring template page for details)

Technical Prerequisites

The following technical prerequisites have to be met in order to monitor this scenario:

  • Monitoring of Java Applications in SAP CP (Neo): 
    • Is available starting from SAP Solution Manager 7.2 SP03
  • Receive alerts from the Alert Notification Service for SAP CP (Neo and Cloud Foundry):
    • Is available starting from SAP Solution Manager 7.2 SP08
  • E2E Application Tracing:
    • Is supported for SAP Cloud Platform from March 2018 onwards, and requires at least SAP Solution Manager 7.2 SP06
 

Available Monitoring Content

The following SAP Cloud Platform scenarios are currently covered in public cloud operations with SAP Solution Manager:

  • Monitoring of Java application errors in Java application developed on SAP Cloud Platform in the Neo environment
  • Alerts from the Alert Notification Service provided in SAP Cloud Platform for both the Neo as well as the Cloud Foundry environment
  • End-to-End Tracing capabilities for application running in SAP Cloud Platform in the Neo environment

The collection of exceptions and alert notifications is performed using Exception Management. The metrics to monitor if there were any exceptions or alert notifications are available in a template in Interface and Connection Monitoring.

Monitoring Template: Cloud (SAP Cloud Platform) 

Metric Name Description MAI Category Since SP

Number of exceptions in SAP CP Java Applications (Neo)

Number of Java application errors collected from the SAP Cloud Platform. These statistics is retrieved from central Exception Management in Solution Manager. Data Collection is executed in delta mode.

The statistics are based on single exceptions which are retrieved via an API from SAP CP into central Exception Management in Solution Manager

Exceptions

 7.2 SP03

Single exceptions in SAP CP Java Applications (Neo)

Single exceptions detected in SAP CP. Exceptions are retrieved via an API from SAP CP into central Exception Management in Solution Manager. Data Collection is executed in delta mode.

Exceptions

 7.2 SP03
Alert Notifications received from SAP CP Alert Notifications received from SAP Cloud Platform Exceptions 7.2 SP08

Tracing Capabilities

Trace Analysis, also allows you to trace end-user requests having excessive execution times, showing performance metrics, like application response time, interactions between UI and SAP Cloud Platform, and outbound communications. 

The trace is collected from the backend system(s) as well as from the application running in SAP Cloud Platform. The SAP passport allows SAP Solution Manager to correlate the related steps over all components and display the complete end-to-end in the End-to-End Trace Analysis application in Root Cause Analysis. 

 
 

Please note that the SAP backend system and all other systems that are part of the trace must be capable to handle SAP passport. You can find information which system types are supported by E2E Trace Analysis in SAP note 2248724 - Root Cause Analysis in SAP Solution Manager 7.2

For SAP Cloud Platform currently the following services are enabled for Trace Analysis. 

 
 

SAP Cloud Platform Service Description Since SP
J2EE Web Profile 6 Support SAP passport forwarding and performance statics 7.2 SP06
SAPUI5 Runtime Support SAP passport forwarding and performance statics 7.2 SP06
Web Tomcat 7 & 8 (with limitations*) Support SAP passport forwarding (with manual tasks) and performance statics 7.2 SP06

(*) Due some technical/feature decisions in Cloud Platform for Runtime based on Tomcat8, the application developer need to take care for the SAP-PASSPORT update/forwarding by using a specific interface - SapPassportHeaderProvider. You can find more information in the SAP Help documentation.

Connect Cloud Service

Please, select...

Public cloud service offerings are usually Software-as-a-Service (SaaS) solutions. This means that customers only have access to the service but not to the underlying infrastructure. Hence, the usual way to connect on-premise managed systems to SAP Solution Manager does not apply to cloud services.

However, to be able to monitor exceptions and performance in cloud services they need to be connected to SAP Solution Manager. This connection is created using the customer and cloud service specific root URL and an end-point definition.

The first step is to import the SSL certificate into SAP Solution Manager. This is valid for all cloud services.

Import Cloud SSL certificate into STRUST

Export Certificate from Browser: 

  1. Open the cloud service URL in your web browser.
  2. Click on the padlock next to the Cloud Service URL (within the address input field).
  3. When using Firefox, click on ‘Show Connection details', ‘More Information', 'View Certificate' and select the ‘Details' tab.
  4. When using Microsoft IExplorer, click on ‘View Certificate' and select the 'Certificate Path' tab.
  5. When using Google Chrome, click on ‘Certificate' and select the 'Certificate Path' tab.
  6. In the displayed certificate hierarchy select the Certification Authority (CA) certificate you plan to trust.
  7. When using Firefox, press ‘Export…'.
  8. When using Microsoft IExplorer or Google Chrome, press ‘View Certificate' and in the displayed pop-up navigate to the ‘Details' tab, to press ‘Copy to File…'.
  9. Select an export format you would like to use and that is supported by STRUST transaction, and export the certificate.

Import Certificate into SAP Solution Manager:

  1. Now, log on to SAP Solution Manager ABAP and go to transaction STRUST.
  2. Switch to Edit.
  3. Double click on entry 'SSL client SSL Client (Anonymous)'.
  4. Import the previously exported CA certificate, by pressing – within section ‘Certificate' – the icon ‘Import Certificate'.
  5. Press ‘Add to Certificate List'.
  6. Finally ‘Save' this modification. 

Additionally you have to perform certain preparations in the cloud service to enable SAP Solution Manager to connect to the cloud service.   

 
 
 
 

Preparations in SAP Cloud Platform (Neo)

The following section described the preparation steps that have to be performed if you run SAP Cloud Platform in the Neo environment. If you run SAP Cloud Platform in the Cloud Foundry environment please go to the next section. 

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 SAP Solution Manager 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 Solution Manager.

  1. In your Subaccount navigate to Services → Alert Notification → Security
  2. Root URL: Use 'Consume Events' URL under Endpoints (up to .com)
  3. OAuth URL: Use 'OAuth Token' under Endpoints (up to .com)
  4. Client ID: Use 'Client ID' of the created OAuth client
  5. Client Secret: Use client secret noted down during client creation

Import the SSL certificate for Cloud Foundry

Even if used in the SAP Cloud Platform (Neo) the alert notification service technically runs in SAP Cloud Platform (Cloud Foundry). To make sure that SAP Solution Manager can receive alert notifications successfully, you have to import the SSL certificate for Cloud Foundry additionally to the SSL certificate for Neo.

  1. In your Subaccount navigate to Services → Alert Notification → Security
  2. Click on the 'Consume Events' URL under Endpoints to open it in a browser
  3. Import the SSL certificate for this website into SAP Solution Manager STRUST as described above 

Preparations for E2E Application Tracing

Enable Automatic Trace Upload for SAPUI5 applications

You can enable the automatic upload of the client side trace data, which starts in the background when a trace is ended. Therefore, perform the following steps in your WebIDE or development platform for the SAPUI5 applications in focus.

Note: This operation has to be repeated for each relevant SAPUI5 application.

  1. Load the SAPUI5 application in your WebIDE
  2. Open the file: neo-app.json
  3. Edit the file, adding a "routes" record, of type destination, as shown here:
    {
      "welcomeFile": "index.html",
      "routes": [
        {
           ...
        }
        {
            "path": "/sap/bc/sdf/E2E_Trace_upl",
            "target": {
                "type": "destination",
                "name": "solutionmanager",
                "entryPath": "/sap/bc/sdf/E2E_Trace_upl"
            },
            "destination": "SAP SolManUpload"
        }
      ]
    }
  4. Save the file
  5. Also maintain the above mentioned destination, within SAP Cloud Platform and SAP Cloud Connector, specifying the SAP Solution Manager relevant gateway host and port.
  6. Finally, deploy the SAP UI5 application again to the SAP Cloud Platform  
 
 
 
 
 
 
 
 
 

Preparations in SAP Cloud Platform (Cloud Foundry)

The following section described the preparation steps that have to be performed if you run SAP Cloud Platform in the Cloud Foundry environment.

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 Solution Manager.

  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 Cloud Foundry doesn't have any available event that come out of the box. Hence to actually receive alerts from application in SAP Cloud Foundry you have to implement the alert creation in your application.

Find more information here:

 
 
 
 

Connect Cloud Service to SAP Solution Manager

The Cloud Services configuration is now accessible from the SAP Solution Manager Configuration (SOLMAN_SETUP) → Managed Systems Configuration → Tab 'Cloud Services'.

Create Cloud Service:

  1. Select 'Cloud Service Operations' → Create Cloud Service
  2. Select Service Type: 'SAP Cloud Platform' from the drop-down list.
  3. Define Service:
    • Environment: Choose Neo or Cloud Foundry
    • Account: The SAP Cloud Platform account name
  4. Define Root URL: Enter the Root URL. For SAP CP (Neo) it doesn't matter if you enter the ANS or the Java Error URL. You have to re-enter the URL in the End-Point creation.
    • You can also adjust the extended service ID (The ID used as SID in LMDB) here.
  5. Confirmation: Check your input values and click 'Finish'

The second step is to create the end-point for the cloud service.

Create the End-Point (Neo):

  1. Select your SAP Cloud Platform cloud service from the list and click 'Configure Cloud Service' 
  2. Configure Endpoints: Click the 'Add' button on the 'HTTP Endpoints' tab.
  3. Enter the following information:
    • API Type:
      • Application Exceptions: for Java error monitoring
      • Alert Notification Service: to receive alert notifications
    • Root URL: Enter the Root URL either for Java error monitoring or for ANS
    • Description: A meaningful description
    • The rest of the fields depends on the API Type:
      • Application Exceptions:
        • User: User provided for Java error monitoring
        • Password: Password of the user
      • Alert Notification Service:
        • OAuth URL: OAuth URL
        • User: Client ID
        • Password: Client secret
    • If necessary add proxy information to connect to SAP Cloud Platform

Please not that you have to create two end-points if you want to monitor Java errors as well as receive alert notifications.

Create the End-Point (Cloud Foundry):

  1. Select your SAP Cloud Platform cloud service from the list and click 'Configure Cloud Service' 
  2. Configure Endpoints: Click the 'Add' button on the 'HTTP Endpoints' tab.
  3. Enter the following information:
    • Root URL: Make sure the Root URL is correct
    • Description: A meaningful description
    • OAuth URL: OAuth URL
    • User: Client ID
    • Password: Client secret
    • If necessary add proxy information to connect to SAP Cloud Platform 
 

Monitoring Configuration

Step 1: Configure Exception Management

After the basic configuration you now have to configure Exception Management, as the exceptions collected via Exception Management and stored in the central exception store are the basis for the Integration Monitoring data collection.

Configuration for SAP Cloud Platform Java Applications

This exception store will only exist if SAP Cloud Platform runs in the Neo environment! 

To access the Exception Management setup please go to transaction SOLMAN_SETUP → Application Operations → Exception Management 

  1. In the step 'Define Scope' select the tab 'Cloud Services' and your SAP CP system. If you didn't configure the system before make sure to select 'All Cloud Services' in the view drop-down. Click on 'Configure' or click 'Next' two times. You will enter the step 'Exception Configuration'.
  2. Click 'Add / Configure Log Store'. Select 'Java Application Logs from SAP Cloud Platform'. Select the end-point you created for Application Exceptions.
  3. Select the fields for filtering for your log store. Which fields are filled and what their content is, is determined by the developer of an application (it is somewhat comparable to the Application Log in ABAP). 
    The following filter fields are available:
    • application: Application Name
    • logger: This field usually contains the area and the application name to identify the origin of the logged problem. Supports wildcards (e.g. com.sap*)
    • message: Error text of the exception. Supports wildcards (e.g. Failed*cache)
    • passportId: The SAP Passport of the exceptions
    • severity: Comma separated list of the severity of the exceptions (e.g. ERROR, FATAL)
    • tenant: The account or sub-account ID for the exception
    • user: The user who triggered the exception
  4. Maintain the filter values for the fields in the Filter Definition panel under the log stores table. You can also add, remove or change filter fields and values later on in the area. You can use different operators for your filter value. You can add more than one filter filed combination per log store. To add an additional filter field combination click on the button 'Add Filter' in the 'Configured Log Stores' panel.
  5. You should not set up the monitoring for the exceptions in the Exception Management. If you activate the monitoring here, you will receive an alert (and if set up this way an email) for every single exception in the application log. Instead we will use Interface and Connection Monitoring to monitor the central exceptions store for exceptions.
 

Java Application Errors

To find out which Java application errors are written for the Java application you want to monitor, you can either ask the developer of the application or check if errors are available in your SAP CP subaccount under:

Applications → Java Applications → Click on the application name → Logging → Default Trace 

 

Configuration for SAP Cloud Platform Alert Notifications

To access the Exception Management setup please go to transaction SOLMAN_SETUP → Application Operations → Exception Management 

  1. In the step 'Define Scope' select the tab 'Cloud Services' and your SAP CP system. If you didn't configure the system before make sure to select 'All Cloud Services' in the view drop-down. Click on 'Configure' or click 'Next' two times. You will enter the step 'Exception Configuration'.
  2. Click 'Add / Configure Log Store'. Select 'Alert notifications from SAP Cloud Platform'. Select the end-point you created for Alert Notification Service.
  3. Select the fields for filtering for your log store.  
    The following filter fields are available:
    • category: ALERT
    • eventType: Event type of the alert (e.g. AverageResponseTime)
    • resourceName: The name of the source
    • severity: ERROR or WARNING
    • subject: <tags.monitoring:type> followed by the human readable form of the eventType property. (e.g. [PROBLEM]: OS MemoryUsage)
  4. Maintain the filter values for the fields in the Filter Definition panel under the log stores table. You can also add, remove or change filter fields and values later on in the area. You can use different operators for your filter value. You can add more than one filter filed combination per log store. To add an additional filter field combination click on the button 'Add Filter' in the 'Configured Log Stores' panel.
  5. You should not set up the monitoring for the exceptions in the Exception Management. If you activate the monitoring here, you will receive an alert (and if set up this way an email) for every single exception in the application log. Instead we will use Interface and Connection Monitoring to monitor the central exceptions store for exceptions. 
 

Catalog of Available Events for the Neo Environment

For the Neo environment several alerts are already available and ready to use. You can find the full catalog of available events for the Neo environment here. 

 

Step 2: Configure Interface and Connection Monitoring

The last step is the configuration of Interface and Connection Monitoring. The Interface and Connection Monitoring setup can be accessed via SAP Solution Manager Configuration (SOLMAN_SETUP). 

Configuration for Monitoring Template: Cloud (SAP Cloud Platform)

To access the Integration Monitoring setup please go to SAP Solution Manager Configuration (SOLMAN_SETUP) → Application Operations → Integration Monitoring → Interfaces and Connections. 

Navigate to the step 'Define Scope'. You can create a new scenario for the SAP CP monitoring or use an existing one. Make sure the on premise system for the SAP CP scenario and the Cloud Service created for SAP CP is part of the Interface and Connection Monitoring scenario. 

Create the Interface Channel:

  1. Select the scenario and click 'Next'
  2. In step 'Preparation' perform all relevant manual activities and run all automatic activities.
  3. In step 'Configuration' click the 'Add' button.
    • Channel Name: Enter a meaning full name (max. 30 characters)
    • Type: Select 'Cloud'
    • Monitoring Template: Select 'Cloud (SAP Cloud Platform)'
    • Description: Enter a description for the channel
  4. Click Next.
  5. Source type:
    • If the source system is the on premise system, please select 'Technical System'
    • If the source system is the SAP CP system please select 'External Service'
  6. Source: Select the on premise system resp. the SAP CP Cloud Service from the drop-down list
  7. Target Type:
    • If the target system is the on premise system, please select 'Technical System'
    • If the target system is the SAP CP system please select 'External Service'
  8. Target: Select the on premise system resp. the SAP CP Cloud Service from the drop-down list
  9. The measuring point is selected automatically
  10. If more than one client are connected for the on premise system please select the correct client for the monitoring
  11. Click Next.
  12. Click Finish.

Maintain the Interface:

  1. Select the interface channel you created
  2. The interface channel type does not have any configurable parameters on the 'Interfaces' tab

Select Metrics:

  1. On the tab 'Metrics' select the metrics you want to monitor
  2. Enter Metric Parameters
    • Number of exceptions in SAP CP Java Applications (Neo) & Single exceptions in SAP CP Java Applications (Neo)
      • Application: Application name
      • Logger: This field usually contains the area and the application name to identify the origin of the logged problem. Supports wildcards (e.g. com.sap*)
      • Message: Error text of the exception. Supports wildcards (e.g. Failed*cache)
      • Runtime: Choose 'Java'
      • Severity: Comma separated list of the severity of the exceptions (e.g. ERROR, FATAL)
      • User: The user who triggered the exception
      • Tenant:  The account or sub-account ID for the exception
    • Alert Notifications received from SAP CP
      • Category: ALERT
      • Event Type: Event type of the alert (e.g. AverageResponseTime)
      • Resource Group: The Neo subaccount for which you receive a notification.
      • Resource Name: The name of the source
      • Severity: ERROR or WARNING
      • Subject: <tags.monitoring:type> followed by the human readable form of the eventType property. (e.g. [PROBLEM]: OS MemoryUsage)
  3. Save your interface channel by clicking on the 'Save' button. 
 
 
 
 

Filter Values in Interface and Connection Monitoring

Since the data collection is based on the content of the global exceptions store, you can always check the collected exceptions in Exception Management. All filter parameters are part of the collection context of the exceptions. The filters applied in Interface and Connection Monitoring allow you to filter the exceptions collected by the Exception Management further. However if the filters in Exception Management do not collect an exception, it is not available in the central exception store and you will not be able to find it in Interface and Connection Monitoring!

 

You can maintain attributes as described in the Interface and Connection Monitoring Setup on the tab 'Attributes'.

Thresholds and the collection schedule are maintained in the next step of the guided procedure. Once you have maintained all your channels, click 'Next' in the main guided procedure to move to the step 'Activation'.

Maintain Thresholds and Schedule:

  1. Select the Alert for the interface channel (the alert is the line with the red flash icon next to it)
    • On alert level you can maintain notification and incident message creation
    • Do not remove the flag for 'Do not Group Individual Occurrences' as this flag ensures that an alert each time new exceptions are found during a data collection interval
  2. Select the Metrics
    • Do not change the data collector type or data collector name on the tab 'Data Collection' as the monitor will not work anymore if this is changed.
    • Do not change the threshold if it is set to 'Already Rated'.
  3. Click 'Apply and Activate' → <Choose one option> to activate the monitoring
 

E2E Application Tracing

Trace Preparation: Activate Java Statistics in SAP Cloud Platform

To collect also the Java application part of a trace you need to activate the statistics for the Java application that you want to trace in SAP Cloud Platform.

Note: You need the role 'Developer' to start the statistics collection 

  1. Navigate to you Subaccount in SAP Cloud Platform
  2. Go to Applications → Java Applications → Click on the name of the application you want to trace
  3. Go to Monitoring → JMX Console
  4. Find the MBean com.sap.js
  5. Select Statistics → Statistics
  6. Select 'Operations'
  7. Set 'Enable Tracing' = true
  8. Click the 'Execute' symbol 
 

For more information on the E2E Trace functionality and further prerequisites in SAP Solution Manager please refer to Using Trace Analysis. 

Tracing SAP UI5 Applications

You can start Trace Analysis for any SAPUI5 application, using the Diagnostics functionality, as described in the help portal (<Alt>+<Shift>+<Ctrl>+S key combination).  Note: For mobile devices, refer to Mobile Diagnostics.

  1. In the Diagnostics window that pops-up, open the Technical Information section, and scroll to the bottom of that section to find the E2E Trace sub-section.
  2. Select the desired Trace Level (LOW|MEDIUM|HIGH)
  3. Press the Start button
  4. In the Window of the SAP UI5 application you can now perform the actions you want to trace. 
    Note: After each interaction with the SAP UI5 application you need to wait for a until a pop-up appears, asking if you want to continue tracing or not.
  5. Press cancel, when you want to end tracing.
  6. After having ended the tracing, it is important to reload the SAPUI5 application, to be able to proceed using that application.

Important: Make the end-user starting a trace aware that his provided user-id is recorded in involved systems, as part of the trace data.