SAP Integration Suite – Cloud Integration

Available Monitoring Content

The following monitoring content is available for SAP Integration Suite – Cloud Integration:

CategoryTypeDescription
SAP Integration Suite MessagesMessagesMonitors status and performance of single messages send in SAP Integration Suite - Cloud Integration
Integration Artifact DeploymentsExceptionsMonitors for exceptions in IFlows that render them not operational, like e.g. mapping errors

Setup Steps in SAP Integration Suite – Cloud Integration

Prerequisites

Before you can start the setup in SAP Integration Suite - Cloud Integration you have to gather some information on your companies SAP Cloud Integration tenant.

Depending you your findings the setup will have to be performed in different ways.

Find your Operations Platform

Identify whether your SAP Integration Suite – Cloud Integration tenant runs on Neo or on SAP Cloud Foundry. To do so please check the URL of your tenant:

  • URL of a Neo tenant looks like: https://<tenant Id>-tmn.hci.<landscape>.hana.ondemand.com/
  • URL of a Cloud Foundry tenant looks like: https://<tenant Id>.<system id, e.g. it-cpi001>.cfapps.<landscape>.hana.ondemand.com/
Find your ID Provider

Check if your tenant uses the SAP ID service or a custom Identity Provider (IdP). 

  • Go to the SAP BTP Cockpit → Access the subaccount used for SAP Cloud Integration → Security → Trust Configuration 
  • Check if a custom IdP is used. If there is only the "Default Identity Provider" you are using the SAP ID Service.

Restrictions for SAP Integration Suite – Cloud Integration on Cloud Foundry

Please note that customers that are running SAP Integration Suite – Cloud Integration in Cloud Foundry and use a Customer IdP (Identity Provider) for authentication, cannot use BASIC authentication to connect to SAP Integration Suite – Cloud Integration via HTTP end-point. 

These customers can only use OAuth authentication in their end-point for now.

See limitations documented in SAP note 2752867.

Choose your Authentication Method

You can choose between BASIC authentication and OAuth authentication to connect SAP Integration Suite - Cloud Integration to SAP Cloud ALM. 

  • BASIC Authentication requires a dedicated user in SAP Integration Suite - Cloud Integration. The password for this user needs to be changed regularly. However the initial setup is less complex
  • OAuth Authentication doesn't require a user, but the initial setup is a bit more complicated

Create Communication User (BASIC Authentication)

If you plan to use BASIC authentication to connect to SAP Cloud ALM to SAP Integration Suite – Cloud Integration you need to create a communication user in SAP CI.

The user can be a company S-user. Please contact your companies S-User super-admin to request a new S-user for this purpose.

  • The user will be maintained in the HTTP endpoint and must be must have a role which contains the following privilege:
    • In the Neo environment:
      • IntegrationOperationServer.read
      • NodeManager.read
    • In the Cloud Foundry environment:
      • MonitoringDataRead
  • For more information about default role assignments, please refer to SAP Integration Suite – Cloud Integration documentation: https://help.sap.com/viewer/product/CLOUD_INTEGRATION/Cloud/en-US?task=operate_task → Security → Select the link for your platform → Identity and Access Management → Persona → Tasks and Permissions 

Note: Users in SAP Integration Suite – Cloud Integration on Cloud Foundry

Please note that users in SAP Integration Suite – Cloud Integration running on Cloud Foundry are identified by their email address. This also applies to S-Users. This means:

  1. To adjust the authorizations of a user, please search for it by its email address. 
  2. When setting up the end-point for a SAP Integration Suite – Cloud Integration tenant running on Cloud Foundry please provide the email address when using basic 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. 

Create Service Instance

  1. Go to your SAP BTP Cockpit → Access the subaccount 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 or Neo
    4. Space: Select the appropriate space (depending on your company)
    5. Instance Name: Enter an instance name
    6. Click 'Next'
  5. Parameters
    1. Select the role "MonitoringDataRead" in the 'Roles' drop-down on the Form tab
    2. Click "Create 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.
 

Setup Steps in SAP Cloud ALM

Create HTTP End-Point

You have to create two endpoints for the SAP Integration Suite – Cloud Integration service. One for the use-case "Integration Monitoring" and one for the use-case "Exception Monitoring".

  1. Open the Landscape Management application from the launchpad
  2. Select your SAP Integration Suite – Cloud Integration service
  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-case "Integration Monitoring" and "Exception Monitoring"
  7. Make sure that the Root URL does not contain the itspaces suffix
  8. Choose your desired authentication type:
    1. You can use BASIC authentication for SAP Integration Suite – CI on Neo: Enter the user and password created in CPI
    2. You can use OAuth authentication for both SAP Integration Suite – CI on Neo or on Cloud Foundry: Enter the OAuth information from the service key file in the respective input fields

Activate Monitoring (Standard)

In SAP Cloud ALM you can easily activate the standard monitoring content without any additional setup effort. 

  1. Open the Integration & Exception Monitoring application from the launchpad
  2. The scope selection will appear automatically
  3. Change the drop-down for Display Service to "All"
  4. Make sure to select your cloud service in the scope
  5. Click the Configuration button in the upper right corner to access the configuration
  6. Expand the Configuration panel
  7. Change the toggle button next to the cloud service from OFF to ON

Adjust Monitoring and Alerting (Expert)

You can change which parts of the standard content are activated for each cloud service, activate and deactivate alerts or create own alerts with specific filters. 

  1. In the configuration panel, click on the name of the cloud service
  2. The "Configuration of Services" screen opens
  3. 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

  1. Use the toggle button in the column Active to turn a monitoring category ON or OFF

Adjust Alerting

  1. Use the toggle button in the column Active to turn a standard alert ON or OFF
  2. 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
  3. Adjust the display name if desired
  4. Expand the Filter Configuration tray
  5. Enter a filter name
  6. Select the filter category
  7. Maintain the available filter fields (see details below)

Available Alerts for SAP Integration Suite – Cloud Integration

  • Erroneous CPI Message Detected: Creates an alert for each failed message in SAP CPI
  • Erroneous CPI Messages Detected: Creates an alert if one or more failed messages on SAP CPI were detected since the last data collection
  • Erroneous Integration Artifact: Creates an alert for an artifact deployment in error state
  • Erroneous Integration Artifact Stateful Alert Notification: Creates an alert for an artifact deployment alert notification

Available Filter Fields for SAP Integration Suite – Cloud Integration

SAP Integration Suite Messages

You can choose one or more filter fields to restrict the messages for which an alert will be created.

  • Integration Artifact Name: Name of the IFlow sending the message
  • Status Detail: Filter on the detailed error message
  • Status: Last status of the message, use input help to select the desired filter value
  • Status Group: Status group of the message status, use input help to select the desired filter value
  • Direction: INBOUND or OUTBOUND
Integration Artifact Deployments
  • Artifact Name: Name of the Integration Artifact
  • Artifact ID: ID of the Integration Artifact
  • Status: Status of the artifact