Google Cloud Apigee से जुड़े सहायता मामलों के लिए सबसे सही तरीके

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

आपको Apigee X दस्तावेज़ दिख रहा है.
Apigee Edge का दस्तावेज़ देखें.

सहायता अनुरोध में, पूरी और ज़रूरी जानकारी देने से, Google Cloud Apigee की सहायता टीम के लिए, आपको जल्दी और बेहतर तरीके से जवाब देना आसान हो जाता है. अगर आपके सहायता मामले में अहम जानकारी मौजूद न हो, तो हमें ज़्यादा जानकारी मांगने की ज़रूरत होती है. इसमें कई बार बार-बार अनुरोध करना शामिल हो सकता है. इसमें ज़्यादा समय लगता है और इससे समस्याओं के समाधान में देरी हो सकती है. सबसे सही तरीके बताने वाली गाइड से, आपको उस जानकारी के बारे में पता चलता है जिसकी ज़रूरत हमें आपके तकनीकी सहायता मामले को जल्दी हल करने के लिए चाहिए.

समस्या के बारे में जानकारी देना

किसी समस्या में ऐसी जानकारी होनी चाहिए जिसमें यह बताया जाए कि क्या हुआ और क्या होने की उम्मीद थी. साथ ही, उसमें यह भी बताया जाना चाहिए कि समस्या कब और कैसे हुई. एक अच्छे Apigee सहायता मामले में, हर Apigee प्रॉडक्ट के लिए, यहां दी गई अहम जानकारी शामिल होनी चाहिए:

अहम जानकारी ब्यौरा Public Cloud के लिए Apigee Edge Private Cloud के लिए Apigee Edge
प्रॉडक्ट खास Apigee प्रॉडक्ट, जिसमें समस्या का पता चला है. इसमें, वर्शन की जानकारी (जहां लागू हो) भी शामिल है.
  • वर्शन
समस्या की जानकारी समस्या के बारे में साफ़-साफ़ और पूरी जानकारी दें. अगर गड़बड़ी का कोई मैसेज हो, तो उसके बारे में पूरी जानकारी दें.
  • गड़बड़ी का मैसेज
  • ट्रेस टूल आउटपुट
  • सिलसिलेवार तरीके से हमें अपनी समस्या के बारे में बताएं
  • एपीआई अनुरोध/कमांड पूरा करें
  • गड़बड़ी का मैसेज
  • ट्रेस टूल आउटपुट
  • सिलसिलेवार तरीके से हमें अपनी समस्या के बारे में बताएं
  • एपीआई अनुरोध/कमांड पूरा करें
  • कॉम्पोनेंट डाइग्नोस्टिक्स लॉग
समय वह खास टाइमस्टैंप जब समस्या शुरू हुई और वह कितनी देर तक चली.
  • समस्या होने की तारीख, समय, और टाइमज़ोन
  • समस्या की अवधि
  • समस्या होने की तारीख, समय, और टाइमज़ोन
  • समस्या की अवधि
सेटअप उस जगह के बारे में ज़्यादा जानकारी जहां समस्या दिख रही है.
  • संगठन का नाम
  • एनवायरनमेंट का नाम
  • एपीआई प्रॉक्सी का नाम
  • पुनरीक्षण
  • नेटवर्क टोपोलॉजी
  • काम नहीं करने वाला Edge कॉम्पोनेंट

इन सेक्शन में, इन सिद्धांतों के बारे में ज़्यादा जानकारी दी गई है.

प्रॉडक्ट

Apigee के प्रॉडक्ट, Public Cloud पर Apigee Edge और प्राइवेट क्लाउड पर APIgee Edge अलग-अलग होते हैं. इसलिए, हमें इस बारे में खास जानकारी चाहिए कि किस प्रॉडक्ट में समस्या है.

नीचे दिए गए टेबल में, ऐसा करें कॉलम में पूरी जानकारी और क्या करें कॉलम में अधूरी जानकारी के कुछ उदाहरण दिए गए हैं:

ऐसा करें क्या न करें
हमारे Public Cloud संगठन पर एपीआई प्रॉक्सी OAuth2 को डिप्लॉय नहीं किया जा सका ...

एपीआई प्रॉक्सी को डिप्लॉय नहीं किया जा सका

(हमें उस Apigee प्रॉडक्ट की जानकारी चाहिए जिसमें आपको समस्या दिख रही है.)

