PI Monitoring Guide

This blog describes the technical monitoring transactions that must be carried out to support a PI system.  The use of the transactions will enable the “silent running” of the PI system as they will highlight any current issues and detect any problems that may occur in the future. It is envisaged that these transactions will be run by second level support through out the working days on all systems in the production stack landscape unless otherwise specified.  The document also captures the subsequent actions which should be undertaken should problems occur.

The central monitoring of SAP Exchange Infrastructure (PI) offers the option of executing various monitoring activities. Primarily, we use the Runtime Workbench, the central tool for accessing PI monitoring.

Central PI monitoring offers the following options:

• Message Monitor
• Communication Channel Monitor
• Performance Monitor
• Java Proxy Runtime Monitor
• Cache Monitor
• Engine Status
• IDOC Monitor
• CPA Cache History
• Channel-Independent Logs

Message Monitor

Display message processing including aggregated and detailed information about status of messages, identify errors in message processing and perform problem isolation. Manage individual messages by, for example, resending individual message versions.

Message Monitor could be accessed in one of the following ways:

• Open a browser and go to http://<host>:<port>/pimon to access the Process Integration tools. Then choose Monitoring >> Adapter Engine >> Message Monitor.
• Click on the Message Monitor
• In the message monitor, you can access the message overview or search for persisted or archived messages as described below.

  

Message Status Overview :

• Message Status Overview will allow you to get a quick overview of the entire message flows sorted by interfaces and status.

• Overview of Messages and their Statuses shows:

              1. Error

              2. Scheduled

              3. Success

              4. Cancelled

• Run the transaction for each component is the PI system every hour in the production system.  The transaction should be run once a day in the development and testing systems. (It vary depends upon the project requirements)

Database:

• Set the time option to cover the last hour for the production system and last day for other systems and access the information by pressing display.

• Analyze any errors or cancelled with errors and attempt to fix any problems.

• Run the monitor regularly in the production system.  The transaction should be run once a day in the development and testing systems (It vary according to project requirements).

The Adapter Engine’s Messaging System (MS) receives the message, processes it and forwards it to the receiver. While the MS processes the message, it passes several statuses:

● TO_BE_DELIVERED:

  The state of message when it is initially handed over to the   Messaging System.

● DELIVERING:

  The state of message when it has popped out of the MS queuing system    and is in the process of being transmitted across the wire or    delivered to an   application.

● DELIVERED:

  The state of message when it has successfully reached its intended recipient.

● SYSTEM ERROR

  The state of issues with the messages that are flowing through the PI side that can be stuck for several reasons.

● HOLDING:

  The state of an EOIO message that cannot be delivered until its     predecessors have been delivered.

● WAITING:

The state of a message that has been attempted to be sent at least   once, failed, and is currently waiting for another attempt.

Statuses such as HOLDING or FAILED usually happen only for delivery semantics EOIO (exactly once in order) or BE (best effort).

  System Overview:

•    Access Availability and Performance->System Overview->System Overview
•    This gives a broader status of all connected SAP applications(ECC, CRM, SRM) and services.
•    Status update on Java nodes, database connections, Memory Consumption monitored at one shot.

Communication Channel Monitor:

Display the status of the communication channels and the corresponding adapters to get detailed and up-to-date runtime information about individual communication channels.

   

Communication Channel Monitor could be accessed in one of the following ways:

• Open a browser and go to http://<host>:<port>/pimon to access the Process Integration tools. Then choose Monitoring >> Adapter Engine >> Communication Channel Monitor.
• Click on the Communication Channel Monitor.
• The components of the PI system should be analyzed regular basis in the production system.  The transaction should be run once a day in the development and testing systems.

• Analyze any errors and attempt to fix any problems.

Performance Monitor:

Monitor the performance of message processing on the Advanced Adapter Engine by inspecting the amount of processed data over various periods of time and the message processing time at individual adapter modules.

