The message flow via SAP PI can be very complex, passing different components (such as adapter engines with the module processor and messaging system, integration engines with their pipeline processing including Java & ABAP proxies, business process engine etc.) and using different adapter types (such as File-, JMS-, IDoc-, RNIF-adapters etc.).
This complexity makes it difficult to track and monitor the flow of a specific message across SAP PI. Automated monitoring of messages is essential to ensure the error-free operation of SAP Process Integration (SAP PI) and each integration scenario.
In order to define the communication details for a SAP PI message so-called communication channels are used in SAP PI. Both the inbound and outbound communication is maintained in the channel definition, including the adapter used for the particular interface. This way the right sender and receiver components are available during runtime of a message. Communication channels can have different statuses which influences the runtime of the PI message, too. If a J2SE adapter engine is used, J2SE adapters are used instead of communication channels to define the inbound and outbound processing.
If a communication channel or J2SE adapter is in an inactive or erroneous state the PI messages of the particular interface cannot be processed (as the sender or receiver components cannot be determined). Thus it is essential to monitor the involved communication channels or J2SE adapters of a SAP PI interface with high frequency, to be notified about failures or unavailability in time.
The following technical prerequisites have to be met in order to monitor messages in the ABAP system via ABAP proxy:
The following technical prerequisites have to be met in order to monitor PI messages in the SAP PI system:
For PI Java message monitoring the following prerequisites have to be met:
For older support packages you can implement the following patches to enable PI Java message monitoring:
Software Component | Support Package | Patch Level |
---|---|---|
MESSAGING SYSTEM SERVICE 7.31 | SP 17 | 54 |
SP 18 | 34 | |
SP 19 | 14 | |
SP 20 | 01 | |
MESSAGING SYSTEM SERVICE 7.40 | SP 12 | 53 |
SP 13 | 34 | |
SP 14 | 14 | |
SP 15 | 01 | |
MESSAGING SYSTEM SERVICE 7.50 | SP 05 | 14 |
SP 06 | 08 | |
SP 07 | 03 | |
SP 08 | 00 |
To be able to monitor interfaces of an on-premise system you first have to add it to Interface & Cloud Monitoring and select the monitoring categories you want to monitor for the system.
In the next step, you see all monitoring categories which are available for the system, depending on the system type and the installed software components. Some recommended standard monitoring categories are preselected.
Select the monitoring categories in scope.
Available Monitoring Categories
For Process Integration Monitoring, different monitoring categories are available:
For the category 'PI Messages (Java)' you can collect payload information via UDS attributes from the PI message and display this payload in the AIM application in SAP Focused Run. You can then use this information to search for related messages in PI or CPI, related IDocs, or related web service calls. Find out how to set up the collection of payload information here.
After selecting your monitoring categories you have to maintain filters to define what exactly you want to monitor. Some monitoring categories come with standard filters that usually just select all items of this monitoring category. SAP Focused Run can handle this high amount of monitoring data, so you can stick to this standard filters. Or you can set up filters of your own.
Please note that the filters you set in the 'Monitoring' step filter the data which is collected from the managed system or cloud service. You can also set up filters later in the 'Alerting' step, which will filter the data already in Focused Run.
You can create more than one filter for a monitoring category.
Available Filter Options
You can collect all PI messages and channels or you can use a filter to restrict the data collection. The available filter options depend on the category selected:
PI Messages (ABAP)
PI Messages (Java)
PI Communication Channels
The setup of the filters for the monitoring categories only makes sure that the data is collected, however, alerts are not created automatically. To create alerts and notifications you have to create an alert individually.
In the next sub-step, you have to maintain the filter. For most monitoring categories the available filter fields will be the same as for the 'Monitoring' configuration described above.
For some metrics, you have additional filter fields or you have to maintain metric parameters. You can check the collected data in Focused Run to determine which filter values to use for alerting. Most of the fields can be found in the Collection Context of the collected data.
Please note that the filters on 'Alerting' level filter the data that is already available in Focused Run. They do not influence the data collection itself. You can only filter for data that is collected. Be aware of this if you created strict filters in the 'Monitoring' step.
In the last sub-step you have to activate the alert:
For single exceptions, the threshold type is always 'Already Rated'. This means depending on the calculation frequency the number of exceptions is checked and an alert is created if this number is bigger than 0. If you want to reduce the number of alert for these metrics, you could increase the value for the calculation frequency to increase the time between checks.
Available Metrics
The following metrics are collected for the different Process Integration categories:
PI Messages (ABAP)
PI Messages (Java)
PI Communication Channels