रनटाइम से जुड़ी गड़बड़ियों का कैटलॉग

आपको Apigee Edge दस्तावेज़ दिख रहा है.
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है इस पेज पर जाएं Apigee X दस्तावेज़. जानकारी

Apigee Edge में गड़बड़ियां

जब Apigee Edge, Apigee Edge के कॉम्पोनेंट, राऊटर, और मैसेज प्रोसेसर या बैकएंड से एपीआई अनुरोध किए जाते हैं सर्वर, क्लाइंट ऐप्लिकेशन में गड़बड़ियां लौटा सकते हैं.

मैसेज प्रोसेसर से जुड़ी गड़बड़ियां

मैसेज प्रोसेसर, Apigee Edge का मुख्य कॉम्पोनेंट है, जो नीतियों और बैकएंड सर्वर के साथ इंटरैक्ट करता है. अगर इसे नीचे दी गई किसी भी समस्या का पता चलता है, तो वह गड़बड़ी दिखा सकता है:

  • नेटवर्क कनेक्टिविटी से जुड़ी समस्याएं, TLS हैंडशेक की समस्याएं, बैकएंड सर्वर का उपलब्ध न होना, बैकएंड सर्वर से कम्यूनिकेशन के दौरान रिस्पॉन्स न मिलना
  • नीति लागू होने के दौरान होने वाली गड़बड़ियां
  • अमान्य एचटीटीपी हेडर, एन्कोडिंग, पाथ, एचटीटीपी स्पेसिफ़िकेशन का पालन नहीं किया जाना, तय सीमा से ज़्यादा होना सीमा वगैरह:
    • क्लाइंट ऐप्लिकेशन से भेजे गए एचटीटीपी अनुरोध के साथ

      • या

    • बैकएंड सर्वर से भेजे गए एचटीटीपी रिस्पॉन्स के साथ
  • और भी बहुत कुछ

मैसेज प्रोसेसर से सैंपल में गड़बड़ी हुई

मैसेज प्रोसेसर, हमेशा एचटीटीपी स्टेटस कोड के साथ गड़बड़ी का मैसेज दिखाता है JSON फ़ॉर्मैट में गड़बड़ी का कोड, जैसा कि नीचे दिखाया गया है:

क्लाइंट ऐप्लिकेशन को रिस्पॉन्स कोड मिलता है. इसका उदाहरण नीचे दिया गया है: 

HTTP/1.1 414 Request-URI Too Long

इस फ़ॉर्मैट में, मैसेज प्रोसेसर से गड़बड़ी का रिस्पॉन्स दिखता है: 

{
   "fault":{
      "faultstring":"request line size exceeding 7,168",
      "detail":{
         "errorcode":"protocol.http.TooBigLine"
      }
   }
}

गड़बड़ी के जवाब में मौजूद फ़ील्ड का ब्यौरा:

फ़ील्ड ब्यौरा
faultstring इसमें गड़बड़ी का एक मैसेज शामिल होता है, जिसमें गड़बड़ी की संभावित वजह बताई जाती है
errorcode गड़बड़ी कोड (इसे गलत कोड भी कहा जाता है) कोई गड़बड़ी हुई है

रनटाइम की गड़बड़ियों का कैटलॉग

गड़बड़ी के इस कैटलॉग में, रनटाइम के बारे में पूरी जानकारी मौजूद है) गड़बड़ी के कोड (नीति से जुड़ी गड़बड़ियों के लिए) जो Apigee Edge मैसेज से मिलती हैं प्रोसेसर कॉम्पोनेंट. इसमें हर गड़बड़ी के कोड के लिए, नीचे दी गई जानकारी शामिल होती है:

  • एचटीटीपी स्टेटस कोड
  • गड़बड़ी का मैसेज
  • गड़बड़ी की संभावित वजहें
  • इससे जुड़ा कोई एचटीटीपी स्पेसिफ़िकेशन और/या प्रॉडक्ट की सीमाएं
  • ऐसी प्लेबुक और वीडियो जिनमें गड़बड़ी की वजह का पता लगाने के निर्देश होते हैं और ऐसे कारगर समाधान जिनका इस्तेमाल करके, गड़बड़ी को खुद ठीक किया जा सकता है (जहां उपलब्ध हो)
  • गड़बड़ी को ठीक करने के लिए, उसे खुद आवेदन किया जा सकता है

गड़बड़ी के कोड की ये कैटगरी शामिल हैं:

ऊपर दी गई जानकारी देखने के लिए, टेबल को फ़िल्टर करने के लिए, नीचे दिए गए खोज बॉक्स का इस्तेमाल करें देखें. स्टेटस कोड या किसी भी फ़ील्ड में कॉन्टेंट खोजा जा सकता है टेबल में.

गड़बड़ी का कोड ब्यौरा ठीक करें

flow.*

flow.APITimedOut
  • एचटीटीपी स्टेटस कोड:
 504 Gateway Timeout
  • गड़बड़ी का मैसेज:
 API timed out
  • संभावित वजह:

यह गड़बड़ी तब होती है, जब:

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

ध्यान दें: इस प्लेबुक में गड़बड़ी के कोड को हल करने का तरीका बताया गया है messaging.adaptors.http.flow.GatewayTimeout; हालांकि, आपको डाइग्नोस्टिक टूल की मदद से flow.APITimedOut के गड़बड़ी कोड की समस्या को हल करने के लिए उसी प्लेबुक का इस्तेमाल करें.

प्लेबुक

flow.SharedFlowNotFound
  • एचटीटीपी स्टेटस कोड:
 500 Internal Server Error
  • गड़बड़ी का मैसेज:
 Shared Flow {shared_flow_name} Not Found
  • संभावित वजह:

