Press "Enter" to skip to content

WHINT InterfaceMonitoring Snapshot

0

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

Procedure:

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.


Prerequisites

Works with SAP NetWeaver PI/PO version 7.1 and higher

  1. Deploy WHINT MessageTrigger Job, which is part of the solution to trigger messages
  2. Import the Software Component into your ESR provided by Whitepaper InterfaceDesign
  3. Import the ABAP transport into your Backend by uploading the data and cofile to the server and importing via STMS
  4. 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
  5. 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)
  6. Create a Business Service (e.g. “WHINT_IMS”) which will be used as the sender to start the data collection
  7. 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)

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

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:

 


Print Friendly, PDF & Email

Comments are closed.