SAP Cloud Platform Integration

SAP Cloud Platform Integration (f.k.a. SAP HANA Cloud Integration) is a technology used to integrate processes and data between SAP cloud applications, 3rd party applications and on-premise solutions. We can monitor this integration with Interface and Connection Monitoring and Exception Management by monitoring the iFlows inside SAP Cloud Platform Integration and create alerts in case of errors or performance problems.

Technical Prerequisites

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

Requires at least SAP Solution Manager 7.1 SP12 or SAP Solution Manager 7.2 SP03
Import Cloud Service SSL Certificate into SAP Solution Manager

Import Cloud Service SSL Certificate

In the context of Hybrid Scenarios, data collectors are connecting from Solution Manager to the Cloud Service provider, in order to collect exceptions and/or statistical data. To allow this outgoing connection from Solution Manager, the SSL Certificate of the Cloud Service provider has to be imported in Trust Manager (STRUST).

Open the cloud service URL in a browser
Click 'View' → 'Security Report' or click the padlock next to the URL in the address input field
Click 'View certificates'
Switch to the 'Details' tab and click 'Copy to File...'
Export the certificate in 'Base-64 encoded X.509 (.CER)' format
Log on to SAP Solution Manager and go to transaction STRUST
Import the certificate to 'SSL client SSL Client (Anonymous)'

Available Monitoring Content

SAP Cloud Platform Integration represents the integration layer of a hybrid scenario. Monitoring it is relevant for all hybrid scenarios using this integration form.

For the SAP Cloud Platform Integration scenario the following monitoring content is relevant:

Scenario Component	Monitoring Object	Description	Monitoring Template	Since SP
Integration	Exceptions in SAP CPI	Exceptions in iFlows in SAP Cloud Platform Integration for the integrated scenario	Cloud (SAP HCI)	7.1 SP12*

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

The metrics for SAP Cloud Platform Integration are maintained in the template with the name SAP HCI, as the solution was formerly called SAP HANA Cloud Integration.

Which iFlows are relevant to monitor depends on the cloud scenario that is integrated via SAP CPI. Please check the portal pages for the respective cloud solution (e.g. SAP C4C, Success Factors etc.)

Monitoring Template: Cloud (SAP HCI)

Metric Name	Description	MAI Category	Since SP
Number of erroneous iFlows in HCI (Delta)	Number of erroneous iFlows detected in SAP HANA Cloud Integration. The exceptions are retrieved from HCI via the central Exception Management in Solution Manager.	Exceptions	7.1 SP12
Number of erroneous iFlows in HCI (last 24h)	Number of erroneous iFlows detected in SAP HANA Cloud Integration during the last 24h. The exceptions are retrieved from HCI via the central Exception Management in Solution Manager.	Exceptions	7.1 SP12
Number of erroneous iFlows in SAP HCI - Delta	Number of erroneous iFlows detected in SAP HANA Cloud Integration. The exceptions are retrieved directly from SAP CPI. Exception Management setup is not necessary for this metric.	Exceptions	7.1 SP13
Number of erroneous iFlows in SAP HCI - last 24h	Number of erroneous iFlows detected in SAP HANA Cloud Integration during the last 24h. The exceptions are directly retrieved from SAP CPI. Exception Management setup is not necessary for this metric.	Exceptions	7.1 SP13
Average Response Time of iFlows in SAP HCI	Interface Channel (HCI) Response Time in sec collected from SAP CPI. Exception Management setup is not necessary for this metric.	Performance	7.1 SP13
Average Response Time of iFlows in SAP HCI per iFlow	Average HCI Response Time per iFlow in sec collected from SAP CPI. Exception Management setup is not necessary for this metric.	Performance	7.1 SP13
Number of iFlow executions in SAP HCI	Number of iFlow executions retrieved directly from SAP CPI. Exception Management setup is not necessary for this metric.	Performance	7.1 SP13

Configuration

Step 1: Define Cloud Service in SAP Solution Manager

You need the following information to create the SAP Cloud Platform Integration service:

User
Password
Main URL (e.g. https://<myhost>.hana.ondemand.com)

SAP CPI User Credentials

The user will be maintained in the HTTP endpoint and must be must have a role which contains the following privilege: IntegrationOperationServer.read

For more information about default role assignments, please refer to SAP Cloud Platform Integration documentation: SAP Cloud Platform Integration - Tasks and Required Roles at: https://help.sap.com/viewer/368c481cd6954bdfa5d0435479fd4eaf/Cloud/en-US/289ef3f8cfad442ea86fe0d5ddad8c42.html

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

Create Cloud Service:

Select 'Cloud Service Operations' → Create Cloud Service
Select Service Type: 'SAP Cloud Platform Integration' from the drop-down list.
Define Service:
- Tenant: The SAP HANA Cloud Integration tenant ID. This information is not necessarily provided by SAP. You may choose to document here a relevant identifier for your Cloud Service.
Define Root URL: Enter the <Main URL> as Tenant Management Node URL.
- You can also adjust the extended service ID (The ID used as SID in LMDB) here.
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:

Select your SAP CPI cloud service from the list and click 'Configure Cloud Service'
Configure Endpoints: Click the 'Add' button on the 'HTTP Endpoints' tab.
Enter the following information:
- Description: A meaningful description
- User: <User>
- Password: <Password>
- If necessary add proxy information to connect to CPI

Step 2: 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.

Setup of Exception Management

For SAP CPI you only have to configure Exception Management, if you want to be able to analyze the single exceptions in SAP Solution Manager. Some metrics available for SAP CPI do not require the Exception Management setup. Check the list of available metrics for details.

Configuration for HANA Cloud Integration

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

In the step 'Define Scope' select the tab 'Cloud Services' and your SAP CPI 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'.
Click 'Add / Configure Log Store'. Select 'SAP Cloud Platform Integration from HCI'. Select the correct end-point for the SAP CPI cloud service if you have more than one.
Select the fields for filtering for your log store. The following filter fields are available:
- iFlow ID: Name of the Artifact ID for which you want to receive exceptions
- Message: Filter on the error message
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.
Once you are done with the Log Store setup click 'Next' to go to the alert configuration. The alert configuration is done in the 'Interface and Connection Monitoring' described in the next section.

Step 3: 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 HCI)

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

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

Create the Interface Channel:

Select the scenario and click 'Next'
In step 'Preparation' perform all relevant manual activities and run all automatic activities.
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 HCI)'
- Description: Enter a description for the channel
Click Next.
Source type:
- If the source system is the on premise system, please select 'Technical System'
- If the source system is the SAP CPI system please select 'External Service'
Source: Select the on premise system resp. the SAP CPI Cloud Service from the drop-down list
Target Type:
- If the target system is the on premise system, please select 'Technical System'
- If the target system is the SAP CPI system please select 'External Service'
Target: Select the on premise system resp. the SAP CPI Cloud Service from the drop-down list
The measuring point is selected automatically
If more than one client are connected for the on premise system please select the correct client for the monitoring
Click Next.
Click Finish.

Maintain the Interface:

Select the interface channel you created
On the 'Interfaces' tab click the 'Add' button.
Provide the following information:
- Interface name: Enter a name for the interface
- Endpoint ID (mandatory): Select the end point created for the SAP CPI cloud service
- IFlow ID (mandatory): Enter the name if the IFlow you want to retrieve exceptions for. You can use '*' to collect all exceptions

Select Metrics:

On the tab 'Metrics' select the metrics you want to monitor SAP CPI Metrics

Only the first two metrics on the metric list are retrieved from the SAP Exception Management, the rest of the metrics is collected directly from SAP CPI. For these metrics you must maintain the interface selection criteria if you want to filter by iFlow.

If you choose to use the metrics 3 & 4 to monitor the number of exceptions, you will not have the exception details available in SAP Solution Manager Exception Management, but only get the information how many exceptions occurred.
Save your interface channel by clicking on the 'Save' button.

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:

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 is created for every single exception
Select the Metrics
- You can adjust the thresholds on the tab Thresholds.
- 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.
- Only change the collection interval if you know what you do or if advised to do this by SAP.
Click 'Apply and Activate' → <Choose one option> to activate the monitoring