यह गड़बड़ी तब होती है, जब:

  • मौजूद नहीं है

    • या

  • मौजूद है, लेकिन डिप्लॉय नहीं किया गया है
प्लेबुक

messaging.adaptors.http.flow

messaging.adaptors.http.flow.ApplicationNotFound
  • एचटीटीपी स्टेटस कोड:
 404 Not Found
  • गड़बड़ी का मैसेज:
 Unable to identify proxy for host: {virtual_host} and url: {pathsuffix}
  • संभावित वजह:

यह गड़बड़ी, इनमें से किसी एक स्थिति में होती है:

  1. खास एपीआई प्रॉक्सी:
    1. विशिष्ट URL पर अनुरोध स्वीकार करने के लिए कॉन्फ़िगर नहीं किया गया वर्चुअल होस्ट
    2. किसी खास पाथ पर अनुरोध स्वीकार करने के लिए कॉन्फ़िगर नहीं किया गया है अनुरोध में इस्तेमाल किया गया
    3. उस खास एनवायरमेंट में डिप्लॉय नहीं किया गया हो जिसमें आपको डिप्लॉय करना है एपीआई अनुरोध करने की कोशिश कर रहे हैं
    4. एक या उससे ज़्यादा मैसेज प्रोसेसर पर डिप्लॉय नहीं किया गया है
  2. वह खास परिवेश जिसमें आप बनाने की कोशिश कर रहे हैं एपीआई अनुरोध एक या उससे ज़्यादा मैसेज प्रोसेसर पर लोड नहीं हुए हैं
 प्लेबुक
यह गड़बड़ी तब भी हो सकती है, जब कई वर्चुअल होस्ट का एक ही होस्ट हो उपनाम और पोर्ट नंबर. प्लेबुक

messaging.adaptors.http.flow.DecompressionFailureAtRequest
  • एचटीटीपी स्टेटस कोड:
 400 Bad Request
  • गड़बड़ी का मैसेज:
 Decompression failure at request
  • संभावित वजह:

यह गड़बड़ी सिर्फ़ तब होती है, जब:

  • एचटीटीपी अनुरोध के हेडर में बताई गई एन्कोडिंग Content-Encoding मान्य है और Apigee Edge पर काम करता है,

    • लेकिन

  • एचटीटीपी के हिस्से के तौर पर क्लाइंट का भेजा गया पेलोड फ़ॉर्मैट अनुरोध, इसमें बताए गए एन्कोडिंग फ़ॉर्मैट से मेल नहीं खाता है Content-Encoding हेडर
प्लेबुक

messaging.adaptors.http.flow.DecompressionFailureAtResponse
  • एचटीटीपी स्टेटस कोड:
 502 Bad Gateway
  • गड़बड़ी का मैसेज:
 Decompression failure at response
  • संभावित वजह:

यह गड़बड़ी सिर्फ़ तब होती है, जब:

  • बैकएंड/टारगेट सर्वर में तय की गई एन्कोडिंग एचटीटीपी रिस्पॉन्स हेडर Content-Encoding मान्य है और यह Apigee Edge पर काम करता है,

    • लेकिन

  • पेलोड फ़ॉर्मैट को बैकएंड/टारगेट सर्वर से इस तौर पर भेजा जाता है: एचटीटीपी रिस्पॉन्स का कुछ हिस्सा Content-Encoding हेडर
प्लेबुक

messaging.adaptors.http.flow.ErrorResponseCode
  • एचटीटीपी स्टेटस कोड:
 500

प्लेबुक

वीडियो

  • गड़बड़ी का मैसेज:
 बैकएंड सर्वर के आधार पर, गड़बड़ी का मैसेज और फ़ॉर्मैट अलग-अलग हो सकते हैं लागू करना.
  • संभावित वजह:
 यह गड़बड़ी तब होती है, जब बैकएंड सर्वर स्टेटस के साथ जवाब देता है Apigee Edge के लिए 500 कोड.
  • एचटीटीपी स्टेटस कोड:
 503

प्लेबुक

वीडियो

  • गड़बड़ी का मैसेज:
 बैकएंड सर्वर के आधार पर, गड़बड़ी का मैसेज और फ़ॉर्मैट अलग-अलग हो सकते हैं लागू करना.
  • संभावित वजह:
 यह गड़बड़ी तब होती है, जब बैकएंड सर्वर स्टेटस के साथ जवाब देता है Apigee Edge के लिए 503 कोड.
  • एचटीटीपी स्टेटस कोड:
 504 प्लेबुक
  • गड़बड़ी का मैसेज:
 बैकएंड सर्वर के आधार पर, गड़बड़ी का मैसेज और फ़ॉर्मैट अलग-अलग हो सकते हैं लागू करना.
  • संभावित वजह:
 यह गड़बड़ी तब होती है, जब बैकएंड सर्वर स्टेटस के साथ जवाब देता है Apigee Edge के लिए 504 कोड.

ध्यान दें: गड़बड़ी का कोड messaging.adaptors.http.flow.ErrorResponseCode लौटाया नहीं गया है क्लाइंट ऐप्लिकेशन को भेजे गए गड़बड़ी के मैसेज के हिस्से के तौर पर. यह है क्योंकि यह गड़बड़ी कोड Apigee Edge से सेट होता है, जब बैकएंड सर्वर गड़बड़ी के साथ जवाब देता है. साथ ही, 4XX या 5XX में से किसी एक के साथ जवाब देता है स्थिति कोड. गड़बड़ी के इस कोड को एपीआई मॉनिटरिंग, NGINX ऐक्सेस लॉग में देखा जा सकता है, या आंकड़ों का डेटाबेस.

