एक सैंपल स्थिति देखें

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

इस उदाहरण में, एपीआई से जुड़ी 5xx गड़बड़ियों को ठीक करने का तरीका बताया गया है.

#	चरण	ब्यौरा
1	एपीआई से मिले हाल ही के ट्रैफ़िक को मॉनिटर करना	उन सभी एपीआई प्रॉक्सी और टारगेट के लिए, एपीआई मॉनिटरिंग का हाल ही का डेटा देखें जिन पर पिछले एक घंटे में ट्रैफ़िक आया है. ज़्यादा गड़बड़ी वाले एपीआई प्रॉक्सी या टारगेट की ज़्यादा जानकारी देखें.
2	एपीआई मॉनिटरिंग डेटा में रुझानों की पहचान करना	ज़्यादा जानकारी पाने के लिए, पिछले तीन महीनों तक के एपीआई मॉनिटरिंग डेटा का पुराना व्यू ऐक्सेस करें.
3	5xx गड़बड़ियों की जांच करना	उन गड़बड़ी कोड को देखें जिनकी वजह से समय के साथ 5xx गड़बड़ियां सबसे ज़्यादा हुई हैं. इससे 5xx गड़बड़ियों के सोर्स के बारे में ज़्यादा जानकारी मिल सकती है. (आम तौर पर, 5xx स्टेटस कोड को एक या उससे ज़्यादा गड़बड़ी कोड का इस्तेमाल करके कैटगरी में रखा जा सकता है.)
4	5xx गड़बड़ी की सूचना पाने की सुविधा सेट अप करना	5xx स्टेटस कोड की संख्या किसी थ्रेशोल्ड से ज़्यादा होने पर सूचना पाने के लिए, सूचना सेट अप करें.
5	क्लाइंट की जानकारी वाली कस्टम रिपोर्ट जनरेट करना (ज़रूरी नहीं)	5xx गड़बड़ियां ट्रिगर करने वाले क्लाइंट के बारे में जानकारी पाने के लिए, कस्टम रिपोर्ट जनरेट की जा सकती है. ध्यान दें: कस्टम रिपोर्ट जनरेट करने के लिए, आपके पास संगठन के एडमिन की भूमिका होनी चाहिए.
6	एपीआई प्रॉक्सी को किसी कलेक्शन में ग्रुप करना	एपीआई प्रॉक्सी को ग्रुप करने के लिए एक कलेक्शन बनाएं. साथ ही, ग्रुप के सभी सदस्यों के लिए सूचना के थ्रेशोल्ड की सही वैल्यू सेट अप करें, ताकि समस्याओं का पता तेज़ी से लगाया जा सके.
7	5xx से जुड़ी समस्याएं हल करना	जांच और विश्लेषण के आधार पर, 5xx से जुड़ी समस्याओं को हल करने के लिए ज़रूरी कार्रवाइयां करें.

पहला चरण: हाल ही के एपीआई ट्रैफ़िक पर नज़र रखना

पिछले एक घंटे में जिन एपीआई प्रॉक्सी और टारगेट पर ट्रैफ़िक आया है उनके लिए, एपीआई मॉनिटरिंग डेटा देखने के लिए:

1. हाल का डैशबोर्ड ऐक्सेस करने के लिए, Edge यूज़र इंटरफ़ेस (यूआई) में विश्लेषण करें > एपीआई मॉनिटरिंग > हाल ही का चुनें.

2. उन एपीआई प्रॉक्सी और टारगेट पर ध्यान दें जिनमें पिछले एक घंटे में गड़बड़ी का प्रतिशत ज़्यादा रहा है.
   

   लेख पढ़ें

3. गड़बड़ी की ज़्यादा दर वाली एपीआई प्रॉक्सी या टारगेट पर क्लिक करें. इससे आपको दाईं ओर मौजूद पैनल में जानकारी दिखेगी. इस उदाहरण में, 5xx गड़बड़ियों का ज़्यादा प्रतिशत देखें.

   

इस चरण के बारे में ज़्यादा जानने के लिए, एपीआई के हाल ही के ट्रैफ़िक को मॉनिटर करना लेख पढ़ें.

दूसरा चरण: एपीआई मॉनिटरिंग डेटा में रुझानों की पहचान करना

