Apigee की आम समस्याएं

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

इन सेक्शन में, Apigee की आम समस्याओं के बारे में बताया गया है. ज़्यादातर मामलों में, बताई गई समस्याओं को आने वाली रिलीज़ में ठीक कर दिया जाएगा.

मिसलेनियस एज की ज्ञात समस्याएं

यहां दिए गए सेक्शन में, Edge की अलग-अलग तरह की समस्याओं के बारे में बताया गया है.

इलाका आम तौर पर होने वाली समस्याएं
कैश मेमोरी की समयसीमा खत्म होने की वजह से, cachehit की गलत वैल्यू मिलती है

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

समाधान: पहले कॉल के तुरंत बाद प्रक्रिया को फिर से दोहराएं (दूसरा कॉल करें).

अमान्यकेट कैश नीति PurgeChildEntries को 'सही है' पर सेट करने की सुविधा ठीक से काम नहीं करती

अमान्य कैश मेमोरी नीति में PurgeChildEntries को सेट करने से, सिर्फ़ KeyFragment एलिमेंट की वैल्यू पूरी तरह मिटनी चाहिए. हालांकि, इससे पूरी कैश मेमोरी मिट जाती है.

समाधान: कैश वर्शनिंग को दोहराने और कैश अमान्य होने की ज़रूरत को बायपास करने के लिए, KeyValueMapOperations की नीति का इस्तेमाल करें.

Edge यूज़र इंटरफ़ेस (यूआई) की पहले से मालूम समस्याएं

नीचे दिए गए सेक्शन में, Edge यूज़र इंटरफ़ेस (यूआई) की जानी-पहचानी समस्याओं के बारे में बताया गया है.

इलाका आम तौर पर होने वाली समस्याएं
संगठन को आइडेंटिटी ज़ोन से मैप करने के बाद, नेविगेशन बार से Edge एसएसओ (SSO) ज़ोन एडमिन पेज को ऐक्सेस नहीं कर पाना किसी संगठन को आइडेंटिटी ज़ोन से कनेक्ट करने पर, एडमिन > एसएसओ (SSO) को चुनकर, बाईं ओर मौजूद नेविगेशन बार से Edge एसएसओ (SSO) ज़ोन एडमिन पेज को ऐक्सेस नहीं किया जा सकता. समाधान के तौर पर, इस यूआरएल का इस्तेमाल करके सीधे पेज पर जाएं: https://apigee.com/sso

इंटिग्रेट किए गए पोर्टल की सामान्य समस्याएं

नीचे दिए सेक्शन में, इंटिग्रेट किए गए पोर्टल से जुड़ी समस्याओं के बारे में बताया गया है.

इलाका आम तौर पर होने वाली समस्याएं
SmartDocs
  • स्पेसिफ़िकेशन एडिटर की मदद से स्पेसिफ़िकेशन बनाने पर और अपने पोर्टल पर SmartDocs की मदद से एपीआई पब्लिश करने पर, Apigee Edge OpenAPI स्पेसिफ़िकेशन 3.0 के साथ काम करता है. हालांकि, कुछ सुविधाएं फ़िलहाल इस पर काम नहीं करती हैं.

    उदाहरण के लिए, OpenAPI स्पेसिफ़िकेशन 3.0 की ये सुविधाएं अभी काम नहीं करती हैं:

    • स्कीमा को मिलाने और बढ़ाने के लिए allOf प्रॉपर्टी
    • रिमोट रेफ़रंस

    अगर आपके OpenAPI स्पेसिफ़िकेशन में, काम न करने वाली किसी सुविधा के बारे में बताया गया है, तो कुछ मामलों में टूल, सुविधा को नज़रअंदाज़ कर देंगे, लेकिन एपीआई के रेफ़रंस दस्तावेज़ को रेंडर करेंगे. अन्य मामलों में, काम न करने वाली सुविधा की वजह से गड़बड़ियां हो सकती हैं. इससे एपीआई रेफ़रंस दस्तावेज़ को रेंडर होने में समस्या आ सकती है. दोनों ही मामलों में, आपको OpenAPI स्पेसिफ़िकेशन में बदलाव करना होगा, ताकि काम न करने वाली सुविधा का इस्तेमाल तब तक न किया जा सके, जब तक आने वाले वर्शन में इसे इस्तेमाल न किया जा सके.

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

  • पोर्टल में इस एपीआई को आज़माएं का इस्तेमाल करते समय, Accept हेडर application/json पर सेट होता है. इससे कोई फ़र्क़ नहीं पड़ता कि OpenAPI स्पेसिफ़िकेशन में, consumes के लिए वैल्यू कुछ भी सेट की गई है.