messaging.adaptors.http.flow.GatewayTimeout
  • एचटीटीपी स्टेटस कोड:
 504 Gateway Timeout
  • गड़बड़ी का मैसेज:
 Gateway Timeout
  • संभावित वजह:
 यह गड़बड़ी तब होती है, जब बैकएंड सर्वर जवाब नहीं देता मैसेज प्रोसेसर पर, Apigee Edge मैसेज प्रोसेसर पर, I/O टाइम आउट की अवधि कॉन्फ़िगर की गई.
प्लेबुक

messaging.adaptors.http.flow.LengthRequired
  • एचटीटीपी स्टेटस कोड:
 411 Length Required
  • गड़बड़ी का मैसेज:
 'Content-Length' is missing
  • संभावित वजह:

यह गड़बड़ी तब होती है, जब Content-Length हेडर पास नहीं होता है एचटीटीपी POST और PUT के हिस्से के तौर पर क्लाइंट ऐप्लिकेशन Apigee Edge को भेजे गए अनुरोध.

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

ठीक करें

इस गड़बड़ी को ठीक करने के लिए, नीचे दिया गया तरीका अपनाएं:

  1. पक्का करें कि क्लाइंट ऐप्लिकेशन हमेशा हेडर को पास करे एचटीटीपी POST के हिस्से के तौर पर और Content-Length Apigee Edge को PUT अनुरोध भेजे गए. उदाहरण के लिए:

    curl -X POST https://HOSTALIAS/PATH -d '{"name": "abc"}' -H "Content-Length: 15"

  2. भले ही आप POST के साथ एक खाली पेलोड पास कर रहे हों और PUT अनुरोध, पक्का करें कि हेडर Content-Length: 0 पास हो गया है. उदाहरण के लिए:

    curl -X POST https://HOSTALIAS/PATH -H "Content-Length: 0"

messaging.adaptors.http.flow.NoActiveTargets
  • एचटीटीपी स्टेटस कोड:
 503 Service Unavailable
  • गड़बड़ी का मैसेज:
 The Service is temporarily unavailable
  • संभावित वजह:

यह गड़बड़ी, नीचे दी गई स्थितियों में से किसी एक के तहत आती है, अगर आप इसका इस्तेमाल कर रहे हैं, Apigee Edge में TargetServer:

  1. बैकएंड सर्वर होस्ट का गलत डीएनएस रिज़ॉल्यूशन के कारण कस्टम प्राधिकरण सर्वर के कारण गलत IP पते मिले, जिससे कनेक्शन की गड़बड़ियां.
  2. कनेक्शन टाइम आउट होने में होने वाली गड़बड़ियां, इस वजह से होती हैं:
    1. बैकएंड सर्वर पर फ़ायरवॉल प्रतिबंध से रोकता है बैकएंड सर्वर से कनेक्ट करने से जुड़ा Apigee Edge.
    2. Apigee Edge के बीच नेटवर्क कनेक्टिविटी से जुड़ी समस्याएं और बैकएंड सर्वर पर भी काम करता है.
  3. TargetServer में दिया गया होस्ट गलत है या इसमें अनचाहे वर्ण (जैसे कि खाली जगह) हैं.

प्लेबुक

वीडियो
यह गड़बड़ी तब भी हो सकती है, जब सेहत पर नज़र रखने के लिए कॉन्फ़िगर की गई जांच तो उस लक्ष्य सर्वर की जांच नहीं की जा सकी.

प्लेबुक

वीडियो

messaging.adaptors.http.flow.RequestTimeOut
  • एचटीटीपी स्टेटस कोड:
 408 Request Timeout
  • गड़बड़ी का मैसेज:
 Request timed out
  • संभावित वजह:
 यह गड़बड़ी तब होती है, जब Apigee Edge मैसेज प्रोसेसर को के लिए क्लाइंट ऐप्लिकेशन से पेलोड का अनुरोध करें मैसेज प्रोसेसर कॉम्पोनेंट पर, I/O टाइम आउट की अवधि कॉन्फ़िगर की गई.

ठीक करें

पक्का करें कि क्लाइंट ऐप्लिकेशन, अनुरोध पेलोड को I/O टाइम आउट पीरियड को Apigee Edge के मैसेज प्रोसेसर कॉम्पोनेंट पर कॉन्फ़िगर किया गया है.

messaging.adaptors.http.flow.ServiceUnavailable
  • एचटीटीपी स्टेटस कोड:
 503 Service Unavailable
  • गड़बड़ी का मैसेज:
 The Service is temporarily unavailable
  • संभावित वजह:

यह गड़बड़ी, इनमें से किसी एक स्थिति में होती है:

  1. बैकएंड सर्वर का गलत डीएनएस रिज़ॉल्यूशन कस्टम प्राधिकरण सर्वर के होस्ट की वजह से खराब IP पते मिले करने के लिए किया जा सकता है.
  2. कनेक्शन टाइम आउट होने में होने वाली गड़बड़ियां, इस वजह से होती हैं:
    1. बैकएंड सर्वर पर फ़ायरवॉल प्रतिबंध से रोकता है बैकएंड सर्वर से कनेक्ट करने से जुड़ा Apigee Edge.
    2. Apigee Edge और के बीच नेटवर्क कनेक्टिविटी से जुड़ी समस्याएं बैकएंड सर्वर.
  3. टारगेट एंडपॉइंट में तय किया गया टारगेट सर्वर होस्ट गलत है या उसमें अनचाहे वर्ण हैं (जैसे कि स्पेस).