हमारे Edge Private Cloud वर्शन 4.50.00 पर, इस गड़बड़ी की वजह से इंस्टॉल नहीं किया जा सका ...

हमारे Private Cloud के सेटअप पर, ऐप्लिकेशन इंस्टॉल नहीं हो सका.

(वर्शन जानकारी मौजूद नहीं है)

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

आपको जिस समस्या का सामना करना पड़ रहा है उसके बारे में सटीक जानकारी दें. इसमें गड़बड़ी का मैसेज (अगर कोई हो) के साथ-साथ, असल में हुई और असल में की गई गतिविधियों की जानकारी दें.

नीचे दिए गए टेबल में कुछ ऐसे उदाहरण दिए गए हैं जिनमें करें कॉलम में पूरी जानकारी और क्या न करें कॉलम में अधूरी जानकारी दिखाई गई है:

ऐसा करें क्या न करें

नई edgemicro प्रॉक्सी edgemicro_auth इस गड़बड़ी के साथ काम नहीं कर रही है:

{"error":"missing_authorization","error_description":"Missing Authorization header"}

आज बनाई गई नई edgemicro प्रॉक्सी काम नहीं कर रही है

(प्रॉक्सी नाम की जानकारी नहीं है. यह साफ़ तौर पर नहीं बताया गया है कि प्रॉक्सी की वजह से कोई गड़बड़ी हो रही है या कोई अनचाहा जवाब मिल रहा है.)

एपीआई प्रॉक्सी के लिए अनुरोध करते समय, हमारे क्लाइंट को नीचे दिए गए गड़बड़ी के मैसेज के साथ 500 गड़बड़ियां मिल रही हैं:

{"fault":{"faultstring":"Execution of JSReadResponse failed with error: Javascript runtime error: \"TypeError: Cannot read property \"content\" from undefined. (JSReadResponse.js:23)","detail":{"errorcode":"steps.javascript.ScriptExecutionFailed"}}}

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

(सिर्फ़ 500 गड़बड़ियां बताने से, हमें समस्या की जांच करने के लिए ज़रूरी जानकारी नहीं मिलती. आपको गड़बड़ी के उस असल मैसेज और गड़बड़ी के कोड को जानने की ज़रूरत है जो देखा जा रहा है.)

समय

समय बहुत ज़रूरी जानकारी है. सहायता इंजीनियर के लिए यह जानना ज़रूरी है कि समस्या के बारे में सबसे पहले आपको कब पता चला था, यह समस्या कितनी देर तक चली, और यह समस्या अब भी बनी हुई है या नहीं.

ऐसा हो सकता है कि समस्या को हल करने वाले सपोर्ट इंजीनियर आपके टाइमज़ोन के हिसाब से न हों. ऐसे में, समय के हिसाब से सही स्टेटमेंट की वजह से समस्या का पता लगाना मुश्किल हो जाता है. इसलिए, यह सुझाव दिया जाता है कि तारीख और टाइमस्टैंप के लिए ISO 8601 फ़ॉर्मैट का इस्तेमाल करें, ताकि आपको उस समय की सटीक जानकारी मिल सके जब समस्या हुई थी.

इस टेबल में कुछ ऐसे उदाहरण दिए गए हैं जिनमें समस्या होने का सटीक समय और कुल समय दिखाया गया है. यह जानकारी ऐसा करें कॉलम में है. साथ ही, क्या करें कॉलम में समस्या कब हुई, इस बारे में साफ़ तौर पर नहीं दी गई या साफ़ तौर पर जानकारी नहीं दी गई है:

ऐसा करें क्या न करें
कल 06-11-2020 17:30 पीडीटी और 06-11-2020 17:35 पीडीटी के बीच बड़ी संख्या में 503s देखे गए...

कल शाम 5:30 बजे, 5 मिनट के लिए बड़ी संख्या में 503s देखे गए.

(हमें साफ़ तौर पर बताई गई तारीख का इस्तेमाल करना पड़ता है. साथ ही, हम यह भी नहीं बता पाते हैं कि यह समस्या किस टाइमज़ोन में हुई थी.)

इन एपीआई प्रॉक्सी पर 09-11-2020 15:30 आईएसटी से 2020-11-09 18:10 आईएसटी तक इंतज़ार के समय का ज़्यादा होना देखा गया ...

