ट्रेस टूल का इस्तेमाल करना

Apigee Edge का दस्तावेज़ देखा जा रहा है.
Apigee X के दस्तावेज़ पर जाएं. info

ट्रेस टूल क्या है?

Trace, Apigee Edge पर चल रही एपीआई प्रॉक्सी की समस्याओं को हल करने और उनकी परफ़ॉर्मेंस को मॉनिटर करने का टूल है. ट्रेस की मदद से, एपीआई प्रॉक्सी फ़्लो के हर चरण की जानकारी देखी जा सकती है.

Trace का इस्तेमाल कैसे करें

Trace को इस्तेमाल करना आसान है. ट्रेस सेशन शुरू करें. इसके बाद, Edge प्लैटफ़ॉर्म को एपीआई कॉल करें और नतीजे पढ़ें.

1. एपीआई प्रॉक्सी पेज को ऐक्सेस करें. इसके लिए, यह तरीका अपनाएं.
   

   Edge

   Edge यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके, एपीआई प्रॉक्सी पेज को ऐक्सेस करने के लिए:

   1. apigee.com/edge में साइन इन करें.
   2. बाईं ओर मौजूद नेविगेशन बार में, डेवलप करें > एपीआई प्रॉक्सी को चुनें.

   Edge का नया यूज़र इंटरफ़ेस (Private Cloud)

   New Edge यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके, एपीआई प्रॉक्सी पेज को ऐक्सेस करने के लिए:

   1. New Edge यूज़र इंटरफ़ेस (यूआई) में http://host:3001/edge पर साइन इन करें. यहां host, New Edge यूज़र इंटरफ़ेस (यूआई) चलाने वाले होस्ट का आईपी पता या डीएनएस नाम है.
   2. बाईं ओर मौजूद नेविगेशन बार में, डेवलप करें > एपीआई प्रॉक्सी को चुनें.
2. एपीआई प्रॉक्सी पेज से कोई एपीआई प्रॉक्सी चुनें.
3. पक्का करें कि जिस एपीआई को ट्रेस करना है उसे डिप्लॉय किया गया हो.
4. ट्रेस टूल का व्यू देखने के लिए, ट्रेस करें पर क्लिक करें.
5. ट्रेस करने के लिए डिप्लॉयमेंट ड्रॉपडाउन मेन्यू का इस्तेमाल करके, वह डिप्लॉयमेंट एनवायरमेंट और प्रॉक्सी वर्शन चुनें जिसे आपको ट्रेस करना है.
6. ट्रेस सेशन शुरू करें पर क्लिक करें. ट्रेस सेशन चालू होने पर, एपीआई प्रॉक्सी, प्रोसेसिंग पाइपलाइन में हर चरण की जानकारी रिकॉर्ड करती है. ट्रेस सेशन चालू होने पर, लाइव ट्रैफ़िक से मैसेज और कॉन्टेक्स्ट के हिसाब से डेटा कैप्चर किया जाता है.
   

   

7. अगर आपकी प्रॉक्सी से कोई लाइव ट्रैफ़िक नहीं आ रहा है, तो एपीआई को अनुरोध भेजें. अनुरोध भेजने के लिए, अपनी पसंद के किसी भी टूल का इस्तेमाल किया जा सकता है. जैसे, curl, Postman या कोई भी जाना-पहचाना टूल. इसके अलावा, Trace टूल से सीधे अनुरोध भेजा जा सकता है. सिर्फ़ यूआरएल डालें और भेजें पर क्लिक करें. ध्यान दें: Trace टूल से सिर्फ़ GET अनुरोध भेजा जा सकता है, POST अनुरोध नहीं.
   
   ध्यान दें: एक ट्रेस सेशन में, चुने गए एपीआई प्रॉक्सी के ज़रिए हर मैसेज प्रोसेसर के लिए 10 अनुरोध/जवाब वाले लेन-देन किए जा सकते हैं. Edge क्लाउड में, दो मैसेज प्रोसेसर ट्रैफ़िक को मैनेज करते हैं. साथ ही, अनुरोध/जवाब के 20 लेन-देन किए जा सकते हैं. अगर आपने ट्रेस सेशन को मैन्युअल तरीके से बंद नहीं किया, तो यह 10 मिनट बाद अपने-आप बंद हो जाता है.
   
