Integration & Exception Monitoring - Setup & Configuration


Before you can set up Integration & Exception Monitoring in SAP Cloud ALM, you have to connect your subscribed SAP cloud services to your SAP Cloud ALM instance. 

This is done by setting up the Landscape Management Service. Please follow the Setting Up Landscape Management guide in SAP Help  on how to perform the setup.

Monitoring Configuration

Configure Data Collection and Alerting

The following video describes:

  • How to activate or deactivate the monitoring data collection for a managed cloud service
  • How to create additional alerts for a cloud service
  • How to create notifications for the alert

Attention: The setup of alerts and notification has recently changed. Please follow the written documentation below this video to learn about the new process.

Prerequisites for the video:

  • You need one of the following the SAP Cloud ALM roles
    • Integration Architect
    • Integration Owner
    • Global Administrator
  • Make sure that the cloud service you want to configure is successfully connected to SAP Cloud ALM

Activate the Monitoring Data Collection

The data collection for all monitoring categories available for a managed system or service can be activated directly in the configuration tray in Integration & Exception Monitoring.

  1. Open the Integration & Exception Monitoring application from the launchpad
  2. Open the scope selection via the bulls-eye icon in the upper right corner
  3. Change the drop-down for "Display Service" to "All"
  4. Select the cloud service you want to set up in the scope
  5. Click "Apply"
  6. Click the rack-wheel icon in the upper right corner to access the configuration
  7. Expand the "Configuration" tray
  8. Change the toggle button next to the cloud service you want to set up from OFF to ON

Customize the Monitoring Data Collection

It is possible to customize the data collection for the managed services and systems by:

  • Activating or deactivating single monitoring categories
  • Adding filters to monitoring categories to collect only a subset of the messages or exceptions
  • Configure the collection of payload data for the categories IDoc and Web Services
  1. In the configuration tray, click on the name of the managed service or system
  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 service or system you want to change
  4. Use the toggle button in the column Active to turn a monitoring category "ON" or "OFF"
  5. To add filters on the data collection level access the filter configuration click on the > button at the end of the line for the category
    1. Click the "Add" button to create a new filter
    2. Enter a filter name
    3. Select the filter category
    4. Enter the filter parameters
    5. Press "Save"

Create Monitoring Events

Events are used to trigger a reaction if Integration & Exception Monitoring detects a situation that requires attention. These reactions can be an alert, sending a notification and/or triggering an operation flow.

  1. Navigate to the "Events" tab
  2. Use the toggle button in the column Active to turn on of off a predefined event
    1. You can change the setting of a predefined event by clicking on the > button at the end of the line
    2. Press the > button at the end of the line to access the detail setup for an existing event
  3. Use the "Add" button to create a new event
  4. Select the event you want to set up from the "Event Name" drop-down box
  5. Adjust the default "Display Name" to a descriptive name
  6. Expand the Event Actions tray. Trigger the desired action by switching them ON or OFF using the slider button:
    1. You can create an alert that will show up in the applications alert inbox
    2. To send an email, select the recipients from the list of verified recipients by click the '+' button
    3. To start an operations flow, select the relevant operations flow from the list of available flows using the '+' button
  7. Add filters to your event, to restrict the messages you react to.
  8. Expand the Filter Configuration tray
    1. Enter a filter name
    2. Select the filter category
    3. Maintain the available filter fields. Which filter fields are available depends on the managed service and system and the selected category.
  9. Save your changes.

Scenario Configuration

A scenario in Integration & Exception Monitoring of SAP Cloud ALM allows you to group point-to-point interfaces that belong to a more complex interface scenario. All connections that are part of a scenario can then be displayed together in a scenario topology. By adding filters to the connections you can define which messages and exceptions are in scope for a scenario and isolate their status information in the monitoring application.

The following video explains the configuration of scenarios. You can find a step-by-step textual description of the scenario setup below.

Prerequisites for the video:

  • You need one of the following the SAP Cloud ALM roles
    • Integration Architect
    • Integration Owner
    • Global Administrator
  • Make sure that the cloud service you want to configure is successfully connected to SAP Cloud ALM

Create Scenario

  1. Click the 'Configuration' button in the Integration & Exception Monitoring UI
  2. Scroll down to the 'Integration Scenarios' section
  3. Click the pen icon to open the 'Scenario Configuration'
  4. Click the Add button
  5. Enter the name and the description for the scenario

Maintain Scenario Components

At first you have to add the components to the scenario.

  1. Click the Add button on top of the 'Services' table
  2. Select the services from the list by checking the checkbox in front of them
  3. Click the OK button
For each of the services in the scenario you can maintain filters and alerts. The filters make sure that only certain messages and exceptions are considered as part of the scenario, even if the monitoring was activated for all of them.
  1. Select the service for which you want to add the filter
  2. Click the Add button on top of the 'Filter for Data' table
  3. Select an available Category 
  4. Enter a name for the filter and maintain the filter values
    • The available Categories depend on the selected service
    • The filter fields depend on the selected category
    • For more information on the meaning for the different filter fields please refer to the setup information for the respective service type
  5. Activate or deactivate alerts
    1. Select the alert in the table 'Alert Details for Filter' below the 'Filter for data' table
    2. Click the Edit button
    3. You can change the Display name and the alert description
    4. Use the 'Alerting Status' slider to activate or deactivate an alert

Maintain Paths

You can also maintain paths between the components to visualize a message flow.

  1. On the tab 'Paths' you find a matrix with all the components in the scenario
  2. Select the row that stands for the desired source
  3. Check the checkbox in the column that stands for the desired target