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

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

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

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

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

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

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

इन सेक्शन में, इन कॉन्सेप्ट के बारे में ज़्यादा जानकारी दी गई है.

प्रॉडक्ट

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

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

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

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

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

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

हमारे निजी क्लाउड सेटअप पर इंस्टॉल नहीं किया जा सका.

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

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

उस समस्या के बारे में सटीक जानकारी दें जिसमें गड़बड़ी का मैसेज शामिल है (अगर कोई भी) और अपेक्षित और वास्तविक व्यवहार देखा गया.

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

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

नया 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 पीडीटी के बीच, ज़्यादा संख्या में 503s देखा गया और 06-11-2020 17:35 पीडीटी...

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

(हम ज़ाहिर की गई तारीख का इस्तेमाल करने के लिए मजबूर हैं और यह भी साफ़ नहीं है कि यह समस्या किस टाइमज़ोन में है देखा गया.)

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

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

(यह साफ़ तौर पर नहीं बताया गया है कि पिछले हफ़्ते यह समस्या किस दिन और अवधि के दौरान आई थी.)

सेटअप

हमें इस बारे में विवरण जानने की आवश्यकता है कि आपको असल में समस्या कहां दिखाई दे रही है. इसके आधार पर के लिए उपयोग कर रहे हैं, तो हमें निम्न जानकारी की आवश्यकता है:

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

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

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

Edge Public Cloud पर 401 गड़बड़ियां 06-11-2020 09:30 CST से बढ़ गई हैं.

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 पर मैसेज प्रोसेसर शुरू नहीं किया जा सका अतिरिक्त गेटवे नोड जोड़ना.

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

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

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

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

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

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

इस सेक्शन में कुछ ऐसे आर्टफ़ैक्ट के बारे में बताया गया है जो 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 गड़बड़ियां, इंतज़ार का समय वगैरह.

प्राइवेट क्लाउड के लिए Apigee Edge के लिए अतिरिक्त आर्टफ़ैक्ट

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

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

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

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

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

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

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

सार्वजनिक क्लाउड पर Apigee Edge

टेंप्लेट

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

समस्या:

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

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

<अगर गड़बड़ी का कोई मैसेज दिखा है, तो उसे शामिल करें>

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

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

Apigee के सेटअप से जुड़ी जानकारी:
संगठन के नाम:
एनवायरमेंट के नाम:
एपीआई प्रॉक्सी के नाम:
संशोधन संख्या:

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

<जहां मुमकिन हो, वहां समस्या को दोबारा हल करने के तरीके बताएं>

गड़बड़ी की जानकारी:

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

सैंपल केस

यह सेक्शन Apigee Cloud (Google पर Apigee) के लिए एक सैंपल केस उपलब्ध कराता है Public Cloud पर Cloud/Apigee Edge).

समस्या:

हमें अपने पब्लिक क्लाउड में बड़ी संख्या में 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)

प्राइवेट क्लाउड के लिए Apigee Edge

टेंप्लेट

इस सेक्शन में, इसके लिए टेंप्लेट का सैंपल दिया गया है प्राइवेट क्लाउड के लिए Apigee Edge.

समस्या:

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

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

<अगर गड़बड़ी का कोई मैसेज दिखा है, तो उसे शामिल करें>

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

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

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

<अपने Private Cloud के सेटअप की जानकारी देने वाली नेटवर्क टोपोलॉजी अटैच करें. इसमें ये भी शामिल हैं डेटा सेंटर और नोड>

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

<जहां मुमकिन हो, वहां समस्या को दोबारा हल करने के तरीके बताएं>

डाइग्नोस्टिक्स के बारे में जानकारी

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

सैंपल केस

इस सेक्शन में, प्राइवेट क्लाउड के लिए Apigee Edge का सैंपल केस दिया गया है.

समस्या:

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

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

<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