8. जब आपको लगे कि आपने ज़रूरत के मुताबिक अनुरोध कैप्चर कर लिए हैं, तो ट्रेस सेशन रोकें पर क्लिक करें.
9. बाईं ओर मौजूद मेन्यू में, कैप्चर किए गए अनुरोध/जवाब वाले लेन-देन की सूची दिखती है. ज़्यादा जानकारी देखने के लिए, किसी भी लेन-देन पर क्लिक करें.

ट्रेस को पढ़ने का तरीका

ट्रेस टूल के दो मुख्य हिस्से होते हैं: ट्रांज़ैक्शन मैप और फ़ेज़ की जानकारी:

• लेन-देन के मैप में, आइकॉन का इस्तेमाल किया जाता है. इससे एपीआई प्रॉक्सी लेन-देन के दौरान होने वाले हर अहम चरण को मार्क किया जाता है. इनमें नीति लागू करना, शर्त के हिसाब से होने वाले चरण, और ट्रांज़िशन शामिल हैं. खास जानकारी देखने के लिए, किसी भी आइकॉन पर कर्सर घुमाएं. अनुरोध के फ़्लो के चरण, लेन-देन के मैप में सबसे ऊपर दिखते हैं. साथ ही, जवाब के फ़्लो के चरण सबसे नीचे दिखते हैं.
• टूल के फ़ेज़ की जानकारी सेक्शन में, प्रॉक्सी की इंटरनल प्रोसेसिंग के बारे में जानकारी दी गई होती है. इसमें सेट या पढ़े गए वैरिएबल, अनुरोध और रिस्पॉन्स हेडर वगैरह शामिल होते हैं. किसी भी आइकॉन पर क्लिक करके, उस चरण के लिए फ़ेज़ की जानकारी देखें.

यहां ट्रेस टूल का एक सैंपल मैप दिया गया है. इसमें प्रॉक्सी प्रोसेसिंग के मुख्य सेगमेंट लेबल किए गए हैं:

ट्रेस टूल का लेन-देन मैप

लेन-देन के मैप का लेजेंड

यहां दी गई टेबल में, लेन-देन के मैप में दिखने वाले आइकॉन के बारे में बताया गया है. ये आइकॉन, प्रॉक्सी फ़्लो के दौरान प्रोसेसिंग के हर अहम चरण को मार्क करते हैं.