प्लेबुक

DNS विफलता:

वीडियो

नेटवर्क कनेक्टिविटी:

वीडियो
यह गड़बड़ी तब भी हो सकती है, जब बैकएंड सर्वर कनेक्शन, जब मैसेज प्रोसेसर अब भी बैकएंड सर्वर. प्लेबुक

messaging.adaptors.http.flow.SslHandshakeFailed
  • एचटीटीपी स्टेटस कोड:
 503 Service Unavailable
  • गड़बड़ी का मैसेज:
 SSL Handshake failed {error_message}
  • संभावित वजह:

यह गड़बड़ी, Apigee Edge के बीच एसएसएल हैंडशेक प्रोसेस के दौरान होती है मैसेज प्रोसेसर और बैकएंड सर्वर तब काम करेगा, जब:

  1. Apigee Edge के मैसेज प्रोसेसर का ट्रस्टस्टोर:
    • इसमें एक सर्टिफ़िकेट चेन है, जो बैकएंड सर्वर के सर्टिफ़िकेट की चेन पूरी करें

      • या

    • इसमें बैकएंड सर्वर की पूरी सर्टिफ़िकेट चेन शामिल नहीं है
  2. बैकएंड सर्वर के ज़रिए दिखाई जाने वाली सर्टिफ़िकेट चेन:
    • इसमें पूरी तरह क्वालिफ़ाइड डोमेन नेम (एफ़क्यूडीएन) है, जो टारगेट एंडपॉइंट में दिया गया होस्ट नाम

      • या

    • इसमें गलत/अधूरी सर्टिफ़िकेट चेन है

प्लेबुक

वीडियो

messaging.adaptors.http.flow.UnexpectedEOFAtTarget
  • एचटीटीपी स्टेटस कोड:
 502 Bad Gateway
  • गड़बड़ी का मैसेज:
 Unexpected EOF at target
  • संभावित वजह:

यह गड़बड़ी, इनमें से किसी एक स्थिति में होती है:

  1. TLS/एसएसएल कनेक्शन के साथ काम करने के लिए, TargetServer को सही तरीके से कॉन्फ़िगर नहीं किया गया है Apigee Edge में.
  2. बैकएंड सर्वर कनेक्शन को अचानक बंद कर सकता है, जबकि Apigee Edge, बैकएंड सर्वर से जवाब का इंतज़ार कर रहा है.
  3. Apigee पर, अलाइव टाइम आउट को गलत तरीके से कॉन्फ़िगर करके रखें और बैकएंड सर्वर.
प्लेबुक

messaging.runtime.*

messaging.runtime.RouteFailed
  • एचटीटीपी स्टेटस कोड:
 500 Internal Server Error
  • गड़बड़ी का मैसेज:
 Unable to route the message to a TargetEndpoint
  • संभावित वजह:

यह गड़बड़ी तब होती है, जब Apigee Edge, अनुरोध को इनमें से किसी एक पर रूट नहीं कर पाता है TargetEndpoint की वजह से:

  • रास्ते के नियम (<RouteRule>) की कोई शर्त नहीं है प्रॉक्सी में अनुरोध से मेल खाता है

    • और

  • ProxyEndpoint में, रूट का कोई डिफ़ॉल्ट नियम तय नहीं किया गया है (उदाहरण के लिए, <RouteRule> बिना किसी शर्त के)

ठीक करें

इस गड़बड़ी को ठीक करने के लिए, इन निर्देशों का पालन करें:

  1. अपने ProxyEndpoint में बताए गए रूट नियमों की समीक्षा करें और यह पक्का करने के लिए बदलाव करें कि रास्ते के नियम की कम से कम एक शर्त आपके अनुरोध से मेल खाती है.
  2. बिना किसी शर्त के डिफ़ॉल्ट रूट नियम तय करना एक अच्छा तरीका है जब आपके पास कई मार्ग नियम हों.
  3. सुनिश्चित करें कि डिफ़ॉल्ट मार्ग नियम को हमेशा कंडिशनल रूट, क्योंकि प्रॉक्सीएंडपॉइंट में नियमों का आकलन टॉप-डाउन में किया जाता है.

किसी पेज पर <RouteRule> शर्तें तय करने के बारे में ज़्यादा जानने के लिए ProxyEndpoint, देखें शर्तें पूरी करने वाले टारगेट.

messaging.runtime.SenseRaiseFault
  • एचटीटीपी स्टेटस कोड:
 403 Forbidden
  • गड़बड़ी का मैसेज:
 Sense Fault
  • संभावित वजह:
 यह गड़बड़ी तब होती है, जब किसी क्लाइंट आईपी पते से एपीआई अनुरोध किया जाता है जिसे Apigee Sense के नियमों के तहत ब्लॉक किया गया है.

ठीक करें

इस गड़बड़ी को ठीक करने के लिए, इन निर्देशों का पालन करें:

  1. पुष्टि करें कि आपने खास क्लाइंट के आईपी पते को ब्लॉक कर दिया है Apigee Sense में कॉन्फ़िगर किए गए नियमों की जांच करना. अगर इस पर रोक लगाई गई है, तो इसका मतलब है कि यह डिज़ाइन के मुताबिक काम कर रहा है.
  2. अगर किसी क्लाइंट का आईपी पता ब्लॉक नहीं किया गया है, लेकिन आप अब भी ऐसा कर रहे हैं अगर आपको यह गड़बड़ी दिखती है, तो Apigee Edge की सहायता टीम से संपर्क करें.

protocol.http.* - Caused due to bad request

protocol.http.BadFormData
  • एचटीटीपी स्टेटस कोड:
 500 Internal Server Error
  • गड़बड़ी का मैसेज:
 Bad Form Data
  • संभावित वजह:

यह गड़बड़ी तब होती है, जब ये सभी शर्तें पूरी होती हैं:

  1. क्लाइंट ने Apigee Edge को एचटीटीपी अनुरोध भेजा है इसमें शामिल है:
    • Content-Type: application/x-www-form-urlencoded, और
    • प्रतिशत के निशान (%) या प्रतिशत के साथ फ़ॉर्म डेटा चिह्न (%) के बाद अमान्य हेक्साडेसिमल वर्ण हैं, जिनकी अनुमति नहीं है इसके अनुसार फ़ॉर्म - सेक्शन 17.13.4.1.
  2. Apigee Edge में मौजूद एपीआई प्रॉक्सी, तय किए गए फ़ॉर्म को पढ़ती है ऐसे पैरामीटर जिनमें ऐसे वर्ण मौजूद हैं जिन्हें अनुरोध के फ़्लो में ExtractVariables याassignMessage नीति.
प्लेबुक

protocol.http.DuplicateHeader
  • एचटीटीपी स्टेटस कोड:
 400 Bad Request
  • गड़बड़ी का मैसेज:
 Duplicate Header "{header_name}"
  • संभावित वजह:
 यह गड़बड़ी तब होती है, जब कोई ऐसा एचटीटीपी हेडर हो जिसमें डुप्लीकेट हेडर की अनुमति नहीं होती है Apigee Edge में, यह एक ही या अलग-अलग वैल्यू के साथ एक से ज़्यादा बार दिखता है क्लाइंट ऐप्लिकेशन से, Apigee Edge को भेजा गया एचटीटीपी अनुरोध.
  • एचटीटीपी की जानकारी:
 आरएफ़सी 7230, सेक्शन 3.2.2: फ़ील्ड ऑर्डर
प्लेबुक

protocol.http.EmptyHeaderName
  • एचटीटीपी स्टेटस कोड:
 400 Bad Request
  • गड़बड़ी का मैसेज:
 Header name cannot be empty
  • संभावित वजह:
 यह गड़बड़ी तब होती है, जब हेडर का नाम एचटीटीपी के हिस्से के तौर पर भेजा जाता है क्लाइंट ऐप्लिकेशन ने Apigee Edge को जो अनुरोध भेजा है वह खाली है.
  • एचटीटीपी की जानकारी:
 आरएफ़सी 7230, सेक्शन 3.2: हेडर फ़ील्ड

ठीक करें

पक्का करें कि क्लाइंट ऐप्लिकेशन से भेजा गया एचटीटीपी अनुरोध से Apigee Edge में, हेडर का नाम हमेशा उसके हिसाब से मान्य होता है आरएफ़सी 7230, सेक्शन 3.2: हेडर फ़ील्ड.

protocol.http.HeaderNameWithNonAsciiChar
  • एचटीटीपी स्टेटस कोड:
 400 Bad Request
  • गड़बड़ी का मैसेज:
 Header {header_name} contains non ascii character {character}
  • संभावित वजह:
 गड़बड़ी का यह मैसेज तब दिखता है, जब हेडर का नाम एचटीटीपी अनुरोध के हिस्से के तौर पर भेजा गया हो क्लाइंट ऐप्लिकेशन से, Apigee Edge में बिना ASCII वाले वर्ण शामिल होते हैं.
  • एचटीटीपी की जानकारी:

आरएफ़सी 7230, सेक्शन 3.2: हेडर फ़ील्ड और आरएफ़सी 7230, सेक्शन 3.2.6: फ़ील्ड वैल्यू वाले कॉम्पोनेंट

ठीक करें

पक्का करें कि क्लाइंट का एचटीटीपी अनुरोध Apigee Edge के हेडर के नामों में, उसके हिसाब से बिना ASCII वाले वर्ण शामिल नहीं होते हैं आरएफ़सी 7230, सेक्शन 3.2.6: फ़ील्ड वैल्यू वाले कॉम्पोनेंट.

protocol.http.HeaderWithInvalidChar
  • एचटीटीपी स्टेटस कोड:
 400 Bad Request
  • गड़बड़ी का मैसेज:
 Header {header_name} contains invalid character {character}
  • संभावित वजह:
 गड़बड़ी का यह मैसेज तब दिखता है, जब हेडर का नाम एचटीटीपी अनुरोध के हिस्से के तौर पर भेजा गया हो क्लाइंट ऐप्लिकेशन के ज़रिए Apigee Edge में अमान्य वर्ण होते हैं, जैसे कि बराबर (=), कॉमा (,), सेमीकोलन (;), टैब, CRLF, और Newline वर्ण.
  • एचटीटीपी की जानकारी:

आरएफ़सी 7230, सेक्शन 3.2: हेडर फ़ील्ड और आरएफ़सी 7230, सेक्शन 3.2.6: फ़ील्ड वैल्यू वाले कॉम्पोनेंट

ठीक करें

पक्का करें कि क्लाइंट ऐप्लिकेशन से Apigee Edge को भेजा गया एचटीटीपी अनुरोध न हो हेडर नामों में अमान्य वर्ण मौजूद होना चाहिए आरएफ़सी 7230, सेक्शन 3.2.6: फ़ील्ड वैल्यू वाले कॉम्पोनेंट

protocol.http.InvalidPath
  • एचटीटीपी स्टेटस कोड:
 400 Bad Request
  • गड़बड़ी का मैसेज:
 Invalid path {path}
  • संभावित वजह:
 यह गड़बड़ी तब होती है, जब क्लाइंट ऐप्लिकेशन से भेजे गए एचटीटीपी अनुरोध के यूआरएल में मौजूद पाथ से Apigee Edge में ऐसे वर्ण हैं जिनकी अनुमति नहीं है आरएफ़सी 3986, सेक्शन 3.3: पाथ.
  • एचटीटीपी की जानकारी:

आरएफ़सी 3986, सेक्शन 3: सिंटैक्स कॉम्पोनेंट और आरएफ़सी 3986, सेक्शन 3.3: पाथ

ठीक करें

पक्का करें कि एचटीटीपी अनुरोध के यूआरएल में मौजूद पाथ, क्लाइंट ने भेजा हो के लिए आवेदन Apigee Edge में ऐसा कोई वर्ण नहीं है जिसकी अनुमति नहीं है आरएफ़सी 3986, सेक्शन 3.3: पाथ के मुताबिक.

protocol.http.TooBigBody
  • एचटीटीपी स्टेटस कोड:
 413 Request Entity Too Large
  • गड़बड़ी का मैसेज:
 Body buffer overflow
  • संभावित वजह:
 यह गड़बड़ी तब होती है, जब पेलोड साइज़ को क्लाइंट ऐप्लिकेशन के हिस्से के तौर पर भेजा जाता है Apigee Edge के लिए एचटीटीपी अनुरोध, Apigee Edge में तय सीमा से ज़्यादा है.
  • सीमाएं:
 Apigee एज की सीमाएं
प्लेबुक

protocol.http.TooBigHeaders
  • एचटीटीपी स्टेटस कोड:
 431 Request Header Fields Too Large
  • गड़बड़ी का मैसेज:
 request headers size exceeding {limit}
  • संभावित वजह:
 क्लाइंट के भेजे गए अनुरोध के सभी हेडर का कुल साइज़ ऐप्लिकेशन, Apigee Edge के लिए एचटीटीपी अनुरोध के तहत तय सीमा से ज़्यादा है Apigee Edge में सीमा तय कर सकते हैं.
  • एचटीटीपी की जानकारी:
 आरएफ़सी 6585, सेक्शन 5: 431 अनुरोध के हेडर के फ़ील्ड बहुत बड़े हैं
  • सीमाएं:
 Apigee Edge की सीमाएं
प्लेबुक

protocol.http.TooBigLine
  • एचटीटीपी स्टेटस कोड:
 414 Request-URI Too Long
  • गड़बड़ी का मैसेज:
 request line size exceeding {limit}
  • संभावित वजह:
 यह गड़बड़ी तब होती है, जब क्लाइंट ऐप्लिकेशन से भेजी गई अनुरोध लाइन का साइज़ ऐसा इसलिए है, क्योंकि Apigee Edge के लिए एचटीटीपी अनुरोध का हिस्सा, यहां दी गई सीमा से ज़्यादा है Apigee Edge.
  • सीमाएं:
 Apigee एज की सीमाएं
प्लेबुक

protocol.http.UnsupportedEncoding
  • एचटीटीपी स्टेटस कोड:
 415 Unsupported Media
  • गड़बड़ी का मैसेज:
 Unsupported Encoding "{encoding}"
  • संभावित वजह:
 यह गड़बड़ी तब होती है, जब क्लाइंट से मिला Content-Encoding हेडर एचटीटीपी रिस्पॉन्स के हिस्से के तौर पर ऐसा एन्कोडिंग/पेलोड फ़ॉर्मैट होता है जो यह Apigee Edge के साथ काम करता है.
  • एचटीटीपी की जानकारी:
 आरएफ़सी 7231, सेक्शन 6.5.13: 415 काम न करने वाला मीडिया टाइप
प्लेबुक

protocol.http.* - Caused by target

protocol.http.BadPath
  • एचटीटीपी स्टेटस कोड:
 500 Internal Server Error
  • गड़बड़ी का मैसेज:
 Invalid request path
  • संभावित वजह:
 यह गड़बड़ी तब होती है, जब बैकएंड सर्वर का अनुरोध यूआरएल, फ़्लो वैरिएबल target.url, इसमें सवाल के निशान से शुरू होने वाला पाथ होता है फ़ॉरवर्ड स्लैश (/) के बजाय, (?) जोड़ दें. यह अमान्य है.
  • एचटीटीपी की जानकारी:

आरएफ़सी 3986, सेक्शन 3: सिंटैक्स कॉम्पोनेंट और आरएफ़सी 3986, सेक्शन 3.3: पाथ
प्लेबुक

protocol.http.DuplicateHeader
  • एचटीटीपी स्टेटस कोड:
 502 Bad Gateway
  • गड़बड़ी का मैसेज:
 Duplicate Header "{header_name}"
  • संभावित वजह:
 यह गड़बड़ी तब होती है, जब कोई खास एचटीटीपी हेडर, जिसमें डुप्लीकेट शामिल करने की अनुमति नहीं है Apigee Edge में, यह एक जैसे या अलग-अलग वैल्यू के साथ एक से ज़्यादा बार दिखता है बैकएंड सर्वर से Apigee Edge को भेजा गया एचटीटीपी रिस्पॉन्स.
  • एचटीटीपी की जानकारी:
 आरएफ़सी 7230, सेक्शन 3.2.2: फ़ील्ड ऑर्डर
प्लेबुक

protocol.http.EmptyHeaderName
  • एचटीटीपी स्टेटस कोड:
 502 Bad Gateway
  • गड़बड़ी का मैसेज:
 Header name cannot be empty
  • संभावित वजह:
 यह गड़बड़ी तब होती है, जब हेडर का नाम, एचटीटीपी के हिस्से के तौर पर बैकएंड सर्वर से भेजा जाता है Apigee Edge में कोई जवाब नहीं दिया गया है.
  • एचटीटीपी की जानकारी:
 आरएफ़सी 7230, सेक्शन 3.2: हेडर फ़ील्ड

ठीक करें

पक्का करें कि बैकएंड ने एचटीटीपी रिस्पॉन्स भेजा हो सर्वर से Apigee Edge में, हमेशा सही हेडर नाम होता है आरएफ़सी 7230, सेक्शन 3.2: हेडर फ़ील्ड.

protocol.http.EmptyPath
  • एचटीटीपी स्टेटस कोड:
 500 Internal Server Error
  • गड़बड़ी का मैसेज:
 Request path cannot be empty
  • संभावित वजह:
 यह गड़बड़ी तब होती है, जब बैकएंड सर्वर का एचटीटीपी अनुरोध यूआरएल, फ़्लो वैरिएबल target.url में, एक खाली पाथ होता है.
  • एचटीटीपी की जानकारी:

आरएफ़सी 3986, सेक्शन 3: सिंटैक्स कॉम्पोनेंट और आरएफ़सी 3986, सेक्शन 3.3: पाथ
प्लेबुक

protocol.http.HeaderNameWithNonAsciiChar
  • एचटीटीपी स्टेटस कोड:
 502 Bad Gateway
  • गड़बड़ी का मैसेज:
 Header {header_name} contains non ascii character {character}
  • संभावित वजह:
 यह गड़बड़ी तब होती है, जब हेडर का नाम बैकएंड सर्वर के ज़रिए भेजा जाता है Apigee के लिए एचटीटीपी रिस्पॉन्स Edge में बिना ASCII वाले वर्ण हैं.
  • एचटीटीपी की जानकारी:

आरएफ़सी 7230, सेक्शन 3.2: हेडर फ़ील्ड और आरएफ़सी 7230, सेक्शन 3.2.6: फ़ील्ड वैल्यू वाले कॉम्पोनेंट

ठीक करें

पक्का करें कि बैकएंड सर्वर का एचटीटीपी रिस्पॉन्स इस यूआरएल पर भेजा गया हो Apigee Edge के हेडर के नामों में, उसके हिसाब से बिना ASCII वाले वर्ण शामिल नहीं होते हैं आरएफ़सी 7230, सेक्शन 3.2.6: फ़ील्ड वैल्यू वाले कॉम्पोनेंट.

protocol.http.HeaderWithInvalidChar
  • एचटीटीपी स्टेटस कोड:
 502 Bad Gateway
  • गड़बड़ी का मैसेज:
 Header {header_name} contains invalid character {character}
  • संभावित वजह:
 यह गड़बड़ी तब होती है, जब बैकएंड सर्वर, एचटीटीपी रिस्पॉन्स के हिस्से के तौर पर हेडर का नाम भेजता है, इसमें अमान्य वर्ण शामिल हैं, जैसे कि बराबर (=), कॉमा (,), सेमीकोलन (;), टैब, CRLF, और Newline किरदार.
  • एचटीटीपी की जानकारी:

आरएफ़सी 7230, सेक्शन 3.2: हेडर फ़ील्ड और आरएफ़सी 7230, सेक्शन 3.2.6: फ़ील्ड वैल्यू वाले कॉम्पोनेंट

ठीक करें

पक्का करें कि Apigee Edge को भेजे गए बैकएंड सर्वर के एचटीटीपी रिस्पॉन्स में कोई वैल्यू न हो हेडर नामों में अमान्य वर्ण हैं आरएफ़सी 7230, सेक्शन 3.2.6: फ़ील्ड वैल्यू वाले कॉम्पोनेंट

protocol.http.ProxyTunnelCreationFailed
  • एचटीटीपी स्टेटस कोड:
 503 Service Unavailable
  • गड़बड़ी का मैसेज:
 Proxy refused to create tunnel with response status {status code}
  • संभावित वजह:

यह गड़बड़ी, Apigee Edge और फ़ायरवॉल की वजह से प्रॉक्सी सर्वर का बैकएंड सर्वर, एसीएल (ऐक्सेस कंट्रोल लिस्ट), डीएनएस समस्याएं, बैकएंड सर्वर की उपलब्धता की उपलब्धता वगैरह

ध्यान दें: गड़बड़ी के मैसेज में मौजूद स्टेटस कोड (faultstring) समस्या की मुख्य वजह बताता है.
प्लेबुक

protocol.http.Response306Reserved
  • एचटीटीपी स्टेटस कोड:
 502 Bad Gateway
  • गड़बड़ी का मैसेज:
 Response Status code 306 is reserved, so can't be used.
  • संभावित वजह:

यह गड़बड़ी तब होती है, जब बैकएंड सर्वर Apigee Edge के लिए 306 स्टेटस कोड.

306 स्टेटस कोड को इसके पिछले वर्शन में तय किया गया था एचटीटीपी की जानकारी. मौजूदा एचटीटीपी स्पेसिफ़िकेशन के मुताबिक, यह कोड रिज़र्व किया गया है और इसका इस्तेमाल नहीं किया जाना चाहिए.
  • एचटीटीपी की जानकारी:
 आरएफ़सी 7231, सेक्शन 6.3.5: 306 रिज़र्व

ठीक करें

स्थिति कोड 306 रिज़र्व है, इसलिए पक्का करें कि आपका बैकएंड सर्वर Apigee Edge का जवाब.

