Apigee Edge का दस्तावेज़ देखा जा रहा है.
Apigee X के दस्तावेज़ पर जाएं. जानकारी
यहां दिए गए सेक्शन में, Apigee से जुड़ी समस्याओं के बारे में बताया गया है. ज़्यादातर मामलों में, सूची में दी गई समस्याओं को आने वाले समय में रिलीज़ होने वाले वर्शन में ठीक कर दिया जाएगा.
Edge से जुड़ी अन्य समस्याएं
यहां दिए गए सेक्शन में, Edge से जुड़ी कुछ समस्याओं के बारे में बताया गया है.
क्षेत्र/खास जानकारी | ज्ञात समस्याएं |
---|---|
कैश मेमोरी खत्म होने की वजह से cachehit की वैल्यू गलत दिखना |
जब समाधान: पहले कॉल के तुरंत बाद, फिर से प्रोसेस दोहराएं (दूसरा कॉल करें). |
InvalidateCache Policy
PurgeChildEntries को 'सही' पर सेट करने से, यह ठीक से काम नहीं करती |
InvalidateCache नीति में इस समस्या को हल करने का तरीका: कैश मेमोरी के वर्शन को दोहराने और कैश मेमोरी को अमान्य करने की ज़रूरत को बायपास करने के लिए, KeyValueMapOperations नीति का इस्तेमाल करें. |
SharedFlow या एपीआई प्रॉक्सी के लिए, एक साथ डिप्लॉयमेंट के अनुरोध करने पर, मैनेजमेंट सर्वर में गड़बड़ी हो सकती है. इस गड़बड़ी की वजह से, एक से ज़्यादा बदलावों को डिप्लॉय किया गया के तौर पर दिखाया जा सकता है. |
उदाहरण के लिए, ऐसा तब हो सकता है, जब अलग-अलग रिविज़न का इस्तेमाल करके, सीआई/सीडी डिप्लॉयमेंट पाइपलाइन के एक साथ कई रन हों. इस समस्या से बचने के लिए, मौजूदा डिप्लॉयमेंट पूरा होने से पहले, एपीआई प्रॉक्सी या SharedFlows को डिप्लॉय करने से बचें. इस समस्या को हल करने का तरीका: एक साथ कई एपीआई प्रॉक्सी या SharedFlow डिप्लॉयमेंट से बचें. |
Edge API Analytics में दिखाए गए एपीआई कॉल की संख्या में डुप्लीकेट डेटा हो सकता है. |
Edge API Analytics में, कभी-कभी एपीआई कॉल के लिए डुप्लीकेट डेटा हो सकता है. ऐसे में, Edge API Analytics में एपीआई कॉल के लिए दिखाई गई गिनती, तीसरे पक्ष के आंकड़े इकट्ठा करने वाले टूल में दिखाई गई वैल्यू से ज़्यादा होती है. इस समस्या को हल करने का तरीका: Analytics डेटा एक्सपोर्ट करें और डेटा से डुप्लीकेट कॉपी हटाने के लिए, gateway_flow_id फ़ील्ड का इस्तेमाल करें. |
Edge यूज़र इंटरफ़ेस (यूआई) की पहले से मालूम समस्याएं
नीचे दिए गए सेक्शन में, Edge यूज़र इंटरफ़ेस (यूआई) की जानी-पहचानी समस्याओं के बारे में बताया गया है.
इलाका | आम तौर पर होने वाली समस्याएं |
---|---|
संगठन को आइडेंटिटी ज़ोन से मैप करने के बाद, नेविगेशन बार से Edge एसएसओ (SSO) ज़ोन एडमिन पेज को ऐक्सेस नहीं कर पाना | किसी संगठन को आइडेंटिटी ज़ोन से कनेक्ट करने पर, एडमिन > एसएसओ (SSO) को चुनकर, बाईं ओर मौजूद नेविगेशन बार से Edge एसएसओ (SSO) ज़ोन एडमिन पेज को ऐक्सेस नहीं किया जा सकता. समाधान के तौर पर, इस यूआरएल का इस्तेमाल करके सीधे पेज पर जाएं: https://apigee.com/sso |
इंटिग्रेट किए गए पोर्टल से जुड़ी समस्याएं
यहां दिए गए सेक्शन में, इंटिग्रेट किए गए पोर्टल से जुड़ी समस्याओं के बारे में बताया गया है.
क्षेत्र | ज्ञात समस्याएं |
---|---|
SmartDocs |
|
एसएएमएल आइडेंटिटी प्रोवाइडर | कस्टम डोमेन के लिए, पहचान की सुविधा देने वाली SAML कंपनी की मदद से एक बार में लॉग आउट करने (एसएलओ) की सुविधा काम नहीं करती. एसएएमएल आइडेंटिटी प्रोवाइडर के साथ कस्टम डोमेन चालू करने के लिए, एसएएमएल सेटिंग कॉन्फ़िगर करते समय, साइन-आउट यूआरएल फ़ील्ड को खाली छोड़ें. |
पोर्टल एडमिन |
|
पोर्टल की सुविधाएं |
|
Edge for Private Cloud से जुड़ी सामान्य समस्याएं
यहां दिए गए सेक्शन में, Edge for Private Cloud से जुड़ी उन समस्याओं के बारे में बताया गया है जिनके बारे में हमें पहले से पता है.
क्षेत्र | ज्ञात समस्याएं |
---|
Edge for Private Cloud 4.53.00 |
412696630: स्टार्टअप के दौरान कीस्टोर लोड नहीं हो सका
ऐसा हो सकता है कि |
Edge for Private Cloud 4.53.00 |
Java कॉलआउट
"BC" नाम का इस्तेमाल करके, Bouncy Castle क्रिप्टोग्राफ़ी प्रोवाइडर को लोड करने की कोशिश करने वाले ग्राहक के Java कॉलआउट काम नहीं कर सकते. ऐसा इसलिए, क्योंकि FIPS के साथ काम करने के लिए, डिफ़ॉल्ट प्रोवाइडर को Bouncy Castle FIPS में बदल दिया गया है. अब आपको "BCFIPS" का इस्तेमाल करना होगा. |
Edge for Private Cloud 4.52.01 Mint अपडेट |
इस समस्या का असर सिर्फ़ उन लोगों पर पड़ता है जो MINT का इस्तेमाल कर रहे हैं या जिन्होंने Edge for Private Cloud इंस्टॉलेशन में MINT चालू किया है. असर डालने वाला कॉम्पोनेंट: edge-message-processor समस्या: अगर आपने कमाई करने की सुविधा चालू की है और 4.52.01 को नए इंस्टॉलेशन के तौर पर इंस्टॉल किया जा रहा है या पिछले Private Cloud वर्शन से अपग्रेड किया जा रहा है, तो आपको मैसेज प्रोसेसर से जुड़ी समस्या का सामना करना पड़ेगा. इससे ओपन थ्रेड की संख्या में धीरे-धीरे बढ़ोतरी होगी और संसाधन खत्म हो जाएंगे. edge-message-processor system.log में यह अपवाद दिखता है: Error injecting constructor, java.lang.OutOfMemoryError: unable to create new native thread |
Apigee में एचटीटीपी/2 से जुड़ी जोखिम की संभावना | हाल ही में, एचटीटीपी/2 प्रोटोकॉल (CVE-2023-44487) के कई वर्शन में, सेवा से इनकार (DoS) की एक कमज़ोरी का पता चला है. इसमें Private Cloud के लिए Apigee Edge भी शामिल है. इस जोखिम की वजह से, Apigee API मैनेजमेंट की सुविधा में DoS हो सकता है. ज़्यादा जानकारी के लिए, Apigee का सुरक्षा बुलेटिन GCP-2023-032 देखें. Edge for Private Cloud के राउटर और मैनेजमेंट सर्वर कॉम्पोनेंट, इंटरनेट पर उपलब्ध होते हैं. इसलिए, इनमें जोखिम हो सकता है. हालांकि, Private Cloud के लिए Edge के Edge-specific कॉम्पोनेंट के मैनेजमेंट पोर्ट पर HTTP/2 चालू है, लेकिन इनमें से कोई भी कॉम्पोनेंट इंटरनेट पर उपलब्ध नहीं है. Cassandra, Zookeeper वगैरह जैसे Edge कॉम्पोनेंट पर, HTTP/2 चालू नहीं है. हमारा सुझाव है कि Edge for Private Cloud में मौजूद जोखिम को ठीक करने के लिए, यह तरीका अपनाएं:
अगर Edge Private Cloud के 4.51.00.11 या इसके बाद के वर्शन का इस्तेमाल किया जा रहा है, तो यह तरीका अपनाएं:
अगर Private Cloud के 4.51.00.11 से पुराने वर्शन के लिए Edge का इस्तेमाल किया जा रहा है, तो यह तरीका अपनाएं:
|
वर्शन 4.52 पर अपडेट करते समय Postgresql को अपग्रेड करना | Apigee-postgresql को Edge for Private Cloud के 4.50 या 4.51 वर्शन से 4.52 वर्शन पर अपग्रेड करने में समस्याएं आ रही हैं. ये समस्याएं मुख्य रूप से तब होती हैं, जब टेबल की संख्या 500 से ज़्यादा होती है. नीचे दी गई एसक्यूएल क्वेरी चलाकर, Postgres में मौजूद टेबल की कुल संख्या देखी जा सकती है: select count(*) from information_schema.tables समस्या हल करने का तरीका: Apigee Edge 4.50.00 या 4.51.00 को 4.52.00 पर अपडेट करते समय, Apigee-postgresql को अपग्रेड करने से पहले, शुरुआती चरण पूरा करना न भूलें. |
LDAP नीति | 149245401: LDAP संसाधन के ज़रिए कॉन्फ़िगर की गई JNDI के लिए, LDAP कनेक्शन पूल की सेटिंग लागू नहीं होती हैं. साथ ही, JNDI की डिफ़ॉल्ट सेटिंग की वजह से, हर बार एक बार इस्तेमाल किए जा सकने वाले कनेक्शन बनते हैं. इस वजह से, हर बार कनेक्शन खुलते और बंद होते हैं. इससे LDAP सर्वर से हर घंटे बहुत सारे कनेक्शन बन जाते हैं. समाधान: एलडीएपी कनेक्शन पूल की प्रॉपर्टी बदलने के लिए, नीचे दिया गया तरीका अपनाएं. इससे सभी एलडीएपी नीतियों में एक साथ बदलाव किया जा सकेगा.
यह पुष्टि करने के लिए कि आपकी कनेक्शन पूल JNDI प्रॉपर्टी लागू हो रही हैं, tcpdump किया जा सकता है. इससे समय के साथ LDAP कनेक्शन पूल के व्यवहार का पता चलता है. |
अनुरोध प्रोसेस होने में ज़्यादा समय लग रहा है | 139051927: मैसेज प्रोसेसर में प्रॉक्सी प्रोसेस होने में ज़्यादा समय लग रहा है. इससे सभी एपीआई प्रॉक्सी पर असर पड़ रहा है. इसके लक्षणों में, एपीआई के सामान्य रिस्पॉन्स टाइम की तुलना में, प्रोसेस होने में 200 से 300 मि॰से॰ की देरी होना शामिल है. यह कम टीपीएस के साथ भी अचानक हो सकता है. ऐसा तब हो सकता है, जब मैसेज प्रोसेसर 50 से ज़्यादा टारगेट सर्वर से कनेक्ट करता है. समस्या की मुख्य वजह: मैसेज प्रोसेसर, एक कैश मेमोरी बनाए रखते हैं. यह कैश मेमोरी, टारगेट सर्वर के यूआरएल को HTTPClient ऑब्जेक्ट से मैप करती है. ऐसा टारगेट सर्वर को भेजे जाने वाले कनेक्शन के लिए किया जाता है. डिफ़ॉल्ट रूप से, यह सेटिंग 50 पर सेट होती है. यह ज़्यादातर डिप्लॉयमेंट के लिए बहुत कम हो सकती है. जब किसी डिप्लॉयमेंट में सेटअप के दौरान, एक से ज़्यादा संगठन/एनवायरमेंट के कॉम्बिनेशन होते हैं और टारगेट सर्वर की संख्या 50 से ज़्यादा होती है, तो टारगेट सर्वर के यूआरएल, कैश मेमोरी से बार-बार हटा दिए जाते हैं. इससे लेटेन्सी बढ़ जाती है. पुष्टि करना: यह पता लगाने के लिए कि टारगेट सर्वर के यूआरएल को हटाने की वजह से, अनुरोध पूरा होने में ज़्यादा समय लग रहा है, Message Processor के system.logs में "onEvict" या "Eviction" कीवर्ड खोजें. लॉग में इनकी मौजूदगी से पता चलता है कि टारगेट सर्वर के यूआरएल को HTTPClient कैश मेमोरी से हटाया जा रहा है. ऐसा इसलिए हो रहा है, क्योंकि कैश मेमोरी का साइज़ बहुत छोटा है. समस्या हल करने का तरीका:
Edge for Private Cloud के वर्शन 19.01 और 19.06 के लिए, HTTPClient कैश में बदलाव किया जा सकता है और उसे कॉन्फ़िगर किया जा सकता है. इसके लिए, conf/http.properties+HTTPClient.dynamic.cache.elements.size=500 इसके बाद, मैसेज प्रोसेसर को रीस्टार्ट करें. सभी मैसेज प्रोसेसर के लिए एक जैसे बदलाव करें. वैल्यू 500 एक उदाहरण है. आपके सेटअप के लिए सबसे सही वैल्यू, उन टारगेट सर्वर की संख्या से ज़्यादा होनी चाहिए जिनसे मैसेज प्रोसेसर कनेक्ट होगा. इस प्रॉपर्टी को ज़्यादा पर सेट करने से कोई साइड इफ़ेक्ट नहीं होता. इसका सिर्फ़ यह असर होता है कि मैसेज प्रोसेसर के प्रॉक्सी अनुरोध को प्रोसेस करने में कम समय लगता है.
ध्यान दें: Edge for Private Cloud के वर्शन 50.00 में, डिफ़ॉल्ट सेटिंग 500 पर सेट होती है. |
की वैल्यू मैप के लिए एक से ज़्यादा एंट्री | 157933959: संगठन या एनवायरमेंट लेवल पर स्कोप किए गए एक ही कुंजी वैल्यू मैप (केवीएम) में एक साथ इंसर्ट और अपडेट करने से, डेटा में अंतर आ जाता है और अपडेट नहीं हो पाते. ध्यान दें: यह सीमा सिर्फ़ Edge for Private Cloud पर लागू होती है. सार्वजनिक क्लाउड और हाइब्रिड के लिए Edge में यह सीमा लागू नहीं होती. Edge for Private Cloud में इस समस्या को हल करने के लिए, |