पिछले तीन महीनों में जिन एपीआई प्रॉक्सी और टारगेट पर ट्रैफ़िक आया है उनके लिए, एपीआई मॉनिटरिंग डेटा का पुराना व्यू ऐक्सेस करने के लिए:

1. टाइमलाइन डैशबोर्ड को ऐक्सेस करने के लिए, हाल ही के डैशबोर्ड के दाईं ओर मौजूद पैनल में, > टाइमलाइन में देखें को चुनें. इसके अलावा, Edge यूज़र इंटरफ़ेस (यूआई) में विश्लेषण करें > एपीआई मॉनिटरिंग > टाइमलाइन पर क्लिक करें.
   
2. समय के साथ एपीआई प्रॉक्सी या टारगेट के रुझान देखें. ध्यान दें कि पिछले सात दिनों से ट्रेंड एक जैसा है.

इस चरण के बारे में ज़्यादा जानने के लिए, एपीआई मॉनिटरिंग डेटा में रुझानों की पहचान करना लेख पढ़ें.

तीसरा चरण: 5xx से जुड़ी समस्याओं की जांच करना

Apigee, गड़बड़ी के कोड का एक सेट उपलब्ध कराता है. इससे आपको समस्याओं का पता लगाने में मदद मिलती है. आम तौर पर, 5xx स्टेटस कोड को एक या उससे ज़्यादा गड़बड़ी कोड का इस्तेमाल करके कैटगरी में बांटा जा सकता है.

5xx से जुड़ी समस्याओं की जांच करने के लिए:

1. जांच डैशबोर्ड को ऐक्सेस करने के लिए, टाइमलाइन डैशबोर्ड के दाईं ओर मौजूद पैनल में, > जांच में देखें को चुनें. इसके अलावा, Edge UI में विश्लेषण करें > एपीआई मॉनिटरिंग > जांच करें पर क्लिक करें.
   
   'जांच करें' डैशबोर्ड की मदद से, मेट्रिक के बीच संबंध वाली गतिविधि की तुलना की जा सकती है. जैसे, गड़बड़ी कोड बनाम समय.

2. पिछले एक घंटे में हुई गड़बड़ी के कोड की गतिविधि देखने के लिए, गड़बड़ी के कोड बनाम समय मैट्रिक्स देखें. ब्लॉक की कलर शेडिंग के आधार पर, उन गड़बड़ी कोड पर ध्यान दें जिनकी संख्या सबसे ज़्यादा है. ब्लॉक जितना गहरा होगा, रिलेटिव वॉल्यूम उतना ही ज़्यादा होगा.

   उदाहरण के लिए, यहां दी गई मैट्रिक्स में policies.ratelimit.SpikeArrestViolation और policies.ratelimit.QuotaViolation गड़बड़ी कोड, ज़्यादा रिलेटिव वॉल्यूम दिखा रहे हैं:

3. ज़्यादा जानकारी देखने के लिए, दाईं ओर मौजूद पैनल में policies.ratelimit.SpikeArrestViolation लाइन में सबसे गहरे रंग वाले ब्लॉक (पहला ब्लॉक) पर क्लिक करें.
   

4. ध्यान दें कि गड़बड़ी का सोर्स perfBenchmark_invalid_v1 एपीआई प्रॉक्सी है और एचटीटीपी स्टेटस कोड 500 है. 500 स्टेटस कोड, स्पाइक अरेस्ट की नीति के उल्लंघन के लिए, रनटाइम में होने वाली गड़बड़ी का सामान्य कोड है.

5. सबसे ज़्यादा गड़बड़ी वाले डेवलपर ऐप्लिकेशन का पता लगाने के लिए, 'डेवलपर ऐप्लिकेशन के हिसाब से डिस्ट्रिब्यूशन' सेक्शन देखें. यह सेक्शन, 'गड़बड़ी की संभावित वजह' पैनल के ठीक नीचे होता है.
   

इस चरण के बारे में ज़्यादा जानने के लिए, समस्याएं पहचानना लेख पढ़ें.

चौथा चरण: 5xx गड़बड़ी की सूचना पाने की सुविधा सेट अप करना

'जानकारी की जांच करें' पैनल में चुने गए कॉन्टेक्स्ट के आधार पर सूचना सेट अप करें, ताकि 5xx स्टेटस कोड की संख्या किसी तय सीमा से ज़्यादा होने पर आपको सूचना मिल सके.

