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

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

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

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

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

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

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

      • या

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

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

मैसेज प्रोसेसर हमेशा एचटीटीपी स्टेटस कोड दिखाता है. इसके बाद, गड़बड़ी का मैसेज और 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 Message Processor कॉम्पोनेंट से दिखाए जाते हैं. इसमें गड़बड़ी के हर कोड के लिए, यह जानकारी शामिल होती है:

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

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

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

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

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. किसी खास वर्चुअल होस्ट पर अनुरोध स्वीकार करने के लिए कॉन्फ़िगर नहीं किया गया है
    2. अनुरोध में इस्तेमाल किए गए खास पाथ पर अनुरोध स्वीकार करने के लिए कॉन्फ़िगर नहीं किया गया है
    3. उस खास एनवायरमेंट में डिप्लॉय नहीं किया गया है जिसमें एपीआई अनुरोध किए जा रहे हैं
    4. एक या उससे ज़्यादा मैसेज प्रोसेसर पर डिप्लॉय नहीं किया गया है
  2. एपीआई अनुरोध करने के लिए इस्तेमाल किया जा रहा खास एनवायरमेंट, एक या उससे ज़्यादा मैसेज प्रोसेसर पर लोड नहीं हुआ है
 PLAYBOOK
यह गड़बड़ी तब भी हो सकती है, जब एक से ज़्यादा वर्चुअल होस्ट का एक ही होस्ट के नाम और पोर्ट नंबर हो. प्लेबुक

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

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

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

    • BUT

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

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

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

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

    • BUT

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

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

PLAYBOOK

वीडियो

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

प्लेबुक

वीडियो

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

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

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

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

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

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

ठीक करें

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

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

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

PLAYBOOK

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

प्लेबुक

वीडियो

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

ठीक करें

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

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

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

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

PLAYBOOK

डीएनएस लुकअप प्रोसेस में गड़बड़ी हुई:

वीडियो

इंटरनेट कनेक्शन:

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

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. Apigee Edge में TLS/SSL कनेक्शन के साथ काम करने के लिए, TargetServer को ठीक से कॉन्फ़िगर नहीं किया गया है.
  2. जब Apigee Edge, बैकएंड सर्वर से जवाब का इंतज़ार कर रहा हो, तब बैकएंड सर्वर अचानक कनेक्शन बंद कर सकता है.
  3. Apigee और बैकएंड सर्वर पर, 'कंटेंट अप-टू-डेट रखने के लिए टाइम आउट' गलत तरीके से कॉन्फ़िगर किया गया है.
प्लेबुक

messaging.runtime.*

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

यह गड़बड़ी तब होती है, जब Apigee Edge, अनुरोध को किसी भी TargetEndpoints पर रूट नहीं कर पाता, क्योंकि:

  • कोई ऐसा रूट नियम (<RouteRule>) शर्त नहीं है जो प्रोक्सी में अनुरोध से मैच करता हो

    • और

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

ठीक करें

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

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

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

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: फ़ील्ड का क्रम
PLAYBOOK

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 को भेजे गए क्लाइंट के एचटीटीपी अनुरोध में, हेडर के नामों में ऐसे वर्ण न हों जो आरएफ़सी 7230, सेक्शन 3.2.6: फ़ील्ड वैल्यू कॉम्पोनेंट के मुताबिक, एएससीआईआई से अलग हों.

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

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

ठीक करें

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

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

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

ठीक करें

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

protocol.http.MessageReadError
  • एचटीटीपी स्टेटस कोड:
 502 Bad Gateway
  • गड़बड़ी का मैसेज:
 Unexpected I/O after message headers have been read.
  • संभावित वजह:
 यह गड़बड़ी बहुत कम होती है. यह तब होती है, जब एमपी को किसी चैनल पर I/O तब मिलता है, जब उसे इसकी उम्मीद नहीं होती. एमपी, अनुरोध पढ़ रहा है. उसने सभी हेडर पढ़ लिए हैं और अनुरोध का पेलोड पढ़ने के लिए तैयार है. इसके बाद, उसे एक ऐसा I/O इवेंट मिलता है जो एक ही हेडर के लिए है.

ठीक करें

क्या हो रहा है, इस बारे में ज़्यादा जानकारी के लिए लॉग मैसेज ढूंढें. 

logger.atSevere().log(
    "Unexpected I/O after message headers have been read. Channel diagnostics=%s."
        + " HeartBeat=%s",
    input.client().getDiagnostic(), message.getHeaders().isHeartBeat());

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

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 Edge की सीमाएं
प्लेबुक

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 को भेजे गए बैकएंड सर्वर के एचटीटीपी रिस्पॉन्स में, हेडर के नामों में ऐसे वर्ण न हों जो आरएफ़सी 7230, सेक्शन 3.2.6: फ़ील्ड वैल्यू कॉम्पोनेंट के मुताबिक, एएससीआईआई वर्ण न हों.

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

आरएफ़सी 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
  • संभावित वजह:
 बैकएंड सर्वर, "Allow" हेडर के बिना 405 Method Not Allowed स्टेटस कोड के साथ जवाब देता है.
  • एचटीटीपी स्पेसिफ़िकेशन:

आरएफ़सी 7231, सेक्शन 6.5.5: 405 Method Not Allowed और आरएफ़सी 7231, सेक्शन 7.4.1: Allow
प्लेबुक

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 Edge की सीमाएं
प्लेबुक

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 Edge में तय की गई सीमा से ज़्यादा हो.
  • सीमाएं:
 Apigee Edge की सीमाएं
प्लेबुक

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 या TargetServer में रेफ़रंस किया गया कोई खास KeyAlias, किसी खास पासकोड स्टोर में नहीं मिलता.

ठीक करें

पक्का करें कि TargetEndpoint या TargetServer में बताई गई KeyAlias मौजूद हो और वह किसी खास कीस्टोर का हिस्सा हो.

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

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

ठीक करें

अगर आपको बैकएंड सर्वर के सर्टिफ़िकेट की पुष्टि करनी है और आपको TargetEndpoint या TargetServer में ट्रस्टस्टोर का इस्तेमाल करना है, तो पक्का करें कि ट्रस्टस्टोर में बैकएंड सर्वर के मान्य सर्टिफ़िकेट मौजूद हों.