डेवलपर पोर्टल में अंदरूनी गड़बड़ी

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

समस्या का ब्यौरा

डेवलपर पोर्टल से SmartDocs का इस्तेमाल करके, लाइव एपीआई अनुरोध करते समय गड़बड़ी हुई.

गड़बड़ी के मैसेज

डेवलपर पोर्टल पर दिखने वाली आम गड़बड़ी यह है: “सिस्टम में कोई गड़बड़ी हुई है. कृपया अपना अनुरोध फिर से भेजें”.

गड़बड़ी की संभावित वजहें

यह गड़बड़ी तब हो सकती है, जब डेवलपर पोर्टल को बैकएंड (smartdocs प्रॉक्सी या असल एंडपॉइंट) से कोई जवाब न मिले.

संक्रमण की जांच

अपने ब्राउज़र में “डेवलपर टूल” चालू करें और असल गड़बड़ी की पहचान करने के लिए, नेटवर्क टैब देखें.

आम तौर पर होने वाली गड़बड़ियां और उनकी वजहें, यहां दी गई टेबल में बताई गई हैं:

गड़बड़ी	गड़बड़ी की संभावित वजह(वें)
ERR_NAME_NOT_RESOLVED	SmartDocs प्रॉक्सी को गलत तरीके से कॉन्फ़िगर किया गया है या नेटवर्क फ़ायरवॉल की पाबंदियां
मिला-जुला कॉन्टेंट	पोर्टल को एचटीटीपीएस पर कॉन्फ़िगर किया गया है, SmartDocs का अनुरोध एचटीटीपी पर किया गया है
500 - सर्वर में गड़बड़ी	SmartDocs प्रॉक्सी से गड़बड़ी का मैसेज मिला Edge Message Processor, पब्लिश किए गए एपीआई एंडपॉइंट को कॉल नहीं कर पा रहे हैं

आइए, इन सभी वजहों और समस्या को हल करने के चरणों के बारे में एक-एक करके जानते हैं.

SmartDocs प्रॉक्सी को गलत तरीके से कॉन्फ़िगर किया गया है या नेटवर्क फ़ायरवॉल की पाबंदियां

“ERR_NAME_NOT_RESOLVED” मैसेज से पता चलता है कि smartdocs प्रॉक्सी का यूआरएल गलत तरीके से कॉन्फ़िगर किया गया है. इसके अलावा, यह भी हो सकता है कि जिस नेटवर्क से पोर्टल को ऐक्सेस किया जा रहा है वह फ़ायरवॉल की पाबंदियों की वजह से, smartdocs प्रॉक्सी के यूआरएल को कॉल न कर पा रहा हो. smartdocs प्रॉक्सी को इंटरनेट या इंटरनल नेटवर्क (इंटरनल एपीआई के लिए) से ऐक्सेस किया जा सकता है.

रिज़ॉल्यूशन

पक्का करें कि smartdocs प्रॉक्सी को सभी ज़रूरी नेटवर्क से ऐक्सेस किया जा सके. इसके लिए, smartdocs प्रॉक्सी को Edge पर किसी ऐसे वर्चुअल होस्ट पर डिप्लॉय करें जिसका होस्टनेम इंटरनेट से ऐक्सेस किया जा सकता हो.

पोर्टल को एचटीटीपीएस पर कॉन्फ़िगर किया गया है, SmartDocs का अनुरोध एचटीटीपी पर किया गया है

“मिला-जुला कॉन्टेंट” गड़बड़ी से पता चलता है कि smartdocs प्रॉक्सी को एचटीटीपीएस पर लोड किए गए किसी पेज से एचटीटीपी पर कॉल किया जा रहा है.

रिज़ॉल्यूशन

समस्या को हल करने के लिए, smartdocs प्रॉक्सी को एचटीटीपीएस पर उपलब्ध कराएं. इसके लिए, smartdocs प्रॉक्सी को ऐसे वर्चुअल होस्ट पर डिप्लॉय करें जिसे टीएलएस/एसएसएल (आम तौर पर, “सुरक्षित” वर्चुअल होस्ट) का इस्तेमाल करने के लिए कॉन्फ़िगर किया गया हो.