1. जांच डैशबोर्ड के दाईं ओर मौजूद पैनल में, > सूचना बनाएं को चुनें.

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

   

3. सेव करें पर क्लिक करें.

अगर आने वाले समय में, perfBenchmark_invalid_v1 एपीआई प्रॉक्सी के लिए, 5xx गड़बड़ी की दर पांच मिनट की अवधि में 5% से ज़्यादा हो जाती है, तो तय किए गए ईमेल पते पर एक सूचना भेजी जाती है. साथ ही, यूज़र इंटरफ़ेस (यूआई) में एक विज़ुअल अलर्ट दिखती है. उदाहरण के लिए:

इस चरण के बारे में ज़्यादा जानने के लिए, सूचनाएं और सूचनाएं सेट अप करना लेख पढ़ें.

पाँचवां चरण: क्लाइंट की जानकारी वाली कस्टम रिपोर्ट जनरेट करना (ज़रूरी नहीं)

इसके अलावा, 5xx गड़बड़ियां ट्रिगर करने वाले क्लाइंट के बारे में ज़्यादा जानकारी पाने के लिए, कस्टम रिपोर्ट जनरेट करें.

रिपोर्ट पेज पर, सूचना के आधार पर बनाई गई कस्टम रिपोर्ट के नाम इस फ़ॉर्मैट में होते हैं: API Monitoring Generated: alert-name.

1. सूचना सेट अप करते समय बनाई गई कस्टम रिपोर्ट को इनमें से किसी एक तरीके से ऐक्सेस करें:

   • रिपोर्ट पेज दिखाने के लिए, बाएं नेविगेशन बार में विश्लेषण करें > कस्टम रिपोर्ट > रिपोर्ट को चुनें. सूची में मौजूद रिपोर्ट के नाम पर क्लिक करें: एपीआई मॉनिटरिंग से जनरेट हुई: 5xx गड़बड़ी की सूचना

   • अलर्ट बनने पर दिखने वाली सूचना पर क्लिक करें. उदाहरण के लिए:

   

2. ये डाइमेंशन जोड़ें:

   • Developer App
   • क्लाइंट आईडी
   • क्लाइंट का आईपी पता

   

3. ज़्यादा गड़बड़ी वाली दर वाले किसी डेवलपर ऐप्लिकेशन के आधार पर रिपोर्ट देखने के लिए, इस तरह का फ़िल्टर जोड़ें:

   and (developer_app eq 'perfBenchmarkApp0')

   ध्यान दें: इस मामले में, डाइमेंशन की सूची से डेवलपर ऐप्लिकेशन को हटाएं.

4. सेव करें पर क्लिक करें.

5. डेवलपर ऐप्लिकेशन और 5xx स्टेटस कोड ट्रिगर करने वाले क्लाइंट के बारे में जानकारी देखने के लिए, रिपोर्ट जनरेट करें.

इस चरण के बारे में ज़्यादा जानकारी के लिए, कस्टम रिपोर्ट बनाना लेख पढ़ें.

छठा चरण: एपीआई प्रॉक्सी को किसी कलेक्शन में ग्रुप करना

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

1. Collections डैशबोर्ड दिखाने के लिए, Edge के यूज़र इंटरफ़ेस (यूआई) में विश्लेषण करें > एपीआई मॉनिटरिंग > कलेक्शन चुनें.
2. + कलेक्शन पर क्लिक करें.
3. प्रॉक्सी को चुनें.
4. एनवायरमेंट ड्रॉप-डाउन से prod चुनें.
5. आगे बढ़ें पर क्लिक करें.
6. संग्रह डायलॉग में दिए गए फ़ील्ड भरें.
   
7. सेव करें पर क्लिक करें

इसके बाद, चौथे चरण की तरह ही सूचना सेट अप करें. साथ ही, डाइमेंशन को उस कलेक्शन पर सेट करें जिसे आपने ऊपर तय किया था.

इस चरण के बारे में ज़्यादा जानने के लिए, कलेक्शन मैनेज करना लेख पढ़ें.

सातवां चरण: 5xx से जुड़ी समस्याओं को हल करना

5xx से जुड़ी समस्याओं को हल करने के लिए ज़रूरी कार्रवाइयां करें. उदाहरण के लिए, समस्या का पता लगाने के बाद, इनमें से कोई एक काम किया जा सकता है:

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