लेन-देन के मैप आइकॉन

	क्लाइंट ऐप्लिकेशन, एपीआई प्रॉक्सी के ProxyEndpoint को अनुरोध भेजता है.
	सर्कल, प्रॉक्सी फ़्लो में ट्रांज़िशनल एंडपॉइंट को मार्क करते हैं. ये कुकी तब मौजूद होती हैं, जब क्लाइंट से कोई अनुरोध आता है, जब अनुरोध टारगेट को भेजा जाता है, जब टारगेट से जवाब वापस आता है, और जब जवाब वापस क्लाइंट को भेजा जाता है.
	लंबे बार, एपीआई प्रॉक्सी फ़्लो में फ़्लो सेगमेंट की शुरुआत दिखाते हैं. फ़्लो सेगमेंट ये हैं: ProxyEndpoint अनुरोध, TargetEndpoint अनुरोध, TargetEndpoint जवाब, और ProxyEndpoint जवाब. सेगमेंट में PreFlow, Conditional Flows, और PostFlow शामिल होता है. ज़्यादा जानकारी के लिए, फ़्लो कॉन्फ़िगर करना लेख पढ़ें.
	इससे पता चलता है कि Analytics की कार्रवाइयां बैकग्राउंड में हुई हैं.
	शर्त के हिसाब से काम करने वाला ऐसा फ़्लो जो सही के तौर पर आकलन करता है. कंडिशनल फ़्लो के बारे में जानने के लिए, फ़्लो कॉन्फ़िगर करना लेख पढ़ें. ध्यान दें कि कुछ शर्तें, Edge से जनरेट की जाती हैं. उदाहरण के लिए, यहां एक ऐसा एक्सप्रेशन दिया गया है जिसका इस्तेमाल Edge यह देखने के लिए करता है कि ProxyEndpoint में कोई गड़बड़ी हुई है या नहीं: ((error.state equals PROXY_REQ_FLOW) or (error.state equals PROXY_RESP_FLOW))
	शर्त के साथ काम करने वाला ऐसा फ़्लो जिसका आकलन गलत के तौर पर किया जाता है. कंडिशनल फ़्लो के बारे में जानने के लिए, फ़्लो कॉन्फ़िगर करना लेख पढ़ें. ध्यान दें कि कुछ शर्तें, Edge से जनरेट की जाती हैं. उदाहरण के लिए, यहां दिया गया एक्सप्रेशन, Edge इस्तेमाल करता है. इससे यह पता चलता है कि TargetEndpoint में कोई गड़बड़ी हुई है या नहीं: (((error.state equals TARGET_REQ_FLOW) or (error.state equals TARGET_RESP_FLOW)) or ((error.state equals REQ_SENT) or (error.state equals RESP_START)))
	नीतियों का पालन करना होगा. हर तरह की नीति का एक यूनीक आइकॉन होता है. यह AssignMessage नीति के लिए है. इन आइकॉन से पता चलता है कि नीतियां सही क्रम में लागू की गई हैं या नहीं. साथ ही, यह भी पता चलता है कि वे लागू हुई हैं या नहीं. नीति के आइकॉन पर क्लिक करके, यह देखा जा सकता है कि नीति लागू होने के बाद क्या नतीजे मिले और क्या वे उम्मीद के मुताबिक हैं या नहीं. उदाहरण के लिए, यह देखा जा सकता है कि मैसेज को सही तरीके से बदला गया है या नहीं. इसके अलावा, यह भी देखा जा सकता है कि मैसेज को कैश मेमोरी में सेव किया जा रहा है या नहीं. नीतियों को सही तरीके से लागू करने के बारे में, सही का निशान लगाकर साफ़ तौर पर बताया जाता है. गड़बड़ी होने पर, आइकॉन पर लाल रंग का विस्मयादिबोधक चिह्न दिखता है. अहम जानकारी: टूलटिप या टाइमलाइन पर ध्यान दें, ताकि यह पता चल सके कि कोई नीति लागू होने में उम्मीद से ज़्यादा समय तो नहीं ले रही है.
	यह तब दिखता है, जब बैकएंड टारगेट Node.js ऐप्लिकेशन होता है. Apigee Edge पर Node.js के बारे में खास जानकारी देखें.
	एपीआई प्रॉक्सी से कॉल किया गया बैकएंड टारगेट.
	टाइमलाइन से पता चलता है कि प्रोसेस पूरी होने में कितना समय (मिलीसेकंड में) लगा. समय के हिसाब से सेगमेंट की तुलना करने पर, आपको उन नीतियों के बारे में पता चलता है जिन्हें लागू होने में सबसे ज़्यादा समय लगता है. साथ ही, इससे यह भी पता चलता है कि किन नीतियों की वजह से एपीआई कॉल धीमे हो रहे हैं.
	Epsilon से पता चलता है कि समय की अवधि, एक मिलीसेकंड से कम है.
	सबमिट नहीं किया जा सकता. किसी नीति के बंद होने पर, यह आइकॉन नीति के आइकॉन पर दिखता है. सार्वजनिक एपीआई की मदद से, किसी नीति को बंद किया जा सकता है. एपीआई प्रॉक्सी कॉन्फ़िगरेशन का रेफ़रंस देखें.
	गड़बड़ी हुई. यह नीति के आइकॉन पर तब दिखता है, जब नीति के चरण की शर्त का आकलन 'गलत' के तौर पर किया जाता है (फ़्लो वैरिएबल और शर्तें देखें). इसके अलावा, यह RaiseFault नीति के आइकॉन पर तब दिखता है, जब RaiseFault नीति लागू होती है.
	स्किप किया गया. यह आइकॉन, नीति के आइकॉन पर तब दिखता है, जब नीति लागू नहीं की गई हो. ऐसा इसलिए होता है, क्योंकि चरण की शर्त को 'गलत है' के तौर पर मार्क किया गया हो. ज़्यादा जानकारी के लिए, फ़्लो वैरिएबल और शर्तें देखें.

फ़ेज़ की जानकारी को समझना

टूल के फ़ेज़ की जानकारी सेक्शन से, आपको हर प्रोसेसिंग चरण में अपने प्रॉक्सी की स्थिति के बारे में काफ़ी जानकारी मिलती है. यहां फ़ेज़ की जानकारी में दी गई कुछ जानकारी दी गई है. चुने गए चरण की जानकारी देखने के लिए, ट्रेस टूल में मौजूद किसी आइकॉन पर क्लिक करें. इसके अलावा, एक चरण से दूसरे चरण पर जाने के लिए, आगे बढ़ें/वापस जाएं बटन का इस्तेमाल करें.

