Apigee Edge दस्तावेज़ देखा जा रहा है.
Apigee X दस्तावेज़ पर जाएं. जानकारी
उदाहरण के तौर पर दिए गए किसी उदाहरण को देखें. इसमें, आपके एपीआई की 5xx समस्याओं को हल करने का तरीका बताया गया है.
# | चरण | ब्यौरा |
---|---|---|
1 | एपीआई से हाल ही में मिले ट्रैफ़िक पर नज़र रखना | उन सभी एपीआई प्रॉक्सी और टारगेट के लिए, हाल ही का एपीआई मॉनिटरिंग डेटा देखें जिनमें पिछले एक घंटे में ट्रैफ़िक आया था. ज़्यादा गड़बड़ी % दर वाले एपीआई प्रॉक्सी या टारगेट पर ड्रिल-डाउन करें. |
2 | एपीआई को मॉनिटर करने वाले डेटा में, रुझानों का पता लगाना | ज़्यादा बेहतर जानकारी पाने के लिए, पिछले तीन महीनों तक के एपीआई के मॉनिटरिंग डेटा का पुराना व्यू ऐक्सेस करें. |
3 | 5xx समस्याओं की जांच करना | उन गड़बड़ी कोड को देखें जिनमें 5xx समस्याओं के सोर्स की जांच करने के लिए, समय के साथ सबसे ज़्यादा संख्या का सामना किया जा रहा है. (आम तौर पर, 5xx स्टेटस कोड को एक या उससे ज़्यादा गड़बड़ी वाले कोड का इस्तेमाल करके कैटगरी में बांटा जा सकता है.) |
4 | 5xx अलर्ट सेट अप करें | 5xx स्टेटस कोड की संख्या किसी तय थ्रेशोल्ड से ज़्यादा होने पर, सूचना पाने के लिए सूचना सेट अप करें. |
5 | क्लाइंट की जानकारी वाली कस्टम रिपोर्ट जनरेट करना (ज़रूरी नहीं) | आपके पास, 5xx गड़बड़ियों को ट्रिगर करने वाले क्लाइंट के बारे में जानकारी पाने के लिए, कस्टम रिपोर्ट जनरेट करने का भी विकल्प है. ध्यान दें: कस्टम रिपोर्ट जनरेट करने के लिए, आपका संगठन का एडमिन होना ज़रूरी है. |
6 | एपीआई की प्रॉक्सी को कलेक्शन में ग्रुप करना | एपीआई प्रॉक्सी को ग्रुप करने के लिए कलेक्शन बनाएं और ग्रुप के सभी सदस्यों के लिए अलर्ट थ्रेशोल्ड की सही वैल्यू सेट अप करें. इससे समस्याओं का तेज़ी से पता लगाया जा सकता है.
|
7 | 5xx कोड की समस्याओं को हल करें | आपकी जांच और जांच के आधार पर, 5xx समस्याओं को ठीक करने के लिए ज़रूरी कार्रवाइयां करें. |
पहला चरण: हाल ही के एपीआई ट्रैफ़िक पर नज़र रखना
पिछले एक घंटे में ट्रैफ़िक रखने वाले एपीआई प्रॉक्सी और टारगेट का एपीआई मॉनिटरिंग डेटा देखने के लिए:
- हाल ही के डैशबोर्ड को ऐक्सेस करने के लिए, Edge यूज़र इंटरफ़ेस (यूआई) में विश्लेषण > एपीआई मॉनिटरिंग > हाल ही का चुनें.
उन एपीआई प्रॉक्सी और टारगेट पर ध्यान दें जिनमें पिछले एक घंटे में गड़बड़ी % की दर ज़्यादा रही.
दाएं पैनल में जानकारी देखने के लिए, एपीआई प्रॉक्सी या तेज़ गड़बड़ी % दर वाले टारगेट पर क्लिक करें. इस उदाहरण में 5xx गड़बड़ियों का ज़्यादा प्रतिशत देखें.
इस चरण के बारे में ज़्यादा जानने के लिए, हाल ही के एपीआई ट्रैफ़िक पर नज़र रखना लेख पढ़ें.
दूसरा चरण: अपने एपीआई के मॉनिटरिंग डेटा में रुझानों की पहचान करना
पिछले तीन महीनों तक ट्रैफ़िक रखने वाले एपीआई प्रॉक्सी और टारगेट के लिए, एपीआई के मॉनिटरिंग डेटा के पुराने व्यू को ऐक्सेस करने के लिए:
- टाइमलाइन डैशबोर्ड को ऐक्सेस करने के लिए, हाल ही के डैशबोर्ड के दाएं पैनल में, > टाइमलाइन में देखें को चुनें.
इसके अलावा, Edge यूज़र इंटरफ़ेस (यूआई) में विश्लेषण > एपीआई मॉनिटरिंग > टाइमलाइन पर क्लिक करें.
- एपीआई प्रॉक्सी का रुझान देखें या समय के साथ टारगेट करें. ध्यान दें कि पिछले सात दिनों से यह रुझान लगातार बना हुआ है.
इस चरण के बारे में ज़्यादा जानने के लिए, अपने एपीआई के मॉनिटरिंग डेटा में रुझानों की पहचान करना लेख पढ़ें.
तीसरा चरण: 5xx समस्याओं की जांच करना
Apigee, गलत कोड का एक सेट उपलब्ध कराता है, जिससे समस्याओं का पता लगाने में मदद मिलती है. आम तौर पर, 5xx स्टेटस कोड को एक या उससे ज़्यादा गड़बड़ी वाले कोड का इस्तेमाल करके कैटगरी में बांटा जा सकता है.
5xx समस्याओं की जांच करने के लिए:
- 'जांच करें' डैशबोर्ड को ऐक्सेस करने के लिए, टाइमलाइन डैशबोर्ड के दाएं पैनल में, > जांच में देखें को चुनें.
इसके अलावा, Edge यूज़र इंटरफ़ेस (यूआई) में विश्लेषण > एपीआई मॉनिटरिंग > जांच करें पर क्लिक करें.
'जांच करें' डैशबोर्ड की मदद से, मेट्रिक के बीच मिलती-जुलती गतिविधि की तुलना की जा सकती है. जैसे, गड़बड़ी का कोड और समय. पिछले एक घंटे में गड़बड़ी कोड की गतिविधि देखने के लिए गलत कोड बनाम टाइम मैट्रिक्स देखें. उन गड़बड़ी कोड पर ध्यान दें जो ब्लॉक की कलर शेडिंग के आधार पर सबसे ज़्यादा वॉल्यूम का सामना कर रहे हैं. ब्लॉक जितना गहरा होगा, रिलेटिव वॉल्यूम उतना ही ज़्यादा होगा.
उदाहरण के लिए,
policies.ratelimit.SpikeArrestViolation
औरpolicies.ratelimit.QuotaViolation
गड़बड़ी कोड नीचे दिए गए मैट्रिक्स में ज़्यादा रिलेटिव वॉल्यूम दिखा रहे हैं:दाएं पैनल में ज़्यादा जानकारी देखने के लिए,
policies.ratelimit.SpikeArrestViolation
पंक्ति में सबसे गहरे रंग वाले ब्लॉक (पहला ब्लॉक) पर क्लिक करें.
ध्यान दें कि गड़बड़ी का सोर्स perfBenchmark_invalid_v1 एपीआई प्रॉक्सी है और एचटीटीपी स्टेटस कोड perfBenchmark_invalid_v1 है. स्पाइक अरेस्ट नीति के उल्लंघनों के लिए 500 स्टेटस कोड, रनटाइम के दौरान होने वाली आम गड़बड़ी का कोड है.
गड़बड़ी की सबसे ज़्यादा दर वाले डेवलपर ऐप्लिकेशन की पहचान करने के लिए, 'संदिग्ध वजह' पैनल के नीचे, डेवलपर ऐप्लिकेशन के हिसाब से डिस्ट्रिब्यूशन देखें.
इस चरण के बारे में ज़्यादा जानकारी के लिए, समस्याओं को पहचानना देखें.
चौथा चरण: 5xx अलर्ट सेट अप करना
जांच के ब्यौरे वाले पैनल में, चुने गए संदर्भ के आधार पर सूचना सेट अप करें. इससे, आपको 5xx स्टेटस कोड की संख्या तय सीमा से ज़्यादा होने पर सूचना मिलेगी.
'जांच करें' डैशबोर्ड के दाएं पैनल में, > सूचना बनाएं चुनें.
सूचना डायलॉग में दिए गए फ़ील्ड भरें. शर्त वाले फ़ील्ड में, मौजूदा कॉन्टेक्स्ट का डेटा अपने-आप भर जाता है. उदाहरण के लिए:
सेव करें पर क्लिक करें.
आने वाले समय में, जब perfBenchmark_invalid_v1 एपीआई प्रॉक्सी के लिए 5 मिनट की अवधि के लिए 5xx गड़बड़ी की दर 5% से ज़्यादा हो जाएगी, तो तय किए गए ईमेल पर एक perfBenchmark_invalid_v1 भेजी जाएगी और यूज़र इंटरफ़ेस (यूआई) में एक perfBenchmark_invalid_v1 दिखाया जाएगा. उदाहरण के लिए:
इस चरण के बारे में ज़्यादा जानकारी पाने के लिए, सूचनाएं और सूचनाएं सेट अप करना लेख पढ़ें.
चरण 5: क्लाइंट की जानकारी वाली कस्टम रिपोर्ट जनरेट करना (ज़रूरी नहीं)
इसके अलावा, 5xx गड़बड़ियों को ट्रिगर करने वाले क्लाइंट के बारे में ज़्यादा जानकारी के लिए, एक कस्टम रिपोर्ट जनरेट करें.
रिपोर्ट पेज पर, किसी सूचना के आधार पर बनाई गई कस्टम रिपोर्ट को इस फ़ॉर्मैट का इस्तेमाल करके नाम दिया जाता है: API Monitoring Generated: alert-name
.
नीचे दिए गए तरीकों में से किसी एक तरीके से सूचना सेट अप करते समय बनाई गई कस्टम रिपोर्ट को ऐक्सेस करें:
रिपोर्ट पेज दिखाने के लिए, बाएं नेविगेशन बार में विश्लेषण > कस्टम रिपोर्ट > रिपोर्ट चुनें. सूची में रिपोर्ट के नाम पर क्लिक करें: एपीआई मॉनिटरिंग जनरेट की गई: 5xx अलर्ट
सूचना बनाए जाने के बाद दिखने वाली सूचना पर क्लिक करें. उदाहरण के लिए:
इन डाइमेंशन को जोड़ें:
- डेवलपर ऐप्लिकेशन
- Client ID
- क्लाइंट का आईपी पता
बहुत ज़्यादा गड़बड़ी दर वाले खास डेवलपर ऐप्लिकेशन के आधार पर रिपोर्ट देखने के लिए, नीचे दिया गया फ़िल्टर जोड़ें:
and (developer_app eq 'perfBenchmarkApp0')
ध्यान दें: ऐसे मामले में, डाइमेंशन की सूची से डेवलपर ऐप्लिकेशन को हटा दें.
सेव करें पर क्लिक करें.
डेवलपर ऐप्लिकेशन और 5xx स्टेटस कोड को ट्रिगर करने वाले क्लाइंट के बारे में जानकारी देखने के लिए, रिपोर्ट चलाएं.
इस चरण के बारे में ज़्यादा जानकारी के लिए, कस्टम रिपोर्ट बनाना लेख पढ़ें.
छठा चरण: कलेक्शन में, एपीआई प्रॉक्सी का ग्रुप बनाना
एपीआई प्रॉक्सी को ग्रुप करने के लिए कलेक्शन बनाएं और ग्रुप के सभी सदस्यों के लिए अलर्ट थ्रेशोल्ड की सही वैल्यू सेट अप करें. इससे समस्याओं का तेज़ी से पता लगाया जा सकता है.
- कलेक्शन डैशबोर्ड दिखाने के लिए, Edge यूज़र इंटरफ़ेस (यूआई) में विश्लेषण > एपीआई मॉनिटरिंग > कलेक्शन चुनें.
- + संग्रह पर क्लिक करें.
- प्रॉक्सी चुनें.
- परिवेश ड्रॉप-डाउन से प्रोडक्शन चुनें.
- आगे बढ़ें पर क्लिक करें.
- कलेक्शन डायलॉग में फ़ील्ड भरें.
- सेव करें पर क्लिक करें
इसके बाद, चौथे चरण की तरह ही सूचना सेट अप की जा सकती है. साथ ही, ऊपर तय किए गए कलेक्शन के लिए डाइमेंशन सेट किया जा सकता है.
इस चरण के बारे में ज़्यादा जानकारी के लिए, कलेक्शन मैनेज करना देखें.
सातवां चरण: 5xx समस्याओं को ठीक करना
5xx समस्याओं को ठीक करने के लिए ज़रूरी कार्रवाई करें. उदाहरण के लिए, आपके विश्लेषण के आधार पर आप नीचे दिए गए कामों में से कोई एक काम कर सकते हैं:
- Apigee Sense का इस्तेमाल करके, यह पता लगाएं कि अनुरोधों की संख्या में बढ़ोतरी संदिग्ध है या नहीं. साथ ही, यह तय करें कि आपको कस्टम रिपोर्ट में बताए गए क्लाइंट के आईपी पते को ब्लॉक करना है या नहीं.
- एक खास समयावधि में, डेवलपर ऐप्लिकेशन आपके एपीआई प्रॉक्सी में कितने कनेक्शन कर सकते हैं, इसे सीमित करने के लिए कोटा नीति जोड़ें.
- अपने API से कमाई करें, ताकि एक तय संख्या में कॉल करने पर डेवलपर से शुल्क लिया जा सके.