एसएएमएल आइडेंटिटी प्रोवाइडर कस्टम डोमेन के लिए, एसएएमएल के आइडेंटिटी प्रोवाइडर की मदद से एक बार लॉग आउट (एसएलओ) नहीं किया जा सकता. एसएएमएल आइडेंटिटी प्रोवाइडर की मदद से कस्टम डोमेन को चालू करने के लिए, एसएएमएल सेटिंग को कॉन्फ़िगर करते समय, साइन-आउट करने का यूआरएल फ़ील्ड को खाली छोड़ दें.
पोर्टल एडमिन
  • एक साथ कई लोगों को पोर्टल के अपडेट नहीं मिलेंगे. जैसे- पेज, थीम, सीएसएस या स्क्रिप्ट में बदलाव.
  • अगर पोर्टल से किसी एपीआई रेफ़रंस दस्तावेज़ वाले पेज को मिटाया जाता है, तो इसे फिर से बनाने का कोई तरीका नहीं होता. आपको एपीआई प्रॉडक्ट को मिटाकर, उसे फिर से जोड़ना होगा और एपीआई के रेफ़रंस दस्तावेज़ को फिर से जनरेट करना होगा.
  • कॉन्टेंट की सुरक्षा नीति को कॉन्फ़िगर करते समय, बदलावों को पूरी तरह से लागू होने में 15 मिनट लग सकते हैं.
  • पोर्टल थीम को पसंद के मुताबिक बनाते समय, बदलावों को पूरी तरह से लागू होने में पांच मिनट लग सकते हैं.
पोर्टल की सुविधाएं
  • आने वाले समय में, Search को इंटिग्रेट किए गए पोर्टल में इंटिग्रेट किया जाएगा.

प्राइवेट क्लाउड के लिए Edge से जुड़ी सामान्य समस्याएं

नीचे दिए गए सेक्शन में, प्राइवेट क्लाउड के लिए Edge से जुड़ी समस्याओं के बारे में बताया गया है.

क्षेत्र पहले से मालूम समस्याएं
OPDK 4.52.01 मिंट अपडेट

यह समस्या सिर्फ़ उन लोगों पर असर डालती है जो MINT का इस्तेमाल कर रहे हैं या प्राइवेट क्लाउड इंस्टॉलेशन के लिए Edge में MINT चालू है.

इस कॉम्पोनेंट पर असर हुआ है: एज-मैसेज प्रोसेसर

समस्या: अगर आपने कमाई करने की सुविधा चालू की है और 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) को लागू करना. इसमें, Apigee Edge में प्राइवेट क्लाउड. इस गड़बड़ी की वजह से, Apigee एपीआई को मैनेज करने की सुविधा का डीओएस (DS) हो सकता है. ज़्यादा जानकारी के लिए, Apigee Security बुलेटिन GCP-2023-032 देखें.

Edge for Private Cloud रूटर और मैनेजमेंट सर्वर के कॉम्पोनेंट, और जोखिम की आशंका हो सकती है. हालांकि, मैनेजमेंट के लिए एचटीटीपी/2 चालू है प्राइवेट क्लाउड के लिए Edge के लिए अन्य खास कॉम्पोनेंट का पोर्ट, इनमें से कोई भी कॉम्पोनेंट को खतरा है. नॉन-एज कॉम्पोनेंट पर, जैसे कि कैसंड्रा, ज़ूकीपर वगैरह, एचटीटीपी/2 चालू नहीं है. हमारा सुझाव है कि आप Edge for Private Cloud के जोखिम की आशंका को दूर करने के लिए, यह तरीका अपनाएं:

अगर Edge Private Cloud के 4.51.00.11 या इसके बाद के वर्शन का इस्तेमाल किया जा रहा है, तो यह तरीका अपनाएं:

  1. मैनेजमेंट सर्वर को अपडेट करें:

    1. हर मैनेजमेंट सर्वर नोड पर, /opt/apigee/customer/application/management-server.properties खोलें
    2. प्रॉपर्टी फ़ाइल में यह लाइन जोड़ें: 
      conf_webserver_http2.enabled=false
    3. मैनेजमेंट सर्वर कॉम्पोनेंट को रीस्टार्ट करें: 
      apigee-service edge-management-server restart

  2. मैसेज प्रोसेसर को अपडेट करें:

    1. हर मैसेज प्रोसेसर नोड पर, /opt/apigee/customer/application/message-processor.properties खोलें
    2. प्रॉपर्टी फ़ाइल में यह लाइन जोड़ें: 
      conf_webserver_http2.enabled=false
    3. मैसेज प्रोसेसर कॉम्पोनेंट को रीस्टार्ट करें: 
      apigee-service edge-message-processor restart

  3. रूटर अपडेट करें:

    1. हर राऊटर नोड पर /opt/apigee/customer/application/router.properties खोलें
    2. प्रॉपर्टी फ़ाइल में यह लाइन जोड़ें: 
      conf_webserver_http2.enabled=false
    3. मैसेज प्रोसेसर कॉम्पोनेंट को रीस्टार्ट करें: 
      apigee-service edge-router restart

  4. क्यूपीआईडी अपडेट करें:

    1. हर QPID नोड पर, /opt/apigee/customer/application/qpid-server.properties खोलें
    2. प्रॉपर्टी फ़ाइल में यह लाइन जोड़ें: 
      conf_webserver_http2.enabled=false
    3. मैसेज प्रोसेसर कॉम्पोनेंट को रीस्टार्ट करें: 
      apigee-service edge-qpid-server restart

  5. पोस्टग्रेस अपडेट करें:

    1. हर Postgres नोड पर, /opt/apigee/customer/application/postgres-server.properties खोलें
    2. प्रॉपर्टी फ़ाइल में यह लाइन जोड़ें: 
      conf_webserver_http2.enabled=false
    3. मैसेज प्रोसेसर कॉम्पोनेंट को रीस्टार्ट करें: 
      apigee-service edge-postgres-server restart

अगर 4.51.00.11 से पुराने प्राइवेट क्लाउड वर्शन के लिए Edge इस्तेमाल किया जा रहा है, तो यह तरीका अपनाएं:

  1. मैनेजमेंट सर्वर को अपडेट करें:

    1. हर मैनेजमेंट सर्वर नोड पर, /opt/apigee/customer/application/management-server.properties खोलें
    2. प्रॉपर्टी फ़ाइल में ये दो लाइनें जोड़ें: 
      conf_webserver_http2.enabled=false
conf/webserver.properties+http2.enabled=false
    3. मैनेजमेंट सर्वर कॉम्पोनेंट को रीस्टार्ट करें: 
      apigee-service edge-management-server restart

  2. मैसेज प्रोसेसर को अपडेट करें:

    1. हर मैसेज प्रोसेसर नोड पर, /opt/apigee/customer/application/message-processor.properties खोलें
    2. प्रॉपर्टी फ़ाइल में ये दो लाइनें जोड़ें: 
      conf_webserver_http2.enabled=false
conf/webserver.properties+http2.enabled=false
    3. मैसेज प्रोसेसर कॉम्पोनेंट को रीस्टार्ट करें: 
      apigee-service edge-message-processor restart

  3. रूटर अपडेट करें:

    1. हर राऊटर नोड पर /opt/apigee/customer/application/router.properties खोलें
    2. प्रॉपर्टी फ़ाइल में ये दो लाइनें जोड़ें: 
      conf_webserver_http2.enabled=false
conf/webserver.properties+http2.enabled=false
    3. मैसेज प्रोसेसर कॉम्पोनेंट को रीस्टार्ट करें: 
      apigee-service edge-router restart

  4. क्यूपीआईडी अपडेट करें:

    1. हर QPID नोड पर, /opt/apigee/customer/application/qpid-server.properties खोलें
    2. प्रॉपर्टी फ़ाइल में ये दो लाइनें जोड़ें: 
      conf_webserver_http2.enabled=false
conf/webserver.properties+http2.enabled=false
    3. मैसेज प्रोसेसर कॉम्पोनेंट को रीस्टार्ट करें: 
      apigee-service edge-qpid-server restart

  5. पोस्टग्रेस अपडेट करें:

    1. हर Postgres नोड पर, /opt/apigee/customer/application/postgres-server.properties खोलें
    2. प्रॉपर्टी फ़ाइल में ये दो लाइनें जोड़ें: 
      conf_webserver_http2.enabled=false
conf/webserver.properties+http2.enabled=false
    3. मैसेज प्रोसेसर कॉम्पोनेंट को रीस्टार्ट करें: 
      apigee-service edge-postgres-server restart
वर्शन 4.52 में अपडेट करते समय Postgresql का अपग्रेड होना

Apigee-postgresql को प्राइवेट क्लाउड के लिए Edge से अपग्रेड करने में समस्याएं आ रही हैं 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 में अपडेट करना, तो शुरुआती चरण.
RHEL 8.0 पर apigee-mirror

