SAP Cloud Platform Integration

Available Monitoring Content

The following monitoring content is available for SAP Cloud Platform Integration:

CategoryTypeDescription
SAP Cloud Platform IntegrationMessagesMonitors status and performance of single messages send in SAP CPI
Integration Artifacts ExceptionsMonitors for exceptions in IFlows that render them not operational, like e.g. mapping errors

Setup Steps in SAP Cloud Platform Integration

Create Communication User

If you plan to use BASIC authentication to connect to SAP Cloud ALM to SAP CPI you need to create a communication user in SAP CPI.

  • 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: 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 

Gather Information for OAuth Authentication

If you want to use OAuth authentication instead of basic authentication to connect to SAP Platform Integration, you can find the necessary connection information here:

  1. Go to the SAP Cloud Platform Cockpit
  2. Navigate to Security → OAuth
    • OAuth URL: The 'Token Endpoint' URL on the branding tab
  3. Select the client you want to use on tab 'Clients'
    • Client ID: The content of the field ID
    • Client Secret: The content of the field Secret 

Setup Steps in SAP Cloud ALM

Create HTTP End-Point

You have to create two endpoints for the SAP Cloud Platform 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 Cloud Platform 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"
  7. Choose your authentication method and enter the respective connection information
    1. For BASIC authentication enter the user and password created in SAP CPI
    2. For OAuth authentication enter the Token Service URL, client ID and client secret
  8. Repeat the steps above for the use-case "Exception Monitoring"

Activate Monitoring (Standard)

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

  1. Open the Integration 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 Cloud Platform 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

Available Filter Fields for SAP Cloud Platform Integration

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

  • Integration Artefact 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