Press "Enter" to skip to content

WHINT InterfaceMonitoring Snapshot

2

Functionality

This solution reads messages, channels and queues from a PI/PO landscape and sends an E-Mail (alert) to one or more receivers, listing them (as a snapshot) in a plain text format (readable easily from a smartphone).

Data Sources:

  • Adapter Engine (central and/or decentral adapter engine(s))
    • Communication Channels
    • Messages
  • Integration Engine (ABAP Proxy Runtime: Backend or PI Integration Server)
    • Messages
    • Queues: qRFC and tRFC

The alert recipients can be configured based on a list of the following objects:

  • Party
  • Service
  • Channel
  • Interface Name
  • Interface Namespace

The usage of wildcards are also possible (via regular expressions).

The Snapshot considers all channels with status ERROR as well as messages in status ERROR and SCHEDULED.

A threshold can be configured to consider messages of a specific age for both messages in error and scheduled messages.

Temporary Channel Errors are not reported if there was a successful connection after the error situation.


Prerequisites

Works with SAP NetWeaver PI/PO version 7.1 and higher

  • Deploy WHINT MessageTrigger Job, which is part of the solution to trigger messages
  • Import the Software Component(s) into your ESR provided by Whitepaper InterfaceDesign
  • Optional (only if you want to monitor ABAP Systems): Import the ABAP transport into your Backend by uploading the data and cofile to the server and importing via STMS
  • Create a technical user with specific roles in each data source
    • Adapter Engine (JAVA): Required Role: SAP_XI_MONITOR_J2EE
    • Integration Engine (ABAP): Required Role: SAP_XI_APPL_SERV_USER
  • For each data source you have to configure lookup channels (e.g. per SID) using the adapter templates (please make sure the channel names contain the words “Channel”, “Message” and “Backend”)
    • IMS_Channel (PI Adapter Engine: Communication Channels)
    • IMS_Message (PI Adapter Engine: Messages)
    • IMS_Backend (ABAP Integration Engine)
  • Create a Business Service (e.g. “WHINT_IMS”) which will be used as the sender to start the data collection
  • Configure the Scenario by installing the Integration Scenario in NWDS (via iFlow) or in Integration Directory Swing Client via Integrated Configuration (ICO)
    • Parameter: list all tRFC-Destinations (comma separated), which shall be checked (all others will be ignored)
    • Parameter: Sender E-Mail Address
    • Parameter: Max. Message Count (reduce the amount of selected messages with this parameter). If not selected, the Maximum Count is set to 1000 messages.
    • Parameter: enter the global message thresholds in minutes. This is a global value for all messages in the landscape. Messages of an Adapter Engine can also be filtered scenario-specific (see Configuration XML “ThresholdConfiguration.xml” below)
      • ErrorMinutes (will consider all error messages up to <x> minutes age)
      • ScheduledMinutes (will consider all scheduled messages up to <x> minutes age)
      • IgnoreMinutes (will ignore all messages up to <x> minutes age)

The key element is the Operation Mapping “Lookup” which has to be parameterized (see Usage below).


Usage

  • Trigger the execution of the WHINT InterfaceMonitoring Snapshot using a trigger job
    1. Add a new task of type “MessageTriggerJob” and provide a name (e.g. WHINT_InterfaceMonitoringSnapshot)
    2. Set the ScenarioSender according to your Configuration Scenario (e.g. WHINT_IMS)
    3. Configure the data sources in the MessageTrigger Job definition listing them
      • ParamNN: <SID/based on your configuration>=<Channel Name containing Channel/Message/Backend>
  • Configure the E-Mail Recipients using those parameters in the Imported Archive “Configuration_XML”, file “AlertConfiguration.xml”. To use wildcards, you have to use Regex.
    • Receiver (occurrence: 1..n)
      • EmailAddress
      • Item (occurrence: 1..n)
        • Party
        • Service
        • Channel
        • Interface
        • Namespace
  • Configure the interface-specific thresholds using those parameters in the Imported Archive “Configuration_XML”, file “ThresholdConfiguration.xml”. To use wildcards, you have to use Regex.
    • Interface (occurrence: 1..n)
      • Name
      • Namespace
      • Party
      • Service
      • ErrorMinutes
      • ScheduledMinutes
      • IgnoreMinutes
  • Configure the channel-specific thresholds using those parameters in the Imported Archive “Configuration_XML”, file “ThresholdConfiguration.xml”. To use wildcards, you have to use Regex.
    • Channel (occurrence: 1..n)
      • Name
      • Party
      • Service
      • ErrorMinutes
      • IgnoreMinutes

To change the archive, you have to enable the objects to be modifiable.
Future updates will not overwrite this archive as we will not re-export it.


Example

Configuration of MessageTrigger Job:

  

Configuration for E-Mail Receiver Configuration:

  • a.kiwon@whint.de receives information about ALL channels and messages
  • sl.chen@whint.de receives information only about
    • channels with system name starting with “SAP”
    • messages with system (sender or receiver) starting with “SAP” and interface namespace containing “idoc”
    • channels with party name starting with “US”
    • messages with party (sender or receiver) starting with “US”

Configuration for Interface-specific Thresholds:

Result E-Mail:

 


Onepager WHINT IMS
Print Friendly, PDF & Email

Comments are closed, but <a href="http://blog.whint.de/interfacemonitoring-snapshot-sap-po/trackback/" title="Trackback URL for this post">trackbacks</a> and pingbacks are open.