फ़िल्टर का इस्तेमाल करके मैसेज कैप्चर करने की प्रोसेस को बेहतर बनाना

हेडर और/या क्वेरी पैरामीटर की वैल्यू तय करके, यह फ़िल्टर किया जा सकता है कि Trace टूल में कौनसे अनुरोध दिखें. फ़िल्टर की मदद से, उन खास कॉल को टारगेट किया जा सकता है जिनकी वजह से समस्याएं आ रही हैं. उदाहरण के लिए, आपको ऐसे अनुरोधों पर फ़ोकस करना पड़ सकता है जिनमें कोई खास कॉन्टेंट शामिल हो या जो किसी खास पार्टनर या ऐप्लिकेशन से मिले हों. इनके हिसाब से फ़िल्टर किया जा सकता है:

• एचटीटीपी हेडर - ट्रेस को सिर्फ़ उन कॉल तक सीमित करें जिनमें कोई खास हेडर शामिल है. इससे आपको समस्याओं को हल करने में मदद मिलती है. ऐप्लिकेशन डेवलपर को हेडर भेजकर, उससे उस कॉल में इसे शामिल करने के लिए कहा जा सकता है जिसकी वजह से समस्याएं आ रही हैं. इसके बाद, Apigee Edge सिर्फ़ उस हेडर वाले कॉल रिकॉर्ड करेगा, ताकि आप नतीजों की जांच कर सकें.
• क्वेरी पैरामीटर - सिर्फ़ किसी पैरामीटर की खास वैल्यू वाले कॉल रिकॉर्ड किए जाएंगे.

फ़िल्टर सुविधा के बारे में ज़रूरी बातें

• फ़िल्टर फ़ील्ड में फ़िल्टर पैरामीटर तय करने के बाद, आपको ट्रेस सेशन फिर से शुरू करना होगा.
• फ़िल्टर पैरामीटर को एक साथ AND किया जाता है. मैचिंग के लिए, अनुरोध में बताए गए सभी क्वेरी और/या हेडर के नाम/वैल्यू पेयर मौजूद होने चाहिए.
• फ़िल्टर टूल में पैटर्न मैचिंग की सुविधा काम नहीं करती.
• फ़िल्टर पैरामीटर और वैल्यू, केस-सेंसिटिव (बड़े और छोटे अक्षरों में अंतर) होती हैं.

ट्रेस फ़िल्टर बनाने का तरीका

1. अगर कोई ट्रेस सेशन चल रहा है, तो ट्रेस सेशन बंद करें पर क्लिक करके उसे बंद करें.
2. ट्रेस टूल के सबसे ऊपर बाएं कोने में मौजूद, फ़िल्टर पर क्लिक करें. इससे फ़िल्टर फ़ील्ड बड़ा हो जाएगा.
   
   
   
3. फ़िल्टर फ़ील्ड में, वह क्वेरी पैरामीटर और/या हेडर वैल्यू डालें जिसे आपको फ़िल्टर करना है. इस उदाहरण में, हमने फ़िल्टर करने के लिए दो क्वेरी पैरामीटर तय किए हैं. मैचिंग की प्रोसेस पूरी होने के लिए, अनुरोध में दोनों पैरामीटर मौजूद होने चाहिए.
   
   
   
4. ट्रेस सेशन शुरू करें.
5. अपने एपीआई कॉल करें. सिर्फ़ ऐसे अनुरोधों को मैच माना जाता है जिनमें बताए गए सभी हेडर और/या क्वेरी पैरामीटर शामिल हों.

ऊपर दिए गए उदाहरण में, यह एपीआई कॉल Trace में दिखेगा:

http://docs-test.apigee.net/cats?name=Penny&breed=Calico

हालांकि, इससे:

http://docs-test.apigee.net/cats?name=Penny

ट्रेस की मदद से डीबग करना

ट्रेस की मदद से, एपीआई प्रॉक्सी के बारे में कई तरह की अंदरूनी जानकारी देखी जा सकती है. उदाहरण के लिए:

• आपको एक नज़र में पता चल सकता है कि कौनसी नीतियां सही तरीके से लागू हो रही हैं या लागू नहीं हो रही हैं.
• मान लें कि आपको किसी Analytics डैशबोर्ड से पता चला है कि आपके किसी एपीआई की परफ़ॉर्मेंस में अचानक गिरावट आई है. अब, ट्रेस का इस्तेमाल करके यह पता लगाया जा सकता है कि बॉटलनेक कहां आ रहा है. ट्रेस से पता चलता है कि हर प्रोसेसिंग चरण को पूरा होने में कितना समय लगा. यह समय मिलीसेकंड में होता है. अगर आपको लगता है कि किसी चरण में बहुत ज़्यादा समय लग रहा है, तो उसे ठीक करने के लिए कार्रवाई की जा सकती है.
• फ़ेज़ की जानकारी देखकर, यह देखा जा सकता है कि बैकएंड को कौनसे हेडर भेजे जा रहे हैं. साथ ही, नीतियों के ज़रिए सेट किए गए वैरिएबल वगैरह देखे जा सकते हैं.
• बेस पाथ की पुष्टि करके, यह पक्का किया जा सकता है कि कोई नीति, मैसेज को सही सर्वर पर भेज रही है.

'देखने के विकल्प' चुनना

ट्रेस सेशन के लिए व्यू के विकल्प चुनें.

ट्रेस के नतीजे डाउनलोड करना

टेक्स्ट एडिटर में ऑफ़लाइन देखने और खोजने के लिए, ट्रेस के रॉ डेटा के नतीजों की एक्सएमएल फ़ाइल डाउनलोड की जा सकती है. इस फ़ाइल में, लिसनिंग सेशन की पूरी जानकारी दिखती है. इसमें सभी हेडर, वैरिएबल, और नीतियों का कॉन्टेंट शामिल होता है.

डाउनलोड करने के लिए, ट्रेस सेशन डाउनलोड करें पर क्लिक करें.

अनुरोधों को कर्ल के तौर पर दिखाना

टारगेट सर्वर को किए गए एपीआई कॉल को ट्रेस करने के बाद, अनुरोध को कर्ल कमांड के तौर पर देखा जा सकता है. यह डीबग करने के लिए खास तौर पर मददगार है. इसकी कुछ वजहें यहां दी गई हैं:

• एपीआई प्रॉक्सी, अनुरोध में बदलाव कर सकती है. इसलिए, यह देखना ज़रूरी है कि प्रॉक्सी से टारगेट सर्वर को किया गया अनुरोध, मूल अनुरोध से किस तरह अलग है. curl कमांड, बदले गए अनुरोध को दिखाती है.
• बड़े मैसेज पेलोड के लिए, curl की मदद से एचटीटीपी हेडर और मैसेज का कॉन्टेंट एक ही जगह पर देखा जा सकता है. (फ़िलहाल, इसमें करीब 1,000 वर्णों की सीमा है. इस सीमा को पार करने के बारे में सलाह पाने के लिए, यह कम्यूनिटी पोस्ट देखें.)

सुरक्षा के लिए, curl सुविधा HTTP Authorization हेडर को मास्क करती है.

ट्रेस में एपीआई कॉल के बाद, अनुरोधों को कर्ल के तौर पर देखने के लिए, लेन-देन के मैप के डायग्राम में "टारगेट सर्वर को भेजा गया अनुरोध" स्टेज चुनें. इसके बाद, फ़ेज़ की जानकारी वाले पैनल में "टारगेट सर्वर को भेजा गया अनुरोध" कॉलम में मौजूद, कर्ल दिखाएं बटन पर क्लिक करें.

Apigee की सहायता टीम के लिए ट्रेस का इस्तेमाल

Apigee Edge की मदद से, Apigee सहायता को सहायता पाने के लिए, अपने प्रॉक्सी पर ट्रेस टूल का इस्तेमाल किया जा सकता है. इस विकल्प को कभी भी बंद किया जा सकता है. हालांकि, इस विकल्प को बंद करने पर, हो सकता है कि Apigee सहायता टीम आपको सहायता न दे पाए.

Apigee सहायता को ट्रेस करने वाले टूल का इस्तेमाल करने से रोकने के लिए:

1. https://apigee.com/edge में साइन इन करें.
2. बाईं ओर मौजूद नेविगेशन बार में, एडमिन > निजता और सुरक्षा चुनें.
3. ट्रेस को ट्रेस करने के लिए Apigee सपोर्ट चालू करें को टॉगल करें Apigee सहायता का इस्तेमाल करके ट्रेस टूल का इस्तेमाल बंद करने के लिए.