SmartDocs प्रॉक्सी से गड़बड़ी का मैसेज मिला

500 - सर्वर में गड़बड़ी मैसेज, “smartdocs” प्रॉक्सी में किसी समस्या की वजह से दिख सकता है. इस मामले में, आपको दिखेगा कि smartdocs प्रॉक्सी से यह गड़बड़ी का मैसेज मिला है.

संक्रमण की जांच

“smartdocs” प्रॉक्सी में गड़बड़ियों की पहचान करने के लिए, Trace टूल का इस्तेमाल करें. इसके बारे में यहां बताया गया है . ज़्यादा जानकारी के लिए, Trace टूल का इस्तेमाल करना लेख पढ़ें.

1. “VALIDATE” संगठन में, “smartdocs” प्रॉक्सी के लिए ट्रेस की सुविधा चालू करें. इससे, उस नीति का पता लगाया जा सकेगा जिसकी वजह से 500 - सर्वर में गड़बड़ी का मैसेज दिख रहा है.

2. गड़बड़ी की वजह की पहचान करने के लिए, ट्रेस में उस नीति को चुनें जिसकी वजह से गड़बड़ी हुई है.

रिज़ॉल्यूशन

पहचान की गई गड़बड़ी को ठीक करें. अगर आपको मदद चाहिए, तो Apigee Edge की सहायता टीम से संपर्क करें.

Edge Message Processor, पब्लिश किए गए एपीआई एंडपॉइंट को कॉल नहीं कर पा रहे हैं

500 - सर्वर में गड़बड़ी तब भी हो सकती है, जब Smartdocs प्रॉक्सी को होस्ट करने वाले संगठन के Message Processor, एपीआई एंडपॉइंट को कॉल न कर पाएं.

संक्रमण की जांच

“smartdocs” प्रॉक्सी में गड़बड़ियों की पहचान करने के लिए, Trace टूल का इस्तेमाल करें. इसके बारे में यहां बताया गया है . ज़्यादा जानकारी के लिए, Trace टूल का इस्तेमाल करना लेख पढ़ें.

1. “VALIDATE” संगठन में, “smartdocs” प्रॉक्सी के लिए ट्रेस की सुविधा चालू करें. इससे, उस नीति का पता लगाया जा सकेगा जिसकी वजह से 500 - सर्वर में गड़बड़ी का मैसेज दिख रहा है.

2. ऊपर दिखाए गए यूआई ट्रेस के उदाहरण में, यह देखा गया है कि JavaScript की नीति “BuildTargetAPIRequest”, टारगेट यूआरएल को एक्ज़ीक्यूट नहीं कर पा रही है.

3. JavaScript की नीति “BuildTargetAPIRequest” से टारगेट यूआरएल पाएं.

4. “VALIDATE” संगठन से जुड़े Message Processor नोड से, यूआरएल को सीधे कॉल करें. इसके बारे में यहां बताया गया है:

   curl -v <target URL>

5. दिखने वाली किसी भी गड़बड़ी को ठीक करें.

रिज़ॉल्यूशन

1. पक्का करें कि डेवलपर पोर्टल पर पब्लिश किए गए एपीआई को “VALIDATE” संगठन से जुड़े Message Processor से शुरू किया जा सके. साथ ही, दिखने वाली किसी भी गड़बड़ी को ठीक करें.

2. अगर एपीआई कॉल को सीधे Message Processor से एक्ज़ीक्यूट किया जा सकता है, तो इस बात की काफ़ी संभावना है कि SmartDocs के ज़रिए भी एपीआई को एक्ज़ीक्यूट किया जा सकेगा.

3. SmartDocs के ज़रिए एपीआई कॉल को एक्ज़ीक्यूट करें और देखें कि समस्या ठीक हुई है या नहीं.