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 application 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 textual step by step 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 need to create an instance with a service key for the Process Integration service with the necessary authorizations. 

To be able 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 create 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 you create the end-point in SAP Cloud ALM.

Create HTTP End-Point

Before you can start the setup make sure that your cloud service were 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 matches 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
    • Make sure to select the cloud service with 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 end-point
  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. Make sure 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

Please refer back to the use-case specific setup pages for additional steps necessary to activate the single use-cases.