Introducere in monitorizarea

solutiei de integrare
SAP PI AEX 7.5 & AE J2SE 7.5

Cuprins
1. Sumar: Solutie integrare anterioara (PI 7.1 dual stack + Plain AE XI 3.0 ) vs solutie upgradata (PI
7.5 AEX – Java only + Plain AE 7.5)...................................................................................................1
1.1 Plain J2SE Adapter Engine......................................................................................................1
1.1.1 Landscape TEST..............................................................................................................1
1.1.2 Landscape PROD.............................................................................................................2
1.2 Sisteme PI – sumar delta..........................................................................................................2
2 Access in sistemul PI.......................................................................................................................4
3 Monitorizare mesaje........................................................................................................................5
4 Monitorizare idoc-uri (PI XX* + IS-U RB*)................................................................................12
5 Monitorizare canale comunicatii PI...............................................................................................16
6 Monitorizare generala sistem........................................................................................................18
6.1 Component Monitor...............................................................................................................18
6.2 Cache Connectivity................................................................................................................19
6.3 Adapter Engine Status............................................................................................................19
6.4 Utilizatori blocati...................................................................................................................20
6.5 Loguri generale pe sistem......................................................................................................20

Pag 1
 1 Sumar: Solutie integrare anterioara (PI 7.1 dual
stack + Plain AE XI 3.0 ) vs solutie upgradata (PI 7.5
AEX – Java only + Plain AE 7.5).
1.1 Plain J2SE Adapter Engine
Solutia precedenta continea un singur AE (J2SE) ce deservea landscape-ul de (dev ocazional) test si
productie. Deoarece solutia nu permitea upgrade-ul software sau a unor componente si testarea fara
afectarea productiei, solutia actuala contine AE separate per landscape si functionalitati.

1.1.1 Landscape TEST.

Sunt 2 instante de AE (denumite AE1 si AE2) ce deservesc landscape test:
- AE1 ce contine toate adaptoarele de tip SOAP, FISIER si Oracle JDBC. Propriuzis acesta contine
toate adaptoarele anterioare mai putin cele MS SQL JDBC utilizate de MyAvis.
-AE2 contine doar adaptoarele tip MS SQL JDBC. Acestea sunt toate adaptoarele utilizate de
MyAvis cu exceptia notificarilor MyAvis (SOAP – sunt pe AE1).
Accesul se face astfel:
AE1: http://aet.cez.local:8200
AE2: http://aet.cez.local:8210
Useri/password sunt identici (exceptie utilizatorii tehnici) cu cei utilizati in AE precedent.

1.1.2 Landscape PROD.

Similar cele 2 instante productive contine adaptorii productivi cu aceeasi repartitie.
Accesul in adaptorii productivi se face astfel:
AE1: http://aep.cez.local:8200
AE2: http://aep.cez.local:8210
Useri/parole au fost migrate din precedentul AE.
Nu exista modificari de functionalitate sau de interfata utilizator. Cu exceptia divizarilor adaptorilor
intre instante diferite per landscape/functionalitati nu exista modificari de operare/administrare.

1.2 Sisteme PI – sumar delta.

Solutia anterioara PI 7.1 (sistemele XZ*) continea sisteme dual stack (AS ABAP + AS JAVA).
Accessul in sisteme se facea astfel:
- via SAP GUI pentru partea de Integration Server (IE) – AS ABAP. Tranzactii des utilizate in
monitorizare: SXI_MONITOR (sau SXMB_MONI) pentru monitorizare mesaje, IDX5 pentru idoc-
uri, SMQ1/SMQ2 (cozi) si SM58 (tRFC).

Pag 2
- via browser Web pentru access in partea de Java (Adapter Engine, ESR, ID, NWA, canale
comunicatie, componente etc). Cel mai des utilizat ar fi trebuit sa fie RWB (Runtime Workbench
Monitor).
Sistemele noi PI XXD/XXT/XXP sunt sisteme PI 7.5 instalare doar AS Java (AEX).
Spre deosebire de sistemele PI precedente (dual stack ABAP + Java), in lipsa stack-ului ABAP,
accesul via SAP GUI nu este posibil. Accessul in sistemele PI XX* se face standard via browser
Web.
Modificari in operatiile standard de monitorizare PI 7.1 dual stack vs PI 7.5 (Java only):
- tranzactia SXI_MONITOR (sau SXMB_MONI) si IDX5 (monitorizare/cautare idoc) nu e
disponibila. Exista echivalentele “Message Monitor” si “Idoc Adapter Monitor” via browser web.
- nici o alta transactie rulabila anterior via SAP GUI nu este disponibila direct dar exista substitute
via browser Web.
- toate functionalitatile anterioare pentru monitorizare/interactiune cu Adapter Engine local
(ATENTIE – a nu se confunda cu instalarea separata de Plain Adapter Engine ce contine adaptorii
de comunicatie directa cu MyAvis, Converge, fisiere etc din DMZ) de exemplu: RWB (runtime
workbench monitor), NWA (Netweaver administrator), vizualizare canale (+start/stop canale),
verificare cache, conectivitati etc sunt disponibile in acelasi mod (pe aceleasi link-uri generice) in
AS Java, via browser web.
Ca modificare suplimentara in versiunea 7.5 (de fapt din versiuni precedente) RWB devine
obsolete. RWB este in continuare accesibil, cu aceleasi functionalitati dar este livrat PIMON (PI
Monitor; nume alternative: Configuration and Monitoring Home sau Monitoring Home) care
contine functionalitati suplimentare si este recomandat a fi utilizat.
Deoarece modificarile in interfata utilizator intre solutii sunt doar pentru sistemele PI, in continuare
nu vor fi tratate decat acestea.

Pag 3
 2 Access in sistemul PI
Accesul catre toate functionalitatile oferite de PI 7.5 se face via link-ul:
Dezvoltare XXD: http://xxdws.cez.local:8020/dir
Dezvoltare XXT: http://xxtws.cez.local:8020/dir
Dezvoltare XXP: http://xxpws.cez.local:8020/dir

Sectiunea “Configuration and Monitoring” este

de interes pentru monitorizare.

Link-urile disponibile sunt:

(PIMON) Configuration and Monitoring Home (accesibila si direct pe shortname “pimon” - de

ex pentru XXT la http://xxtws.cez.local:8020/pimon). Aici sunt disponibile: monitorizari mesaje,
idocuri, canale comunicatie (inclusiv actiuni administrative pe canale: start/stop), monitorizare si
status componente, monitorizare performanta etc
(NWA) SAP Netweaver Administrator (accesibila si direct pe shortname “nwa” - de ex pentru
XXT la http://xxtws.cez.local:8020/nwa). Pot fi de interes logurile generice ale sistemului (dar
loguri specifice prelucrarii unui mesaj se regasesc si in sectiunea monitorizare mesaje) si statusul
utilizatorilor (in special utilizatorii tehnici : blocati sau operationali). Utilizarea sa este rara in
conditii normale.

3 Monitorizare mesaje
Modalitate de access:
PIMON
(click din pagina de intrare pe
Configuration and Monitoring
Home sau direct linkul
http://xxtws.cez.local:8020/pimon)→
Monitoring →
Adapter Engine →
Message Monitor

Pag 4
Pagina de intrare prezinta sumarul traficului (tab-ul Message Status Overviwe) pentru perioada de
timp selectata:

Perioada este selectabila (dar doar din variantele oferite) astfel:

- ora completa pentru ziua curenta (ex mesajele prelucrate intre 1:00-2:00 din ziua curenta)
- ziua (din ultima saptamana, inceput/sfarsit zi este 2:00am) – mesajele tranzitate incepand cu 2am
ziua X pana in X+1 2:00am
- saptamana (selectabila doar din ultima luna) – toate mesajele din saptamana selectata
- luna (doar din anul curent) – toate mesajele din luna selectata
- anul – raportare anuala.
NOTA: Istoricul mesajelor (asincrone asa cum sunt utilizate in CEZ RO) este mentinut in PI
productiv pe o perioada de 60 zile (default este 1zi, perioada de retentie este modificabila la
cerere). Mesajele care au depasit perioada de “retentie” sunt pastrate doar ca header dar sunt
sterse urmatoarele: continut, istoric prelucrare, loguri. Nu se efectueaza arhivare mesaje inainte de
stergere (similar vechii solutii de PI).
Stergerea mesajelor atrage dupa sine urmatoarele: in pagina de intrare (Overview) mesajele pot fi
vizibile in statistica (in cazul selectarii perioadelor lungi – an de ex) dar nu vor fi disponibile
pentru analiza individuala.
Nu se sterg decat mesaje cu procesare incheiata (care nu pot fi restartate). Aceastea au statusul
“Successful” sau “Terminated with error”. Mesajele cu status “Error” nu au procesarea finalizata
(pot fi restartate) si nu vor fi sterse la expirare celor 60 zile.
Statistica din ecranul “Overview” este organizata pe fluxurile de mesaje din PI (sender →receiver
per scenariu) si contine afisate urmatoarele categorii de mesaje:
ERROR: sunt mesaje care care in timpul procesarii au erori de procesare. Pot fi restartate (pentru
reprocesare daca s-au eliminat cauzele initiale ale erorii) sau pot fi sistate definitiv prin interventie
manuala (care le modifica statusul in “Terminated with error”). Mesajele in status Error nu au
procesarea finalizata.
SCHEDULED: sunt mesaje in procesare sau mesaje cu eroare pentru care se va reincerca automat
reprocesarea si pentru care nu s-a atins limita de reincercari (5 – la atingerea limitei de reincarcari

Pag 5
daca sunt in continuare erori mesajul va fi in status Error). Aceasta stare daca se mentine mult timp
poate semnaliza o situatie de backlog (canale ocupate datorita traficului intens catre receptori lenti).
SUCCESSFUL: mesaje cu procesare incheiata cu success. Au procesarea finalizata si vor fi
arhivate/sterse dupa 60 zile.
TERMINATED WITH ERROR: mesaje cu eroare cu procesare finalizata. Pentru scenariile din
CEZ RO aceasta inseamna: procesare sistata prin decizie operator (s-a apasat butonul “Cancel” in
ecranul de vizualizare mesaj). Aceste mesaje cu procesarea incheiata prin decizie operator vor fi
sterse la +60 zile.
Din tabul de overview, prin selectarea unei linii in portiunea de jos a paginii apare o statistica per
scenariul selectat, numerele fiind link-uri catre mesaje. In exemplu de mai jos (cu selectie anul 2019
in XXT) s-a selectat trimiterea notificarilor din SAP IS-U in MyAvis. Dintr-un total de 97 notificari
trimise 96 sunt cu success si un mesaj a avut eroare si a fost sistat prin decizie manuala (Cancelled
with Errors) operator:

Pentru a vizualiza mesajele cu eroare, click pe link-ul “1” (un singur mesaj in acest caz). Aceasta va
dechide tabul “PI Messages” cu mesajul in cauza selectat pentru analiza. Pentru revenire la
overview se comuta in tabul initial “Overview”
Aspectul ecranului dupa utilizarea link-ului specific (click pe nr corespunzator din statistica per
scenariu) este in figura urmatoare. In cazul de fata (1 mesaj de notificare SAP->MyAvis sistat cu
eroare) mesajul este listat in sectiunea “Message List”.

Pag 6
Pentru analiza logurilor de procesare mesaje se selecteaza linia corespunzatoare mesajului de
analizat. Se deruleaza pagina pentru ca sub mesajul selectat va apare o sectiune (nu este vizibila fara
derulare) ce contine informatiile generale, continut, loguri de procesare si eventuale loguri conexe:

Tab Message Details: contine informatii generale despre mesaj: MsgID, directie, ora de procesare
(start/end), status, perioada de persistenta (persist until), idoc tip/numar (daca mesajul de intrare este
un idoc) etc.
Continutul mesajului este disponibil din tab-ul Message
Content. Sunt disponibile atat informatii generice (header,
continut dinamic, etc) cat si mesajul propriuzis (via Payload
→ MainDocument) uzual in format XML. Pentru vizualizare
click pe MainDocument.

Pag 7
Tab-ul Message Log contine logurile de procesare unde, eventualele erori, avertizari in timpul
procesarii si pasii de procesare sunt inregistrate.

In cazul mesajului analizat adaptorul din AE nu a reusit (lipsa comunicatie datorita

firewall/conectivitate in retea sau serviciu indisponibil) conectarea la serviciul MyAvis si a semnalat
PI-ului eroare (unable to create socket):

Eroarea de mai sus se regaseste si la nivelul adaptorului AE corespunzator in logurile canalului de

comunicatie (si se coreleaza cu acestea). Sursa erorii in acest caz e lipsa comunicatiei AE-MyAvis
(PI a livrat mesajul in AE, AE nu a reusit livrare in serviciul MyAvis pt notificari si a semnalat
sincron neprocesare mesaj).
Mesajul a fost sistat (dupa ce a fost reincercata livrarea automat) prin decizie operator, vizibil in
aceleasi loguri mesaj:

Tab-ul “Further Links” va permite accesul direct in logurile NWA (sistem) pentru a analiza o
eventuala cauza generala de sistem, cu selectie in jurul orei de procesare mesaj. Uzual acest tab nu
va fi folosit.

Pag 8
Pentru reprocesare sau sistare mesaj cu mesajul selectat se apasa butonul “RESEND” pentru
reprocesare sau “CANCEL” pentru sistare (in cazul mesajelor pentru care nu exista o remediere a
erorii aparute in loguri):

Reprocesarea sau sistarea se poate face pe multiple mesaje simultan (adaca anterior s-au selectat
mesajele necesare).
Butonul “Restart Sequence” se foloseste doar pentru secvente EOIO, in cazul utilizarii sale pentru
mesaje incorecte veti primi un mesaje de avertizare si comanda nu va fi efectuata.
Butonul Open Message va deschide mesajul in fereastra separata pentru alte detalii (inclusiv
staging/logging). Pentru monitorizare si analiza uzuala nu este necesar a fi utilizat.
Sectiunea (tab-ul general) PI Messages va permite sa cautati mesaje dupa unul sau mai multe criterii
de selectie. Daca folosirea accesului via statistica din overview va duce pe unul sau mai multe
mesaje selectate acesta se face via completare automata criterii de selectie (scenariu de integrare,
status etc). In locul acestei “autoselectii” se pot folosi alte criterii de cautare.
Puteti folosi aceeasi zona de selectie pentru cautare dupa alte criterii : perioada + status,
sender/receiver/scenariu etc:

De exemplu pentru a vizualiza un mesaj corespunzator unui MsgID (inclusiv mesaje conexe,
succesori ai msg id cautat) se selecteaza ca criteriu de cautare Identifiers, Search Type recomandat
“cu succesor” si se adauga lista de msg-id:

Pag 9
 4 Monitorizare idoc-uri (PI XX* + IS-U RB*)
Modalitate de access:
PIMON
(click din pagina de intrare pe Configuration
and Monitoring Home sau direct linkul
http://xxtws.cez.local:8020/pimon)→
Monitoring →
Adapter Engine →
Idoc Adapter Monitor

Este util in special pentru a cauta/analiza idocuri inbound in PI (outbound in SAP IS-U) daca se
cunoaste nr idoc-ului.
NOTA: Cautarea dupa un nr specific de idoc outbound in PI (pe baza nr de idoc inbound in SAP IS-
U obtinut din WE02 de ex) poate sa nu conduca la rezultatul asteptat. Idoc-urile outbound pot sa
nu au nr de idoc in PI (sau e autonumerotat in adaptorul de idoc), fara a fi acelasi cu cel din SAP
IS-U. In aceste cazuri, obtineti din IS-U msg-id (din control record) si cautati mesajul
corespunzator in PI dupa msgid si nu dupa nr idoc outbound.
Exemplu de cautare idoc inbound 120510072 (trimis in ziua precedenta din RBT):

Pag 10
Nr idocului poate fi omis; in acest caz vor fi returnate toate idocurile inbound (sau outbound in fct
de selectie) pe perioada selectata. Dupa afisarea rezultatului in capul de tabel pot fi introduse criterii
suplimentare de selectie:

Selectand un idoc si deruland in josul paginii sunt disponibile informatii suplimentare:

Pag 11
Msg ID (din tab-ul Idoc Message Details) este un link catre sectiunea cautare mesaj folosind msg
ID din Message Monitor (capitolul precedent). Click pe link va deschide Message Monitor (tab PI
Messages) cu sectiunea Identifiers este autopopulata cu msg id (inbound & outbound); in cazul in
care nu sunt listate mesaje se modifica “Search Type” in “with successors” si se apasa butonul
“Go”:

In cazul analizat, din idocul original sunt create 4 mesaje catre myavis, fiecare avand un id separat,
succesori ai idocului receptionat.

5 Monitorizare canale comunicatii PI

Modalitate de access:
PIMON (click din pagina de intrare pe
Configuration and Monitoring Home
sau direct linkul
http://xxtws.cez.local:8020/pimon)→
Monitoring →
Adapter Engine →
Communication Channel Monitoring

Pag 12
Pagina de intrare contine criterii de selectie (status, nume partial canal). Fara a completa nume canal
si cu status ALL sunt afisate toate canalele de comunicatie cu statusul aferent (verde=running, rosu
cu erori in ultima perioada de timp, gri inactive):

Lista afisata suporta filtrare suplimentara via cap tabel. Ex: doar canalele pentru componenta portal:

Detalii canal pot fi obtinute selectand canalul dorit (si derulare pagina):

In captura ecran precedenta canalul IS2HTTP_EP_GetRolesOfEPUsers are status running, canalul

este prezent pe ambele noduri (xxt00, xxt01) identificate prin ClusterNodeID, nu are erori pe nici

Pag 13
unul din noduri (verde). In sectiunea Processing Details mesajele recente primite sunt vizibile
(pentru o perioada de ordinul zecilor de minute). Eventualele erori sunt afisate (rosu) cu msg id
corespunzator mesajului cu eroare si o scurta explicatie. Msg ID din sectiunea Processing Details
este un link (click pe msg id) care deschide mesajul corespunzator in Message Monitor (pentru
analiza loguri de procesare).
Pentru o verificare sumara canal, se
selecteaza canalul si din sectiunea
superioara a paginii se apasa butonul PING:
Rezultatul difera in functie de tipul
canalului dar nu trebuie sa prezinte erori (nu
exista intrari semnalate cu culoare rosie.

Operatia PING va testa canalul de

comunicatie pe toate instantele/nodurile
sistemului PI:

Pentru oprire/pornire canal comunicatie se selecteaza canalul si se apasa (dupa caz) butonul START
(sau STOP). Este posibila si modificare in masa daca se selecteaza multiple canale de comunicatie.

6 Monitorizare generala sistem

Urmatoarele sectiuni vor fi verificate in cazul unor probleme ce afecteaza o cantitate mare de
mesaje sau functionalitati ale sistemului PI. Acestea pot oferi informatii suplimentare privind cauza
si/sau potentiale modalitati de remediere.

Pag 14
 6.1 Component Monitor
Disponibil via PIMON→Monitoring→Common→ Component Monitor:

Pentru Central AE, Mapping Runtime, Integration Directory si ESR (care sunt componente PI) nu
trebuie sa fie vizibile errori. Restul componentelor afisate nu pot fi analizate in component monitor
cu setup-ul curent (fie componenta e dezactivata fie nu are capabilitatile necesare).

6.2 Cache Connectivity

Disponibil via PIMON→Monitoring→Testing-
>Cache Connectivity Test:
Nu trebuie sa fie raportate erori (status verde).
In cazul in care intrarile nu au status (gri etc) se
apasa butonul “Start Test”.
Erorile afisate trebuie raportate pentru analiza si
rezolvare

6.3 Adapter Engine Status

Disponibil via PIMON→Monitoring→Adapter Engine→ Adapter Engine Status utilizabil in
cazurile in care sunt intarzieri mari de procesare mesaje (situatii de backlog) pentru confirmarea
acestei situatii.
Situatiile de backlog apar in cazul unui sender rapid ce trimite o cantitate mare de mesaje catre un
receptor lent (uzual). In acest caz, mesajele catre receptor (PI-ul este inundat cu mesajele de la
sender) asteapta procesarea si expedierea cate receptor.
Situatia poate sa apara si in cazul capacitatii insuficiente de procesare PI (improbabil).

Pag 15
Uzual pot fi un nr mic de mesaje raportate dar nr se modifica frecvent. Daca numarul este ridicat s-a
produs o situatie de backlog si ulterior vor trebui luate masuri de optimizare. Exceptand situatii
extreme (epuizare memorie etc) situatia de backlog este eliminata de la sine pe masura expedierii
mesajelor aflate in coada de transmisie.

6.4 Utilizatori blocati.

Mgmt utilizator se efectueaza din NWA
(http://xxtws.cez.local:8020/nwa) in tabul
Configuration →Security → Identity
Management. Utilizatorii de monitorizare au
drepturi de vizualizare. Cu selectie userul de
verificat (sau fara selectie → toti utilizatorii)
coloana “Stare” trebuie sa aiba indicator
“Activ” (verde). In cazul in care utilizatorul
de comunicatie nu are status activ (parola
expirata, blocat temporar etc) semnalati situatia administratorilor de sistem.

6.5 Loguri generale pe sistem

Disponibil in NWA via Troubleshooting → Log and traces → Log Viewer.
Poate furniza informatii pentru validarea unei situatii extreme si a masurilor de corectie.
Nota: Logurile sistem legate de erorile de procesare a unui mesaj sunt disponibile direct din
Message Monitor in sectiunea “Further Links”

Pag 16