Sunteți pe pagina 1din 17

7/27/2019 Alert Configuration Example in PI/PO Single Stack - SAP Integration Hub

Home ABAP  PI/PO  BASIS  Interview Preparation Tips About Author

25 Male
No

Rs. 547

Alerts
Search this site... Search

Home  PI/PO  Alerts 


Alert Configuration Example in PI/PO Single Stack
Tag Cloud

Alert Configuration Example in ABAP ALE/iDoc

ASMA B2B Base64


PI/PO Single Stack Business System DDIC
 By Isuru Fernando  Alerts   17 Comments
EDI Error Example
Article is a guide on Alert configuration in Process Integration (PI) single
stack installation or Process Orchestration (PO) with an step by step File Adapter FTP
example. Before we jump to configuration steps and example, first we
will try to understand the architecture of SAP message alerting Function Module

framework. Graphical Mapping

SAP replaced the Netweaver Alert Framework which was included until Guide How To
Netweaver release 7.30 with a newer mechanism called Component-
Privacy & Cookies
HTTP Policy
iDoc iFlow
https://sapintegrationhub.com/pi-po/alerts/alert-configuration-example-single-stack/ 1/17
7/27/2019 Alert Configuration Example in PI/PO Single Stack - SAP Integration Hub

Based Message Alerting (CBMA).


Java Mapping

To understand the CBMA, let’s first look at what the main features of an Message Mapping
alert framework should be.
NWDS Overview

PI/PO Proxy

RBDMIDOC RFC

SE11 SE37 SE38

Service Interface SLD

Smartforms SOAP

sproxy SQ01

Step by Step

Troubleshoot UDF
Bangalore Refinery 5 gm, 24k (999.9) Yellow Gold Bar
Variable Substitution
(277)
Rs. 19,071.00 (details + delivery) we02 we20 WSDL

XML XPath

Alert Framework Features:


1. It should have capabilities to create custom Alert Rules as per
business needs.
2. Ability to identify and collect errors, warnings and other alert
messages which are generated in the system.
3. Functionalities to distribute the identified alerts to selected parties. Xiaomi Mi A2 (Black, 4GB RAM
(19202)
  Rs. 10,599.00 (de

CBMA Alert Framework Components: Explore by Category


SAP Component Based Message Alerting (CBMA) framework consists of ABAP
three main components to facilitates the three features above. ALE/iDoc
ALV
Central Configuration for Alerts: Application Log
Privacy & Cookies Policy
base64
https://sapintegrationhub.com/pi-po/alerts/alert-configuration-example-single-stack/ 2/17
7/27/2019 Alert Configuration Example in PI/PO Single Stack - SAP Integration Hub

Users or IT team can configure Alert Rules and consumers as per their BDC
requirement either using Integration Directory (ID) or Netweaver DDIC
Administrator.
Function Module
LSMW
Alert Engine:
SAP Query

Local Alert Engines are included in each runtime environment of Search Help
Integration Engine (IE) and Advance Adapter Engine (AAE) of SAP PI/PO. Smartforms
Alert engine reads the alert event store (PI/PO message error Spool
information) and generates alerts if a matching Alert Rule is found for
Table Maintenance
the generated error type. Then it updates the consumer Alert Store
defined in the Alert Rule. Transformation
BASIS

Alert Consumer: Batch Jobs


How To
Consumers receive alerts, generate notifications via SMS, e-mail, etc. PI/PO
Alert Consumer extracts the alerts from respective Alert Store and sends Alerts
notifications. SAP Solution Manager is a special Alert Consumer with
ASMA
capabilities to process generated alerts and push them to alert inbox.
B2B
Context Objects
Data Type Enhancements
Fault Messages
File Adapter
iDoc
iDoc_AAE
iFlow
Java Mapping
Mapping
Node Functions
NWDS
Xiaomi Mi A2 (Black, 4GB RAM, 64GB Storage)
Proxy
(19202)
Receiver Determination
Rs. 10,599.00 (details + delivery)
RFC
Service Registry
sFTP Adapter
 
SLD

Alert Runtime Process Overview: SOAP


UDF
Privacy & Cookies Policy
https://sapintegrationhub.com/pi-po/alerts/alert-configuration-example-single-stack/ 3/17
7/27/2019 Alert Configuration Example in PI/PO Single Stack - SAP Integration Hub

When an error occurs in a runtime of a PI message, it adds an error


status to the message. When Alert Engine receives this error information Get the latest tips
or alert events from PI runtime, it checks for matching Alert Rules and and tricks on SAP!
configuration to decide if an alert should be generated or not. Alert
generation depends on the error status and runtime component
configuration of the Alert Rule.
your email*

Generated alerts contain information such as error event information, First Name*
Alert Rule ID, timestamp, etc. Each alert consumer has separate Alert
Stores. Alert Engine places created alerts in corresponding consumer Last Name*
Alert Stores. Finally, Alert Consumers retrieve the alerts from the local
consumer Alert Store to be distributed to the end users.
Subscribe
 

Alert Design Time Process Overview:

25

Rs

Alert configuration Design Time process overview

Alert Runtime Process Overview:

Privacy & Cookies Policy


https://sapintegrationhub.com/pi-po/alerts/alert-configuration-example-single-stack/ 4/17
7/27/2019 Alert Configuration Example in PI/PO Single Stack - SAP Integration Hub

Alert Runtime process overview

Step by Step Alert Configuration


Example:
Let’s look at a simple e-mail notification configuration step by step. We
will send an email notification to an end user on errors that occur in an
integration configuration.

Step 1: Create Alert Rules.


Alert Rules can be created in either in Integration Directory (ID) or
Netweaver Administrator. To create Alert Rules centrally using
Netweaver administrator, go to Monitoring home > Configuration and
Privacy & Cookies Policy
https://sapintegrationhub.com/pi-po/alerts/alert-configuration-example-single-stack/ 5/17
7/27/2019 Alert Configuration Example in PI/PO Single Stack - SAP Integration Hub

Administration > Message Alert Rule Configuration. Otherwise, create


them in ID as below.

Look stylish with new Eyewear SHOP NOW


Get upto 70% off on top brands. Snapdeal

Create Alert Rule in Integration Directory (ID)

Step 2: Configure Types of Objects to be


Considered for Alert Rule.
You can specify interface related objects such as Integrated
Configuration Object (ICO), Configuration Scenario, Communication
Component etc. If you select either ICO or configuration scenario,
alerts get generated for errors that occur in any stage of message
processing pipeline and for all interface components included in ICO.

Set Alert rule type and enable the Alert Rule.

Privacy & Cookies Policy


https://sapintegrationhub.com/pi-po/alerts/alert-configuration-example-single-stack/ 6/17
7/27/2019 Alert Configuration Example in PI/PO Single Stack - SAP Integration Hub

Add interface objects and configure Alert Rule

Step 3: Configure Error Sources and Alert


Consumer.
Select Error Sources for which the alerts should be generated. Check of
uncheck the Error Sources in the the extended tab of the Alert Rule
configuration. You can configure alerts to be generated based on either
errors which take place in different adapters or other runtime errors
such as message mapping.

Include the consumer name where the generated alerts should be


placed. This defines the local consumer Alert Store where the alerts
generated under this Alert Rule would be placed. Since our aim is to
send the alert as an email, let’s include consumer as ALERT-TO-MAIL.

Configure Alert Rule and assign error types and consumer

Privacy & Cookies Policy


https://sapintegrationhub.com/pi-po/alerts/alert-configuration-example-single-stack/ 7/17
7/27/2019 Alert Configuration Example in PI/PO Single Stack - SAP Integration Hub

If you have a requirement to segregate the alerts and send them to


multiple users, for example, separation of alerts on a SAP functional
area basis, create different consumers which represent each functional
area and assign them the correct interfaces in the Alert Rule.

Example:

ALERT-TO-MAIL-OTC: Assign Interface Runtime Components of


Order to Cash (OTC) functional area to this Alert Rule and
Consumer.
ALERT-TO-MAIL-P2P: Assign interface Runtime Components of
Purchase to Pay (P2P) functional area to this Alert Rule and
Consumer.

Step 4: Configure Java Mail Client.


This is a one time activity and BASIS team usually creates a default mail
client in post installation steps.

But if you need to create one you can do it by maintaining basic settings
such as,

mail.from
mail.smtp.host
mail.smtp.password
mail.smtp.user.

Step 5: Create the Task which Sends Emails


Using the Java Mail Client Created in Step 4.
Go to NWA > Operations > Jobs > Java Scheduler > Task and add a new
task.

Privacy & Cookies Policy


https://sapintegrationhub.com/pi-po/alerts/alert-configuration-example-single-stack/ 8/17
7/27/2019 Alert Configuration Example in PI/PO Single Stack - SAP Integration Hub

Go to NWA Java Scheduler

Select consumer job “AddConsumerAlert” or “AlertConsumerJobV2”


and set a suitable name for the task. AlertConsumerJobV2 is an updated
version of the job and it has more parameters in comparison with the
previous version. For example, you can configure email template and
set the location of the email template file as a parameter.

Job definition and parameters can be viewed from the Job Definition
tab.

Follow the Java Scheduler Task creation configuration wizard.

Privacy & Cookies Policy


https://sapintegrationhub.com/pi-po/alerts/alert-configuration-example-single-stack/ 9/17
7/27/2019 Alert Configuration Example in PI/PO Single Stack - SAP Integration Hub

Create alert consumer task in Netweaver Administrator

Then configure the properties and details of the task. Configure


consumer as “ALERT-TO-MAIL” and emailTo as the email address of the
user who should receive the notification.

Configure alert consumer task. Set consumer, Mail From, Mail To

Set the start time and the frequency of the job. I have set the frequency
as every 5 minutes.

Set frequency of the alert consumer task

 
Privacy & Cookies Policy
https://sapintegrationhub.com/pi-po/alerts/alert-configuration-example-single-stack/ 10/17
7/27/2019 Alert Configuration Example in PI/PO Single Stack - SAP Integration Hub

Result:
I stopped the receiver file channel of the Integration Scenario to create
couple of messages with errors.

message monitor error message

Xiaomi Redmi 6 Pro (Rose Gold, 4GB RAM …


(33748)
Rs. 10,999.00 (details + delivery)

Message error detail

Go to Java Scheduler > Jobs and find the Consumer Job you created.
You can find the number of alerts consumed by the AlertConsumer task
in the task log.

Alert consumer java job has consumed the 2 Alerts generated

If you need any clarifications on steps described here, please do not


hesitate to leave a comment below.

Share with your colleagues!

Privacy & Cookies Policy


https://sapintegrationhub.com/pi-po/alerts/alert-configuration-example-single-stack/ 11/17
7/27/2019 Alert Configuration Example in PI/PO Single Stack - SAP Integration Hub

Tags: Alert Rule, AlertConsumerJob, AlertConsumerJobV2, CBMA,


Example, Java Scheduler, NWA, Overview, PI/PO, Step by Step

Get the latest tips and tricks on SAP!

your email*

First Name*

Last Name*

Subscribe

Related Posts

Register Alert
Consumer in SAP
PI/PO

About Author
Isuru Fernando
Senior SAP Technical Consultant

17 Comments

gurudatta
HI,
How can i Transport the Alert consumer group
for ex:for speciific interface i have created ALERT-TO-
TEST as a consumer..how do i transport this from DEV–
QUALITY? Privacy & Cookies Policy
https://sapintegrationhub.com/pi-po/alerts/alert-configuration-example-single-stack/ 12/17
7/27/2019 Alert Configuration Example in PI/PO Single Stack - SAP Integration Hub

February 21, 2018 Reply

Isuru Fernando
Hi, Transport the Alert Rules and create Alert
Consumer in your target system.
February 24, 2018 Reply

Thakur
Hi,
How can I attach IDOC xml file in this email that
correspond to the error message?
March 7, 2018 Reply

Isuru Fernando
Hi Thakur, You may have to create a separate
interface using “AlertRetrieveAPI” and attach the
payload in the message mapping.
March 8, 2018 Reply

Thakur
Can you provide me step by step guide
to do so if possible?
March 9, 2018 Reply

Isuru Fernando
Hi,
I will try to write a post on that in
the future.
March 11, 2018 Reply

Vivek
Hi ,
I have configured Alerts through Component Based Alert
Monitoring(CBMA). But neither any logs can be seen nor
any alert is getting triggered. Please help.
May 19, 2018 Reply
Privacy & Cookies Policy
https://sapintegrationhub.com/pi-po/alerts/alert-configuration-example-single-stack/ 13/17
7/27/2019 Alert Configuration Example in PI/PO Single Stack - SAP Integration Hub

Shashidhar
It means no need solman to monitor ?
We are getting multiple front end response time and
schedule job alerts for sap pi in solman 7.2
Suggest me to provide the solution for fixing these issues.
June 7, 2018 Reply

Isuru Fernando
Hi Shashidhar,
Solman is not mandatory to this scenario.
June 9, 2018 Reply

sirisha
hello Shashidhar,
Your blogs are very informative. Thank you.
I have a doubt regarding CBMA mechanism which we do
in SAP PO system.Can you please let me know what
settings we need to do in task creation , so that i will
receive only 1 alert for 1 failed message. Is there any
settings that i should do while creating alert rule in
NWA/ID.
Thanks,
Sirisha.
June 28, 2018 Reply

Mohanraj P
Amazing Blog especially picture – Alert Runtime
Process Overview.
July 18, 2018 Reply

Isuru Fernando
Thank you Mohanraj!
July 21, 2018 Reply

Varun
Hi Isuru,
Thanks for the detailed blog.
We are using SAP PI 7.11 and in our scenario we pull the
data from SQL tables on sender side. The details related Privacy & Cookies Policy
https://sapintegrationhub.com/pi-po/alerts/alert-configuration-example-single-stack/ 14/17
7/27/2019 Alert Configuration Example in PI/PO Single Stack - SAP Integration Hub

to SQL connection , SQL queries etc . are set in sender


communication channel. Can we use SAP PI Alert
mechanism in our scenario ? For instance if SQL server is
not available or is down then PI will not be able to pull
data. So is in this case we can use PI alert mechanism and
if yes how it can be done?.
Thanks in Advance.
Regards,
Varun
July 24, 2018 Reply

Isuru Fernando
Hi Varun,
Check if JDBC alerts or Run-time Error Sources
suites your requirement. if not try using an
adapter module to raise alerts.
Cheers
Isuru
August 5, 2018 Reply

mayank yadav
Hi Isuru ,
How can I ensure that Alerts generated by known
exceptions like socket & other time out errors for
FTP(file.ftp.FTPEx: 421,425,550), SFTP,HTTP channels do
not create incidents and thereby increase our workload in
Prod.Since these errors are creating incidents in
Consumer ,we dont want that these alerts trigger and
Consumer reads these errors and create Incident no.The
conditions are below:
If “ErrorText” value contains one of the following texts,
please DO NOT create ticket:
• com.sap.aii.adapter.file.ftp.FTPEx: 421 Unexpected reply
codeProxy is closed
• com.sap.aii.adapter.file.ftp.FTPEx: 425 Unexpected reply
codeCant open data connection.
• com.sap.aii.adapter.file.ftp.FTPEx: 550 Unexpected reply
codeThe network path was not found.
• com.sap.aii.adapter.file.ftp.FTPEx: 550 Unexpected reply
codeThe process cannot access the file because it is
being used by another process.
• com.sap.aii.adapter.file.ftp.FTPEx: 550 Unexpected reply
codeThe system cannot find the file specified.
Privacy & Cookies Policy
https://sapintegrationhub.com/pi-po/alerts/alert-configuration-example-single-stack/ 15/17
7/27/2019 Alert Configuration Example in PI/PO Single Stack - SAP Integration Hub

• java.net.ConnectException: A remote host refused an


attempted connect operation. (Connection refused)
• java.net.SocketTimeoutException: Accept timed out
• Exception received: com.jcraft.jsch.JSchException:
Session.connect: java.net.SocketTimeoutException: Read
timed out
• Exception received: com.jcraft.jsch.JSchException:
timeout: socket is not established
Please suggest any feasible solution asap.
Regards,
Mayank
October 12, 2018 Reply

Jay
I am getting error from all message starting from source
system. How can we restrict that . Can’t edit message
header rule
October 22, 2018 Reply

Add a Comment
Comment:

Name:

Email Address:

Website:

Privacy & Cookies Policy


https://sapintegrationhub.com/pi-po/alerts/alert-configuration-example-single-stack/ 16/17
7/27/2019 Alert Configuration Example in PI/PO Single Stack - SAP Integration Hub

Save my name, email, and website in this browser for the next time I
comment.

Add Comment

  

SAP Integration Hub Copyright © 2019. Theme by MyThemeShop. Back to Top ↑

Privacy & Cookies Policy


https://sapintegrationhub.com/pi-po/alerts/alert-configuration-example-single-stack/ 17/17

S-ar putea să vă placă și