protocol.http.Response405WithoutAllowHeader
  • एचटीटीपी स्टेटस कोड:
 502 Bad Gateway
  • गड़बड़ी का मैसेज:
 Received 405 Response without Allow Header
  • संभावित वजह:
 बैकएंड सर्वर इसके साथ जवाब देता है: 405 Method Not Allowed स्टेटस कोड, जिसमें "अनुमति दें" हेडर नहीं है.
  • एचटीटीपी की जानकारी:

आरएफ़सी 7231, सेक्शन 6.5.5: 405 मेथड की अनुमति नहीं है और आरएफ़सी 7231, सेक्शन 7.4.1: अनुमति दें
प्लेबुक

protocol.http.ResponseWithBody
  • एचटीटीपी स्टेटस कोड:
 502 Bad Gateway
  • गड़बड़ी का मैसेज:
 Received {status_code} Response with message body
  • संभावित वजह:

गड़बड़ी का यह मैसेज तब दिखता है, जब बैकएंड सर्वर से Apigee Edge पर एचटीटीपी रिस्पॉन्स मिलता है 204 No Content या 205 Reset Content है, लेकिन इसमें रिस्पॉन्स का मुख्य हिस्सा और/या इनमें से एक या एक से ज़्यादा हेडर:

  • Content-Length
  • Content-Encoding
  • Transfer-Encoding
  • एचटीटीपी की जानकारी:

आरएफ़सी 7231, सेक्शन 6.3.5: 204 कोई कॉन्टेंट नहीं और आरएफ़सी 7231, सेक्शन 6.3.6: 205 कॉन्टेंट रीसेट करना
प्लेबुक

protocol.http.TooBigBody
  • एचटीटीपी स्टेटस कोड:
 502 Bad Gateway
  • गड़बड़ी का मैसेज:
 Body buffer overflow
  • संभावित वजह:
 यह गड़बड़ी तब होती है, जब पेलोड साइज़ को क्लाइंट ऐप्लिकेशन के हिस्से के तौर पर भेजा जाता है Apigee Edge के लिए एचटीटीपी अनुरोध, Apigee Edge में तय सीमा से ज़्यादा है.
  • सीमाएं:
 Apigee एज की सीमाएं
प्लेबुक

protocol.http.TooBigHeaders
  • एचटीटीपी स्टेटस कोड:
 502 Bad Gateway
  • गड़बड़ी का मैसेज:
 response headers size exceeding {limit}
  • संभावित वजह:
 यह गड़बड़ी तब होती है, जब Apigee Edge के लिए एचटीटीपी रिस्पॉन्स के हिस्से के तौर पर बैकएंड सर्वर, Apigee Edge में, तय सीमा के बराबर होने की अनुमति है.
  • सीमाएं:
 Apigee Edge की सीमाएं
प्लेबुक

protocol.http.TooBigLine
  • एचटीटीपी स्टेटस कोड:
 502 Bad Gateway
  • गड़बड़ी का मैसेज:
 response line size exceeding {limit}
  • संभावित वजह:
 यह गड़बड़ी तब होती है, जब बैकएंड सर्वर से मिलने वाली रिस्पॉन्स लाइन का साइज़, Apigee Edge के लिए एचटीटीपी रिस्पॉन्स का कुछ हिस्सा, Apigee में तय सीमा से ज़्यादा है किनारे.
  • सीमाएं:
 Apigee एज की सीमाएं
प्लेबुक

protocol.http.UnsupportedEncoding
  • एचटीटीपी स्टेटस कोड:
 415 Unsupported Media
  • गड़बड़ी का मैसेज:
 Unsupported Encoding "{encoding}"
  • संभावित वजह:
 यह गड़बड़ी तब होती है, जब Content-Encoding एचटीटीपी रिस्पॉन्स के हिस्से के तौर पर, बैकएंड सर्वर में एन्कोडिंग/पेलोड शामिल होता है फ़ॉर्मैट जो ऐसा नहीं है यह Apigee Edge के साथ काम करता है.
  • एचटीटीपी की जानकारी:
 आरएफ़सी 7231, सेक्शन 6.5.13: 415 काम न करने वाला मीडिया टाइप
प्लेबुक

security.util.*

security.util.KeyAliasNotFound
  • एचटीटीपी स्टेटस कोड:
 500 Internal Server Error
  • गड़बड़ी का मैसेज:
 KeyAlias {KeyAlias_name} is not found in Keystore {Keystore_Name}
  • संभावित वजह:

यह गड़बड़ी तब होती है, जब TargetEndpoint में खास KeyAlias का संदर्भ दिया गया हो या टारगेट सर्वर, किसी खास कीस्टोर में नहीं मिला.

ठीक करें

पक्का करें कि TargetEndpoint या TargetServer में तय किया गया KeyAlias उनका इस्तेमाल किया गया है मौजूद है और विशिष्ट कीस्टोर का हिस्सा है.

security.util.TrustStoreWithNoCertificates
  • एचटीटीपी स्टेटस कोड:
 500 Internal Server Error
  • गड़बड़ी का मैसेज:
 TrustStore {truststore_name} has no certificates
  • संभावित वजह:

यह गड़बड़ी तब होती है, जब TargetEndpoint में खास Truststore का रेफ़रंस दिया गया हो या TargetServer के पास कोई सर्टिफ़िकेट नहीं है.

ठीक करें

अगर आपको बैकएंड सर्वर के सर्टिफ़िकेट की पुष्टि करनी है और टारगेट-एंडपॉइंट या TargetServer में Truststore का इस्तेमाल करना चाहते हैं, तो पक्का करें कि Truststore में बैकएंड सर्वर के मान्य सर्टिफ़िकेट हैं.