Scenario Configuration

A scenario in Integration & Exception Monitoring of SAP Focused Run 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.

By naming the filter group of a connection between components appropriately, you can add business-related information to your scenario. Knowing what exactly is sent via this connection will support the readability and understandability of the scenario for monitoring. This will simplify the communication between the business, functional support and technical support teams. 

Create Scenario

Before you can set up a scenario you first have to activate the monitoring for the components and integration categories in scope. Then you can create a scenario: 

  1. Open the application by clicking on the 'Integration & Exception Monitoring' tile in transaction FRUN
  2. Click on the configuration icon in the upper right corner of the Integration & Exception Monitoring' application
  3. In the configuration panel expand the 'Scenarios' tray and click on the pen icon in the upper right corner. This will open the 'Scenario Overview' view. 
  4. If your scenario is not on the list yet, click the 'Add' button to add it. If it is on the list, click on the scenario ID. The 'Details' view opens.
  5. Enter the technical name and a description for your scenario.
 

Maintain Topology

Add Technical Components

In the 'Topology' step you create the topology for your scenario.

  1. Click on the 'Node Selection' drop down
  2. Check all technical components that are part of your scenario
  3. Click the '+' button next to the drop-down
  4. The select technical components will appear on the topology screen
  5. You can add more nodes by repeating the steps 1 to 3
  6. To remove a node: Click on the technical component and select 'Main Actions' → 'Delete Node'

After adding a component to a scenario you need to add filters to include messages in the scenario.

Filters allow you to filter which messages collected for a component are taken into account in the context of this scenario. For example if you create a scenario for "Invoicing" you would only want to consider IDocs that are actually related to the Invoicing process in this scenario. However, outside of the scenario you might collect all IDocs for the technical component. With a filter you can restrict the considered IDocs.

You can create filters on component or on path level.

The alerts and filters can only be created for monitoring categories that are already set up for the technical component.

Add Alerts and Filters to Components

On component level you can add either filters or alerts. To learn more about the available filter fields and the available metrics for alerts for the single monitoring categories please check here.

Add a 'Filter' to the component

  1. Click on the technical component
  2. Click on 'Filter for Component'
  3. You can copy filters already existing on component level via the button 'Copy Filter' 
  4. To create a new filter press the '+' button
  5. Enter a filter name and select the monitoring category
  6. Enter the required filters in the filter fields
  7. Save your changes.

Add 'Alerts' to a Component

  1. Click on the technical component
  2. Click on 'Alert for Component'
  3. Select the '+' button in the screen to the right the add a new alert
  4. On 'General'
    1. Select the alert category
    2. Select the metric for the alert
    3. Enter a sensible alert name
  5. Click on 'Filter'
    1. You can copy an existing alert filter for this component via the button 'Copy Filter' or create a new one
  6. Click on 'Description'
    1. On this tab you can change the standard settings for the alert, set up the notifications and adjust the alert description
  7. Save your changes.

Create Paths for Messages between Components

To create a real landscape topology you have to create connections between the technical components.

  1. Click on the technical component
  2. Select 'Main Actions' → 'Add Link to...' → Select target component
  3. To delete a link: click on the link and select 'Delete Link'

To include messages into this link, you have to add a filter:

  1. Click in the link
  2. Select 'Add Line Filter'
  3. Enter a 'Filter Group Name' in the screen to the right
  4. Click the '+' button to add a filter
  5. Enter the filter name
  6. Select the component (source or target of the link) for which categories the filter should be created
  7. Select the monitoring category for the filter
  8. Enter the required filters in the filter fields
  9. Save your changes.

Create Paths for local Messages (Self-Links)

When creating a scenario in Integration & Exception Monitoring it can be necessary to create a path from a component to itself, e.g. if IDocs are used for company internal invoicing and the sender and the target system are subsequently the same.

With SAP Focused Run 3.0 FP02 it is now possible to create such a self-loop and add a filter to it to only include relevant messages.

  1. Click on the technical component
  2. Select 'Self Loop' → 'Self Link and Filter'
  3. Click the '+' button in the screen to the right to create a filter
  4. Enter a 'Filter Group Name'
  5. Enter the 'Filter Name'
  6. The component will be preselected
  7. Select the monitoring category for the filter
  8. Enter the required filters in the filter fields
  9. Save your changes.

To remove a self link:

  1. Click on the technical component
  2. Select 'Self Loop' → 'Remove Self Link and Filter'

The filters can only be created for monitoring categories that are already set up for the selected technical component.

Flow Configuration

Flows allow you to describe end-to-end message flows that run over several technical components. This is useful integrations consisting out of more than one point-to-point interface.

Currently supported end-to-end flows:

Supported PatternsCategoriesLimitations
PI → PIPI Messages (ABAP), PI Messages (Java)Split and Merge scenarios are not supported yet
IDoc → IDocIDoc

 
PI → IDocPI Messages (ABAP), PI Messages (Java), IDocIDoc sent from ABAP to PI are not supported as part of a flow
Cloud Integration → C4C / C4C → Cloud IntegrationSAP Integration Suite, SAP C4C MessagesSplit and Merge scenarios are not supported yet
ABAP WS → Cloud Integration / Cloud Integration → ABAP WSSAP Integration Suite, Web Service Messages (ABAP)

 
ABAP WS → C4C / C4C → ABAP WSSAP C4C Messages, Web Service Messages (ABAP)

 

For these end-to-end flows, you can see a status summary and the average duration and status over time for the whole flow in the E2E Monitor of the Advanced Integration Monitoring application.

It is optional to create end-to-end flows for a scenario. 

 

Maintain Flows

To be able to maintain flows you have to change the mode for the UI from 'Basic' to 'Expert'. This is done using the drop-down field in the upper right corner of the configuration screen. After switching to 'Expert' mode you will now see the step 'Flows (Optional)'.

To create a flow go to the step 'Flows (Optional)' in the scenario configuration:

  1. Click the 'Add' button to add a new flow
  2. Enter a name and a description
  3. Select the start component of the message flow from the 'Node Selection' drop-down and click the '+' button
  4. Select the next component in the message flow from the 'Node Selection' drop-down and click the '+' button
  5. Repeat step 4 until all component of the flow are added
  6. Lines between the components are created automatically

For each component enter a filter that identifies the messages of this message flow:

  1. Click on the component
  2. Select 'Filter for Node'
  3. Set up the filter in the screen to the right
  4. You can only create a filter for monitoring categories that are already set up for the component.