Press "Enter" to skip to content

WHINT MessageStore Viewer for SAP CPI

0

This solution is providing the possibility to monitor message store entries of a SAP CPI tenant.

We know Staging & Logging in SAP PI/PO already, but SAP CPI provides different possibilities and is not persisting payloads by default. In addition, we see many consultants trying to achieve the same as in PI/PO by misusing the concepts of CPI.

Using the Persist Message step at design time is THE way in SAP CPI to store a message into the tenants database. It can be called at any point during the message processing and store several message versions at runtime.

The messages are persisted for 90 days in the store so this is clearly a monitoring scenario (but still not an archiving solution). SAP Help

Persist Message into the Message Store with Header, Payload and Attachment(s)

Unfortunately SAP does not (yet) provide a UI for this useful feature, so we consumed the API and created a simple UI5 app which we are now sharing with the SAP CPI community.

Logging the Payload in the MessageProcessingLog (MPL) is widely used by consultants, but this is not a secure way at all to store messages and should not be used extensively!


You can easily deploy it on your CPI tenant:

  • Download the ZIP archive and navigate into the Account Cockpit (https://account.hana.ondemand.com) to Applications -> HTML5 Applications
  • Import the Archive and provide a name and version
Select Import
Navigate to Versioning
A destination is required to activate…
Navigate back to the application versioning and select Versions

Activate the Version using the magic stick symbol.

Open the Application URL. Any S-User can access the application.

An authentication popup appears. Please select your S-User which has monitoring authorization and enter the password.


Now lets test the MessageStore Viewer!

For demo purposes we created a sample iFlow which persists the message 3 times:

Sample Integration Flow with 3 Persist Steps
Select a message or search for a specific message id
You see some administrative data as well as a list of message store entries

Each MessageStore Entry contains

  • Payload
  • Properties (Message Header & Exchange Parameters)
  • Attachment(s)
Message Header & Exchange Parameters
Attachment

The payload is shown in a separate browser tab:

Message Payload

Summary

Avoid using the MessageProcessingLog to persist payloads! SAP even implemented a “circuit breaker” to stop writing the MPL attachments when 1 GB per day is reached (depending on the amount of iFlows this can be reached quite quickly), so do not rely on it.

Using the Persist Message step to write the complete Message into the Message Store is the clean design for each development in SAP CPI. Until SAP delivers a navigation from the monitoring with a standard UI to display the store, please feel free to use our tool!

Print Friendly, PDF & Email