Performance Monitor could be accessed in one of the following ways:

• Open a browser and go to http://<host>:<port>/pimon to access the Process Integration tools. Then choose Monitoring >> Adapter Engine >> Performance Monitor.
• Click on the Performance Monitor

Java Proxy Run Time Monitor:

Monitor the overall status of the Java Proxy Run time.

Java Proxy Run Time Monitor could be accessed in one of the following ways:

• Open a browser and go to http://<host>:<port>/pimon to access the Process Integration tools. Then choose Monitoring >> Adapter Engine >> Java Proxy Run time Monitor.
• Click on the Java Proxy Run time Monitor

You observe that the status of some of the components is not "green".

Cache Monitor:

Monitor cache objects in the SAP Net Weaver Process Integration run time caches of the Adapter Engine.

Cache Monitor could be accessed in one of the following ways:

• Open a browser and go to http://<host>:<port>/pimon to access the Process Integration tools. Then choose Monitoring >> Adapter Engine >> Cache Monitor.
• Click on the Cache Monitor

   

Engine Status:

Retrieve information about the messaging system of an Advanced Adapter Engine including data about message status, database locks, queues, backlogs, event handlers

Engine Status could be accessed in one of the following ways:

• Open a browser and go to http://<host>:<port>/pimon to access the Process Integration tools. Then choose Monitoring >> Adapter Engine >> Engine Status.
• Click on the Engine Status

  

IDOC Monitor:

Monitor IDoc message traffic and meta data processed on the Advanced Adapter Engine.

IDOC Monitor could be accessed in one of the following ways:

• Open a browser and go to http://<host>:<port>/pimon to access the Process Integration tools. Then choose Monitoring >> Adapter Engine >> IDOC Monitor
• Click on the IDOC Monitor

Procedure:

• Choose the Message Monitor tab.
• Choose one of the following search modes:

        >> To perform a quick search, simply select one of the options in the Show drop-down menu.

        >> In basic search mode, you can enter the number of the IDoc message in the Find field, and specify the message direction and the time period.

        >> In advanced search mode, you can enter parameters of the IDoc or XI message as well as the start and end of the search period.

Note: Using the message monitor you can search for IDoc messages processed with the IDoc adapter on the Advanced Adapter Engine. You can add various IDoc parameters to the search criteria to find only those messages.

Channel Independent Log:

Display processing steps of adapters that cannot be assigned to a particular communication channel. Select an adapter to display information about all entries for processing for this adapter.

Channel Independent Log could be accessed in one of the following ways:

• Open a browser and go to http://<host>:<port>/pimon to access the Process Integration tools. Then choose Monitoring >> Adapter Engine >> Channel Independent Log
• Click on the Channel Independent Log

CPA Cache History:

CPA Cache History could be accessed in one of the following ways:

• Open a browser and go to http://<host>:<port>/pimon to access the Process Integration tools. Then choose Monitoring >> Adapter Engine >> Channel Independent Log
• Click on the CPA Cache History

Configuration:

PI 7.3 – Adapter User-Defined Message Search without TREX:

User Defined Message Search could be accessed in one of the following ways:

• Open a browser and go to http://<host>:<port>/pimon to access the Process Integration tools
• Then choose Configuration and Administration>> Click User Defined Message Search

Refer: SDN Web link

Using SOA alternative way to access Monitoring :

• Open a browser and go to http://[host]:[port]/nwa to access SAP NetWeaver Administrator. Then choose   SOA  Monitoring  PI IDoc Adapter Monitoring.

Using Site Map :

Site map is a list of pages of a web site accessible to SAP users and it also lists down all the featuresin PI 7.3.

Troubleshooting Approach :

The troubleshooting approach explained in this document:

• Define where the error is found or monitored
• Define the failure points of the interface and the actual interface objects in ECC, Third Party System and PI
• Testing and validating the communication object
• Restarting messages (Getting the functional teams involved for data related issues and resending the messages if required

1.