Setup for SAP Integration Suite (Cloud Integration) on Cloud Foundry

This page explains how to connect SAP Integration Suite (Cloud Integration) running on Cloud Foundry (Multi-Cloud) to SAP Cloud ALM to enable monitoring.

Currently, the following monitoring applications are supported for SAP Integration Suite (Cloud Integration):

Setup Video

The following video demonstrates the setup steps to set up Integration & Exception Monitoring for SAP Integration Suite (Cloud Integration).

A detailed textual description for all setup steps is provided in the sections below the video.

 

Set Up Application Monitoring for SAP Integration Suite (Cloud Integration) running in Cloud Foundry

  • Prerequisites for this video: 
    • You need to have access to SAP BTP Cockpit
    • You user in BTP Cockpit needs to be a member with the member role "Space Developer" for the space in which you want to create the service instance.
    • You need a user with the role "Integration Monitoring Integration Architect" in SAP Cloud ALM.

Prerequisites

  • You need to have access to SAP BTP Cockpit.
  • You need to have an entitlement for the service "Process Integration Runtime" → for the plan "api"
    • You can check this in SAP BTP Cockpit → <Subaccount for Integration Suite> → Entitlements
  • Your user in BTP Cockpit needs to be a member with the space role "Space Developer" for the space in which you want to create the service instance.

Setup Steps in SAP Integration Suite (Cloud Integration)

OAuth Authentication: Prepare and obtain OAuth Credentials

To enable OAuth authentication between SAP Cloud ALM and SAP Integration Suite (Cloud Integration), you must create an instance with a service key for the Process Integration service with the necessary authorizations. 

To create the instance in the space for your SAP Integration Suite (Cloud Integration), you need "Space Developer" access to this space.

Create Service Instance

You can use the same instance for all supported use cases. Make sure to select the appropriate roles in the step 'Parameters' during the instance creation.

  1. Go to SAP BTP Cockpit → Access the sub-account used for SAP Cloud Integration
  2. Go to "Instances and Subscriptions"
  3. Click the "Create" button to create a new instance
  4. Basic Info
    1. Service: Process Integration (it-rt)
    2. Plan: api
    3. Runtime Environment: Choose Cloud Foundry
    4. Space: Select the appropriate space (depending on your company)
    5. Instance Name: Enter an instance name
    6. Click "Next"
  5. Under "Parameters", select the roles:
    1. To use Integration & Exception Monitoring
      1. "MonitoringDataRead"
      2. "MonitoringArtifactsDeploy"
    2. To use Health Monitoring
      1. "HealthCheckMonitoringDataRead"
  6. Click "Create" to create the instance

Create Service Key

After the instance is created, you can add the service key.

  1. Select the row of the instance
  2. Go to tab "Service Keys"
  3. Click "Create"
  4. Enter a name for the service key
  5. Click "Create"
Download the service key file. You will need the information in the file later when creating the end-point in SAP Cloud ALM.

Create HTTP Endpoint

Before starting the setup, ensure that your cloud service was successfully imported from the System landscape Information Service (SLIS).

If you have more than one entry in LMS with the same name, please choose the one for which the tenant and the host part of the root URL match the parameter "url" in the service key.

You can use the same endpoint for all supported use cases.

  1. Open the Landscape Management application from the launchpad
  2. Select your SAP Integration Suite (Cloud Integration) service
    • Select the cloud service with the service type "SAP Integration Suite (Cloud Integration)". The cloud service name will be the tenant ID. 
    • Do not choose the service with the service type "SAP BTP Cloud Foundry environment" even if the cloud service name contains "Cloud Platform Integration"
  3. Press the ">" button at the end of the line
  4. On the tab "Endpoints", press the "Add" button to create a new endpoint
  5. Enter a description
  6. Choose the use-cases you want to use
    1. For Integration & Exception Monitoring, select: "Integration Monitoring" and "Exception Monitoring"
    2. For Health Monitoring, select: "Health Monitoring"
  7. Ensure that the Root URL does not contain the path "/itspaces". You may overwrite the value in the field "Root URL" with the value of the parameter "url" in the service key.
  8. Choose OAuth2ClientCredentials: Enter the following values from the SAP Integration Suite service key
    1. Client ID: clientid
    2. Client Secret: clientsecret
    3. Token Service URL: tokenurl
  9. Save your endpoint

Next Steps

After creating the endpoint in SAP Cloud ALM, you have to perform the following steps to activate the monitoring use-cases: