इस लेख का मॉड्यूल: Message Monitor
SAP CPI message को step by step trace करें, iFlow डिज़ाइनर छोड़े बिना
SAP CPI का TRACE log level क्या रिकॉर्ड करता है, monitor में किसी step से पहले का content कैसे पढ़ें, और message का रास्ता और payload सीधे iFlow diagram पर कैसे देखें।
जब कोई iFlow गलत नतीजा देता है, तो सवाल लगभग हमेशा एक ही होता है: गड़बड़ करने वाले step से ठीक पहले message कैसा दिखता था? SAP Cloud Integration (SAP CPI) इसका जवाब दे सकता है, लेकिन सिर्फ़ उन messages के लिए जो log level TRACE के साथ प्रोसेस हुए हों, और जवाब monitor में होता है, उस diagram से कई screens दूर जिसे आप edit कर रहे हैं।
यह लेख बताता है कि trace क्या रिकॉर्ड करता है, उसे SAP के अपने monitor में कैसे पढ़ें, और Kitegra के साथ उसी trace को diagram पर step by step कैसे follow करें।
Trace क्या रिकॉर्ड करता है
हर message एक message processing log (MPL) छोड़ता है: उसका status, उसकी शुरुआत और अंत, और वे steps जो उसने चलाए। iFlow का log level तय करता है कि उसमें कितना विवरण जाए।
| Log level | Message processing log क्या रखता है |
|---|---|
| Info | कुल status, समय और error, अगर कोई हो |
| Debug | Message के चलाए हर step की एक entry |
| Trace | Debug जैसा, साथ में हर step से पहले की body, headers और exchange properties, जैसी वे उस समय थीं |
Trace content जाँच-पड़ताल के लिए है, archiving के लिए नहीं। SAP इसे लगभग एक घंटे तक रखता है, और TRACE level ख़ुद लगभग 10 मिनट बाद वापस गिर जाता है, इसलिए जिस message को आप पढ़ना चाहते हैं उसे TRACE सेट होने के कुछ ही देर बाद चलना चाहिए। क्योंकि यह tenant में असली payloads सहेजता है, जहाँ हो सके test data पर इसका इस्तेमाल करें, और production में अपनी कंपनी के नियमों का पालन करें। TRACE अपने-आप बंद क्यों होता है इसकी सीमाएँ समझाता है।
SAP के monitor में trace पढ़ना
- Monitor में Manage Integration Content खोलें, deploy किया गया iFlow चुनें और उसका log level Trace पर सेट करें।
- अगले कुछ मिनटों के अंदर message फिर से भेजें।
- Monitor Message Processing में message खोलें और उसके trace link से message processing run तक जाएँ।
- Run के diagram पर कोई step चुनें और उसका message content खोलें: headers, properties और payload।
यह काम करता है, लेकिन हर step को देखने में कुछ क्लिक लगते हैं, run का diagram वह नहीं है जिसे आप edit कर रहे हैं, और 10 मिनट बाद log level फिर से सेट करना पड़ता है।
डिज़ाइनर से TRACE चालू करें
Kitegra के साथ, डिज़ाइनर में iFlow खोलें, diagram toolbar में "Kitegra टूल" बटन पर क्लिक करें और "मैसेज" चुनें (या Alt+Shift+M दबाएँ)। Panel आपके चुने हुए runtime पर iFlow के आख़िरी messages दिखाता है, दिन के हिसाब से समूहों में, status, शुरू होने के समय और अवधि के साथ। Trace किए गए messages पर TRACE का निशान होता है, और नए messages आते ही चमकते हैं।
Panel का switch "Trace: बंद" दिखाता है। एक क्लिक iFlow का log level TRACE कर देता है, और switch मिनटों की गिनती के साथ "Trace: चालू" दिखाता है। जब तक यह चालू है और आप iFlow में काम कर रहे हैं, एक्सटेंशन SAP के हटाने से पहले TRACE फिर से सेट कर देता है; आपकी आख़िरी गतिविधि के 20 मिनट बाद यह renew करना बंद कर देता है। बंद करने पर iFlow का पहले वाला log level लौट आता है।
Trace उन चार क्रियाओं में से एक है जो आपका tenant बदलती हैं, और बाकी की तरह यह सिर्फ़ आपके क्लिक करने पर चलती है।
Diagram पर message को follow करें
- Message भेजें, या अगले message का इंतज़ार करें। यह "मैसेज" panel में सबसे ऊपर दिखता है।
- किसी trace किए गए message पर "डायग्राम पर" चुनें। जिन steps से यह गुज़रा वे रंग दिए जाते हैं, fail हुए step पर निशान लगता है, और जिन steps तक यह नहीं पहुँचा वे धुँधले हो जाते हैं।
- किसी रंगीन step पर क्लिक करें। "स्टेप से पहले का कंटेंट" panel उस step से पहले की Body, Headers और Exchange properties दिखाता है, साथ में step का "लॉग", और step fail होने पर "त्रुटि"।
- Steps को उसी क्रम में देखने के लिए जिसमें वे चले, "पिछला" और "अगला" इस्तेमाल करें। जो step Splitter या loop में एक से ज़्यादा बार चला, वह हर run दिखाता है, जैसे "इस स्टेप का 3 में से 2वाँ रन"।
- काम पूरा होने पर "डायग्राम के निशान हटाएँ" चुनें।
अगर message TRACE के बिना चला, तो panel यह बता देता है: SAP किसी message की body और headers सिर्फ़ तब रखता है जब वह TRACE के साथ चले, और सिर्फ़ लगभग एक घंटे तक।
जो मिले उसके साथ काम करें
- Payload viewer body को "व्यवस्थित" रूप में या "एक पंक्ति" में दिखाता है, "पंक्तियाँ लपेटें" और "खोजें" की सुविधा देता है, और "कॉपी करें" या "डाउनलोड करें" से आप body ले सकते हैं।
- "अगले स्टेप से तुलना करें" दो bodies को "पेलोड तुलना" में आमने-सामने खोलता है, ताकि आप ठीक-ठीक देख सकें कि किसी step ने क्या बदला।
- "समय" steps को उनके लगे समय के अनुसार रंगता है, सबसे तेज़ (हरा) से सबसे धीमे (लाल) तक; समय देखने के लिए step पर pointer ले जाएँ।
- लंबे run में "पढ़े गए स्टेप" तय करता है कि उस iFlow के कितने steps पढ़े जाएँ, या "सभी"।
- Fail हुए message के लिए "सारांश" tab बताता है कि वह कहाँ fail हुआ और, जानी-पहचानी errors के लिए, "आमतौर पर इसका मतलब:"।
किसी message को उसकी ID से खोलने के लिए, चाहे वह इस iFlow का हो या tenant के किसी दूसरे iFlow का, देखें Message ID या Correlation ID से SAP CPI message कैसे खोजें।
Kitegra कैसे मदद करता है
Message Monitor, Kitegra के पाँच areas में से एक है। Trace content ग्राहक का डेटा है: एक्सटेंशन उसे पेज में दिखाता है और आपको body डाउनलोड करने देता है, लेकिन उसे कभी सहेजता, sync करता या Kitegra को भेजता नहीं।
Helper, Message Monitor, iFlow Inspector और iFlow Docs हर एक उन iFlows को गिनते हैं जिन पर आप उन्हें इस्तेमाल करते हैं: Kitegra खाते के बिना हर मॉड्यूल में 5, Free प्लान में 50, Starter में 100 और Pro में 300; Business में कोई सीमा नहीं। Toolbox और workspace की अतिरिक्त सुविधाएँ मुफ़्त हैं। प्लान की तुलना करें।
अपने अगले iFlow में आज़माएँ
पढ़ें कि Kitegra, SAP Integration Suite के डिज़ाइनर में क्या-क्या जोड़ता है, या इसे Kitegra के बाकी Chrome एक्सटेंशन के साथ देखें।
अक्सर पूछे जाने वाले प्रश्न
SAP CPI में मुझे अपने message का payload क्यों नहीं दिखता?
SAP किसी message की body, headers और properties सिर्फ़ तब रखता है जब वह log level TRACE के साथ चले, और सिर्फ़ लगभग एक घंटे तक। TRACE सेट करें, message फिर से भेजें, और एक घंटे के अंदर trace पढ़ें।
SAP CPI में TRACE कितनी देर चालू रहता है?
लगभग 10 मिनट। उसके बाद iFlow कम log level पर लौट आता है, और जब तक TRACE फिर से सेट न हो, messages trace नहीं होते।
"स्टेप से पहले का कंटेंट" क्या है?
यह message है, जैसा वह किसी step के शुरू होते समय था: उसकी body, headers और exchange properties। इसे अगले step के content से मिलाने पर पता चलता है कि step ने क्या बदला।
क्या tracing से iFlow धीमा होता है?
इससे काम बढ़ता है, क्योंकि हर step का content tenant में लिखा जाता है। जाँच के दौरान इसका इस्तेमाल करें और बाद में बंद कर दें।
क्या एक्सटेंशन TRACE level हमेशा के लिए चालू रखता है?
नहीं। यह TRACE सिर्फ़ तब renew करता है जब switch चालू हो और आप iFlow में काम कर रहे हों, आपकी आख़िरी गतिविधि के 20 मिनट बाद रुक जाता है, और switch बंद करने पर पिछला level लौटा देता है।
क्या Kitegra मेरा trace content सहेजता है?
नहीं। Trace content पेज में दिखाया जाता है और आप उसे डाउनलोड कर सकते हैं; उसे कभी सहेजा, sync या Kitegra को भेजा नहीं जाता।