पिछले हफ़्ते कुछ एपीआई प्रॉक्सी पर, इंतज़ार का समय ज़्यादा देखा गया.

(यह साफ़ नहीं है कि पिछले हफ़्ते यह समस्या किस दिन और कितने समय की थी.)

सेटअप

हमें इस बात की जानकारी होनी चाहिए कि आपको असल में कहां समस्या आ रही है. आपके इस्तेमाल किए जा रहे प्रॉडक्ट के आधार पर, हमें यह जानकारी चाहिए:

  • अगर Apigee Cloud का इस्तेमाल किया जा रहा है, तो हो सकता है कि आपके पास एक से ज़्यादा संगठन हों. इसलिए, हमें उस संगठन के बारे में और अन्य जानकारी की ज़रूरत होगी जहां आपको समस्या आ रही है:
    • संगठन और एनवायरमेंट के नाम
    • API प्रॉक्सी नाम और संशोधन संख्या (API अनुरोध विफलताओं के लिए)
  • अगर प्राइवेट क्लाउड का इस्तेमाल किया जा रहा है, तो हो सकता है कि आपके पास इंस्टॉलेशन के लिए लोकप्रिय जगहों में से किसी एक का इस्तेमाल करने की सुविधा हो. इसलिए, हमें यह जानने की ज़रूरत है कि आप किस टोपोलॉजी का इस्तेमाल कर रहे हैं. इसमें डेटा सेंटर और नोड की संख्या जैसी जानकारी भी शामिल है.

नीचे दिए गए टेबल में कुछ ऐसे उदाहरण दिए गए हैं जिनमें करें कॉलम में पूरी जानकारी और क्या न करें कॉलम में अधूरी जानकारी दिखाई गई है:

ऐसा करें क्या न करें

401 Edge Public Cloud पर 06-11-2020 09:30 सीएसटी से गड़बड़ियों की संख्या में बढ़ोतरी हुई है.

Edge सेटअप की जानकारी:

काम न करने वाले एपीआई की जानकारी यहां दी गई है:
संगठन के नाम: myorg
एनवी के नाम: test
एपीआई प्रॉक्सी नाम: myproxy
बदलाव नंबर: 3

गड़बड़ी:

{"fault":{"faultstring":"Failed to resolve API Key variable request.header.X-APP-API_KEY","detail":{"errorcode":"steps.oauth.v2.FailedToResolveAPIKey"}}}

401 गड़बड़ियां बढ़ गई हैं.

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

अतिरिक्त गेटवे नोड जोड़ने के बाद, Edge Private Cloud के वर्शन 4.19.06 पर, Message प्रोसेसर को चालू नहीं किया जा सका.

डाइग्नोस्टिक्स लॉग:
मैसेज प्रोसेसर के लॉग अटैच किए गए.

नेटवर्क टोपोलॉजी:
अतिरिक्त नोड वाली फ़ाइल network-topology.png अटैच की.

अतिरिक्त गेटवे नोड जोड़ने के बाद, Edge Private Cloud के वर्शन 4.19.06 पर, Message प्रोसेसर को चालू नहीं किया जा सका.

(मैसेज प्रोसेसर के लॉग और नेटवर्क टोपोलॉजी मौजूद नहीं हैं.)

काम के आर्टफ़ैक्ट

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

इस सेक्शन में कुछ ऐसे आर्टफ़ैक्ट के बारे में बताया गया है जो Apigee के सभी प्रॉडक्ट के लिए मददगार हैं:

सभी Apigee प्रॉडक्ट के लिए सामान्य आर्टफ़ैक्ट

नीचे दिए गए आर्टफ़ैक्ट सभी Apigee प्रॉडक्ट के लिए काम के हैं: Public Cloud पर Apigee Edge और प्राइवेट क्लाउड पर Apigee Edge:

सह-प्रॉडक्ट ब्यौरा
ट्रेस टूल आउटपुट ट्रेस टूल के आउटपुट में, Apigee प्रॉडक्ट के ज़रिए मिलने वाले एपीआई अनुरोधों की पूरी जानकारी शामिल होती है. यह रनटाइम की गड़बड़ी, जैसे कि 4XX, 5XX, और इंतज़ार के समय से जुड़ी समस्याओं के लिए फ़ायदेमंद है.
स्क्रीनशॉट स्क्रीनशॉट, असल व्यवहार या गड़बड़ी के संदर्भ को रिले करने में मदद करते हैं. यह यूज़र इंटरफ़ेस (यूआई) या Analytics जैसी गड़बड़ियों या गड़बड़ियों के लिए मददगार होता है.
HAR (Http ARchive) HAR एक ऐसी फ़ाइल है जिसे एचटीटीपी सेशन टूल से कैप्चर किया जाता है, ताकि यूज़र इंटरफ़ेस (यूआई) से जुड़ी समस्याओं को डीबग किया जा सके. इसे Chrome, Firefox या Internet Explorer जैसे ब्राउज़र का इस्तेमाल करके कैप्चर किया जा सकता है.
tcpdumps tcpdump टूल, नेटवर्क पर ट्रांसफ़र किए गए या मिले टीसीपी/आईपी पैकेट को कैप्चर करता है. यह नेटवर्क से जुड़ी किसी भी समस्या के लिए फ़ायदेमंद होता है. जैसे, TLS हैंडशेक का काम न करना, 502 की गड़बड़ियां, और इंतज़ार के समय से जुड़ी समस्याएं वगैरह.

Private Cloud के लिए, Apigee Edge के अन्य आर्टफ़ैक्ट

प्राइवेट क्लाउड के लिए Apigee Edge के लिए, हमें कुछ अन्य आर्टफ़ैक्ट की ज़रूरत पड़ सकती है. इनसे, समस्याओं का तेज़ी से पता लगाने में मदद मिलेगी.

सह-प्रॉडक्ट ब्यौरा
नेटवर्क टोपोलॉजी आपके Private Cloud के सेटअप के बारे में बताने वाला एज इंस्टॉलेशन टोपोलॉजी डायग्राम, जिसमें सभी डेटा सेंटर, नोड, और हर नोड में इंस्टॉल किए गए कॉम्पोनेंट शामिल हैं.
एज कॉम्पोनेंट डाइग्नोस्टिक्स लॉग खास Apigee Edge कॉम्पोनेंट से जुड़े डाइग्नोस्टिक लॉग, जैसे कि Message प्रोसेसर, राऊटर या कैसेंड्रा.
इंस्टॉलेशन कॉन्फ़िगरेशन फ़ाइल Apigee Edge को इंस्टॉल या अपग्रेड करते समय इस्तेमाल की जाने वाली साइलेंट कॉन्फ़िगरेशन फ़ाइल.

अगर इंस्टॉलेशन या माइग्रेशन में समस्याएं आती हैं, तो इस फ़ाइल से यह पुष्टि करने में मदद मिलेगी कि सभी सेटिंग सही हैं या नहीं.

हीप डंप हीप डंप, Java मेमोरी प्रोसेस का स्नैपशॉट हैं. यह तब मददगार होता है, जब कुछ EDGE कॉम्पोनेंट में, ज़्यादा मेमोरी का इस्तेमाल या OutOfMemory गड़बड़ियां मिलती हैं.
थ्रेड डंप थ्रेड डंप, चल रहे Java प्रोसेस के सभी थ्रेड का स्नैपशॉट होता है.

यह तब मददगार होता है, जब कुछ Edge कॉम्पोनेंट पर सीपीयू या लोड ज़्यादा होता है.

केस टेंप्लेट और सैंपल केस

इस सेक्शन में, इस दस्तावेज़ में बताए गए सबसे सही तरीकों के आधार पर, अलग-अलग प्रॉडक्ट के लिए केस टेंप्लेट और सैंपल केस दिए गए हैं:

Public Cloud पर Apigee Edge

टेंप्लेट

इस सेक्शन में, Apigee Edge on Public Cloud का सैंपल टेंप्लेट दिया गया है.

समस्या:

<आपकी ओर से देखी जा रही समस्या या व्यवहार का पूरा ब्यौरा दें. जहां लागू हो वहां प्रॉडक्ट का नाम और वर्शन शामिल करें.>

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

<गड़बड़ी का पूरा मैसेज शामिल करें (अगर कोई है)>

समस्या की शुरुआत का समय (ISO 8601 फ़ॉर्मैट):

समस्या खत्म होने का समय (ISO 8601 फ़ॉर्मैट):

Apigee सेटअप की जानकारी:
संगठन के नाम:
एनवी के नाम:
एपीआई प्रॉक्सी नाम:
बदलाव नंबर:

यह तरीका अपनाएं:

<अगर हो सके, तो समस्या को हल करने का तरीका बताएं>

गड़बड़ी से जुड़ी जानकारी:

<अटैच की गई फ़ाइलों की सूची>

सैंपल केस

इस सेक्शन में, Apigee Cloud (Google Cloud पर Apigee और Public Cloud पर) का सैंपल केस दिया गया है.

समस्या:

हमें अपने Public Cloud संगठन में, 503 ‘सेवा’ उपलब्ध न होने से जुड़ी बहुत सारी गड़बड़ियां दिख रही हैं. कृपया समस्या का पता लगाकर उसे ठीक करें या उसे हल करने का तरीका बताएं?

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

{"fault":{"faultstring":"The Service is temporarily available", "detail":{"errorcode":"messaging.adaptors.http.flow.ServiceUnavailable"}}}

समस्या के शुरू होने का समय (ISO 8601 फ़ॉर्मैट): 2020-10-04 06:30 आईएसटी

समस्या खत्म होने का समय (ISO 8601 फ़ॉर्मैट): समस्या अब भी आ रही है.

Apigee Cloud सेटअप की जानकारी:
संगठन के नाम: myorg
एनवी के नाम: dev
एपीआई प्रॉक्सी नाम: myproxy
बदलाव नंबर: 3

यह तरीका अपनाएं:

इस समस्या को फिर से सामने लाने के लिए, नीचे दिए गए curl कमांड को चलाएं:

curl -X GET 'https://myorg-dev.apigee.net/v1/myproxy'

गड़बड़ी से जुड़ी जानकारी:

ट्रेस टूल आउटपुट (trace-503.xml)

Private Cloud के लिए Apigee Edge

टेंप्लेट

इस सेक्शन में, Apigee Edge for Private Cloud का सैंपल टेंप्लेट दिया गया है.

समस्या:

<आपकी ओर से देखी जा रही समस्या या व्यवहार का पूरा ब्यौरा दें. जहां लागू हो वहां प्रॉडक्ट का नाम और वर्शन शामिल करें.>

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

<गड़बड़ी का पूरा मैसेज शामिल करें (अगर कोई है)>

समस्या की शुरुआत का समय (ISO 8601 फ़ॉर्मैट):

समस्या खत्म होने का समय (ISO 8601 फ़ॉर्मैट):

Edge Private Cloud के सेटअप की जानकारी:

<डेटा सेंटर और नोड के साथ अपने प्राइवेट क्लाउड के सेटअप के बारे में बताने वाली नेटवर्क टोपोलॉजी अटैच करें>

यह तरीका अपनाएं:

<अगर हो सके, तो समस्या को हल करने का तरीका बताएं>

गड़बड़ी से जुड़ी जानकारी

<अटैच की गई फ़ाइलों की सूची>

सैंपल केस

इस सेक्शन में, Apigee Edge for Private Cloud के लिए एक सैंपल केस दिया गया है.

समस्या:

Linux RHEL 7.6 पर, Edge Private Cloud 4.19.06 के हिस्से के तौर पर, नोड #10 पर Apigee मैनेजमेंट सर्वर इंस्टॉल करते समय, हमें यह गड़बड़ी मिली.

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

<snipped as the output is too long>
Checking for management-server uuid ................................................
Unable to get uuid for management-server.
Error: setup.sh: /opt/apigee/apigee-service/bin/apigee-service exited with unexpected status 1

समस्या शुरू होने का समय (ISO 8601 फ़ॉर्मैट): यह तब होता है, जब हम

समस्या खत्म होने का समय (ISO 8601 फ़ॉर्मैट): लागू नहीं

Edge Private Cloud के सेटअप की जानकारी:

network-topology.png फ़ाइल अटैच की गई

यह तरीका अपनाएं:

यह रहा वह निर्देश जिसकी वजह से यह गड़बड़ी हुई:

/opt/apigee/apigee-setup/bin/setup.sh -p ms -f /app/NonProdConfig.txt

गड़बड़ी से जुड़ी जानकारी:

ये फ़ाइलें अटैच की गईं:

  • output.txt इसमें गड़बड़ी के मैसेज के साथ ऊपर दिए गए निर्देश का पूरा आउटपुट शामिल है
  • मैनेजमेंट सर्वर लॉग और
  • कॉन्फ़िगरेशन फ़ाइल NonProdConfig.txt