apigee-mirror, Red Hat Enterprise Linux (RHEL) 8.0 पर काम नहीं करता.

समाधान: समाधान के तौर पर, पुराने वर्शन वाले सर्वर पर apigee-mirror इंस्टॉल करें RHEL या किसी दूसरी जगह समर्थित ऑपरेटिंग सिस्टम. इसके बाद, स्क्रीन शेयर करने के लिए मिरर का इस्तेमाल किया जा सकता है अगर आपने RHEL 8.0 सर्वर पर Apigee इंस्टॉल किया है, तब भी पैकेज जोड़ें.

LDAP नीति

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

समाधान:

LDAP कनेक्शन पूल प्रॉपर्टी बदलने के लिए, यह करें सभी LDAP नीतियों में वैश्विक बदलाव सेट करने के लिए, नीचे दिया गया तरीका अपनाएं.

  1. अगर कॉन्फ़िगरेशन प्रॉपर्टी फ़ाइल पहले से मौजूद नहीं है, तो उसे बनाएं: 
    /opt/apigee/customer/application/message-processor.properties
  2. फ़ाइल में निम्न जोड़ें (के मान बदलें Java नेमिंग और डायरेक्ट्री इंटरफ़ेस (जेएनडीआई) प्रॉपर्टी पर आधारित होता है). 
    bin_setenv_ext_jvm_opts="-Dcom.sun.jndi.ldap.connect.pool.maxsize=20
-Dcom.sun.jndi.ldap.connect.pool.prefsize=2
-Dcom.sun.jndi.ldap.connect.pool.initsize=2
-Dcom.sun.jndi.ldap.connect.pool.timeout=120000
-Dcom.sun.jndi.ldap.connect.pool.protocol=ssl"
  3. पक्का करें कि फ़ाइल /opt/apigee/customer/application/message-processor.properties है मालिक apigee:apigee.
  4. मैसेज प्रोसेस करने वाली हर कंपनी को रीस्टार्ट करें.

यह पुष्टि करने के लिए कि आपका कनेक्शन पूल JNDI प्रॉपर्टी को लागू किया जा रहा है, तो आपको LDAP कनेक्शन पूल के व्यवहार को देखने के लिए, tcpdump को लागू करें समय के साथ.
ज़्यादा अनुरोध प्रोसेस होने में लगने वाला समय

139051927: मैसेज प्रोसेसर में, प्रॉक्सी प्रोसेसिंग में देरी होने का पता चला है असर डाल रहे हैं सभी API प्रॉक्सी. लक्षणों में, सामान्य से ज़्यादा समय में 200-300 मि॰से॰ की देरी शामिल है एपीआई से मिला रिस्पॉन्स टीपीएस कम होने पर भी यह किसी भी क्रम में हो सकता है. ऐसा तब हो सकता है, जब 50 से ज़्यादा टारगेट हों ऐसे सर्वर जिनमें मैसेज प्रोसेसर कनेक्शन बनाता है.

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

पुष्टि करना: यह पता लगाने के लिए कि क्या लक्षित सर्वर URL के निकालने की वजह से प्रतीक्षा अवधि की समस्या हो रही है, मैसेज प्रोसेसर system.logs "onEvict" कीवर्ड के लिए या "हटाना" शामिल है. लॉग में इनकी मौजूदगी से पता चलता है कि टारगेट सर्वर यूआरएल को HTTPClient कैशे से हटाया जा रहा है, क्योंकि कैश का साइज़ बहुत छोटा है.

समाधान: Edge for Private Cloud के वर्शन 19.01 और 19.06 के लिए, एचटीटीपीक्लाइंट में बदलाव किया जा सकता है और उन्हें कॉन्फ़िगर किया जा सकता है कैश मेमोरी, /opt/apigee/customer/application/message-processor.properties:

conf/http.properties+HTTPClient.dynamic.cache.elements.size=500

इसके बाद, मैसेज प्रोसेसर को रीस्टार्ट करें. सभी मैसेज प्रोसेसर के लिए एक जैसे बदलाव करें.

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

ध्यान दें: Private Cloud के वर्शन 50.00 की डिफ़ॉल्ट सेटिंग 500 होती है.
की वैल्यू मैप के लिए एक से ज़्यादा एंट्री

157933959: एक ही की-वैल्यू मैप (KVM) के दायरे में एक ही समय पर इंसर्ट और अपडेट संगठन या एनवायरमेंट लेवल की वजह से, डेटा में अंतर हो सकता है और अपडेट खो गए हैं.

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

Edge में निजी क्लाउड के इस्तेमाल के लिए, apiproxy स्कोप.