समस्याओं की जांच करना

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

जांच करें डैशबोर्ड की मदद से, सभी एपीआई ट्रैफ़िक के लिए मेट्रिक और एट्रिब्यूट की पिवट टेबल देखी जा सकती हैं. साथ ही, समस्याओं की तेज़ी से जांच करने और उनका पता लगाने के लिए, मेट्रिक के बीच संबंध वाली गतिविधि की तुलना की जा सकती है. डैशबोर्ड में, पिछले 30 दिनों का डेटा ऐक्सेस किया जा सकता है.

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

  • स्टेटस कोड की मदद से, एपीआई प्रॉक्सी और टारगेट सेवाओं के लिए स्टेटस कोड मेट्रिक की जांच की जा सकती है.
  • लेटेंसी की मदद से, एपीआई प्रॉक्सी और टारगेट सेवाओं के लिए लेटेंसी से जुड़ी समस्याओं की जांच की जा सकती है.

जांच डैशबोर्ड में जाकर, किसी खास सूचना की वजह से हुई समस्याओं की जांच भी की जा सकती है. सूचना मिलने पर, सूचना का इतिहास पेज में जाकर सूचना के नाम पर क्लिक करें. इससे, सूचना की जानकारी, जांच डैशबोर्ड में खुल जाएगी.

किसी समस्या का पता लगाने के लिए, 'जांच करें' डैशबोर्ड का इस्तेमाल करना

उदाहरण के लिए, आपको एक सूचना मिलती है. इसमें बताया गया है कि 5xx गड़बड़ी का रेट, तय किए गए थ्रेशोल्ड से ज़्यादा है. इस समस्या की जांच करने के लिए, 'जांच करें' डैशबोर्ड पर ये काम किए जा सकते हैं:

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

स्टेटस कोड डैशबोर्ड का इस्तेमाल करना

स्टेटस कोड डैशबोर्ड की मदद से, अपने संगठन में मौजूद एपीआई प्रॉक्सी और टारगेट सेवाओं के लिए, स्टेटस कोड मेट्रिक की जांच की जा सकती है. पिछले 30 दिनों में, किसी भी समय एक घंटे या चार घंटे की विंडो के लिए, स्टेटस कोड मेट्रिक देखी जा सकती हैं.

स्टेटस कोड डैशबोर्ड एक्सप्लोर करना

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

स्टेटस कोड पेज

आंकड़े में हाइलाइट किए गए 'जांच करें' डैशबोर्ड की मदद से, ये काम किए जा सकते हैं:

  • मेट्रिक के बीच के संबंध को समझने और ज़्यादा अहम जानकारी पाने के लिए, हर मैट्रिक्स को कॉन्फ़िगर करें. इसके लिए, उसके x-ऐक्सिस और y-ऐक्सिस को सेट करें.
  • ब्लॉक की कलर शेडिंग के आधार पर, उन मेट्रिक की तुरंत पहचान करें जिनमें सबसे ज़्यादा रिलेटिव वॉल्यूम है. ब्लॉक जितना गहरा होगा, रिलेटिव वॉल्यूम उतना ही ज़्यादा होगा.
  • मेट्रिक की जानकारी देखने के लिए, मैट्रिक्स में किसी ब्लॉक पर क्लिक करें.
  • इस आधार पर डेटा फ़िल्टर करें:
    • परिवेश
    • क्षेत्र
    • प्रॉक्सी
    • स्टेटस कोड (इसमें सभी तरह का ट्रैफ़िक, सभी गड़बड़ियां, 2xx, 4xx या 5xx शामिल हैं)
    • पिछले 30 दिनों की तारीख और समय
    • एक घंटे या चार घंटे की अवधि

डैशबोर्ड का इस्तेमाल करके, ये काम तुरंत किए जा सकते हैं:

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

स्टेटस कोड मैट्रिक्स को कॉन्फ़िगर करना

स्टेटस कोड डैशबोर्ड चुनने पर, ये मैट्रिक्स डिफ़ॉल्ट रूप से दिखती हैं:

  • गड़बड़ी का कोड बनाम समय
  • फ़ॉल्ट कोड बनाम एचटीटीपी स्टेटस
  • गड़बड़ी का सोर्स बनाम एपीआई प्रॉक्सी

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

  • गड़बड़ी का कोड
  • नीति का उल्लंघन
  • गड़बड़ी का सोर्स
  • एचटीटीपी कोड स्थिति
  • प्रॉक्सी
  • समय
  • क्षेत्र
  • टारगेट (टारगेट सेवा या ServiceCallout नीति. अगर टारगेट ServiceCallout नीति है, तो दिखाई गई वैल्यू के पहले sc:// जोड़ा जाता है. उदाहरण के लिए, sc://my.endpoint.net.)

मैट्रिक्स कॉन्फ़िगर करना

स्टेटस कोड मेट्रिक की जानकारी देखना

मैट्रिक्स में किसी मेट्रिक के ब्लॉक पर क्लिक करके, उसकी जानकारी देखें.

ब्लॉक चुनें

समस्या की संभावित वजह से जुड़ी जानकारी, दाईं ओर मौजूद पैनल में दिखती है. इसमें यह जानकारी शामिल होती है:

  • परिवेश
  • संगठन
  • क्षेत्र
  • गड़बड़ी का सोर्स (प्रॉक्सी, टारगेट या Apigee इंफ़्रास्ट्रक्चर)

इसमें यह जानकारी भी शामिल हो सकती है:

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

अगर किसी खास मेट्रिक के लिए कार्डिनलिटी एक से ज़्यादा है, तो जानकारी वाले पैनल में गड़बड़ी के डिस्ट्रिब्यूशन की जानकारी शामिल हो सकती है. जैसे, डेवलपर ऐप्लिकेशन के हिसाब से डिस्ट्रिब्यूशन, गड़बड़ी की नीति के हिसाब से डिस्ट्रिब्यूशन, गड़बड़ी के कोड के हिसाब से डिस्ट्रिब्यूशन, एचटीटीपी स्टेटस के हिसाब से डिस्ट्रिब्यूशन वगैरह. उदाहरण के लिए:

डिस्ट्रिब्यूशन के हिसाब से

अगर गड़बड़ी की वजह टारगेट है, तो ज़्यादा जानकारी वाले पैनल में टारगेट के हिसाब से गड़बड़ी की दर दिखेगी. उदाहरण के लिए:

टारगेट के हिसाब से गड़बड़ी की दर

लेटेंसी डैशबोर्ड का इस्तेमाल करना

लेटेंसी डैशबोर्ड, आपके संगठन में मौजूद एपीआई प्रॉक्सी और टारगेट सेवाओं के लिए लेटेंसी की जानकारी दिखाता है. पिछले 30 दिनों में, किसी भी समय एक घंटे की विंडो के लिए, इंतज़ार के समय की मेट्रिक की जांच की जा सकती है.

लेटेंसी डैशबोर्ड के बारे में ज़्यादा जानें

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

इंतज़ार के समय का पेज

लेटेंसी डैशबोर्ड चुनने पर, ये मैट्रिक्स डिफ़ॉल्ट रूप से दिखती हैं:

  • प्रॉक्सी बनाम समय (ज़्यादा से ज़्यादा समय, मिलीसेकंड में)
  • प्रॉक्सी बनाम कुल इंतज़ार का समय (ज़्यादा से ज़्यादा इंतज़ार का समय, मिलीसेकंड में)
  • प्रॉक्सी बनाम सभी टारगेट के लिए इंतज़ार का समय (ज़्यादा से ज़्यादा इंतज़ार का समय, मिलीसेकंड में)

टारगेट लेटेंसी देखने के लिए, प्रॉक्सी ड्रॉप-डाउन बॉक्स का इस्तेमाल करके टारगेट चुनें.

डिफ़ॉल्ट रूप से, लेटेन्सी डैशबोर्ड में उन 10 प्रॉक्सी की जानकारी दिखती है जिनकी पिछले घंटे की कुल P99 लेटेन्सी सबसे ज़्यादा है. इसके अलावा, किसी प्रॉक्सी या कलेक्शन को चुनने के लिए, टॉप 10 ड्रॉप-डाउन बॉक्स का इस्तेमाल करें.

लेटेंसी डैशबोर्ड में, स्टेटस कोड डैशबोर्ड की सभी सुविधाएं मौजूद हैं. हालांकि, इनमें ये अंतर हैं:

  • आपको सिर्फ़ जवाब मिलने में लगने वाले कुल समय का पर्सेंटाइल (p50, p90, p95, p99) कॉन्फ़िगर करना होता है.
  • लेटेंसी मेट्रिक के लिए, सिर्फ़ एक घंटे की विंडो चुनी जा सकती है.
  • फ़िल्टर में, क्षेत्र के लिए कोई भी विकल्प नहीं चुना जा सकता. आपको जानकारी देखने के लिए कोई देश/इलाका चुनना होगा.

विलंबता मेट्रिक की जानकारी देखना

मैट्रिक्स में किसी मेट्रिक के ब्लॉक पर क्लिक करके, उसकी जानकारी देखें.

ब्लॉक चुनें

दाईं ओर मौजूद पैनल में, प्रॉक्सी (नीली लाइन) और टारगेट (बैंगनी लाइन) के लिए लेटेन्सी से जुड़ी जानकारी दिखाई जाती है. इसमें यह जानकारी शामिल होती है:

  • कुल लेटेंसी (प्रॉक्सी लेटेंसी और टारगेट लेटेंसी)
  • हर टारगेट के लिए इंतज़ार का समय (टारगेट के जवाब देने में लगने वाला समय)
  • एचटीटीपी स्टेटस के हिसाब से डिस्ट्रिब्यूशन

ज़्यादा जानकारी देखने के लिए, ग्राफ़ पर कर्सर घुमाएं:

विलंबता मेट्रिक व्यू

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

मेट्रिक की जानकारी से लॉग देखना

स्टेटस कोड या लेटेन्सी के लिए मेट्रिक की जानकारी देखते समय, चुनी गई मेट्रिक के सभी लॉग देखने के लिए, लॉग देखें पर क्लिक करें:

लॉग चुनें

'ट्रैफ़िक लॉग' डायलॉग बॉक्स खुलता है और इसमें ज़्यादा से ज़्यादा 1,000 लॉग एंट्री दिखती हैं. सूची में किसी लॉग एंट्री की ज़्यादा जानकारी देखने के लिए, उस पर क्लिक करें:

लॉग

लॉग को इनके हिसाब से फ़िल्टर किया जा सकता है:

  • ट्रैफ़िक सोर्स
  • गड़बड़ी का टाइप
  • जवाब मिलने में लगने वाला कम से कम समय

ट्रैफ़िक लॉग डायलॉग से, लॉग का डेटा डाउनलोड नहीं किया जा सकता. हालांकि, अपने डेटा का विश्लेषण करने के लिए, कस्टम रिपोर्ट बनाई जा सकती है या Analytics का डेटा डाउनलोड किया जा सकता है. इसके लिए, Google Cloud Storage या BigQuery जैसी अपनी डेटा रिपॉज़िटरी का इस्तेमाल करें.

'जांच करें' डैशबोर्ड से कस्टम रिपोर्ट बनाना

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

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

एक कस्टम रिपोर्ट बनाने के लिए:

  1. ज़्यादा जानकारी देखने के लिए, मैट्रिक्स में मौजूद किसी ब्लॉक पर क्लिक करें.

    ब्लॉक चुनें

  2. दाईं ओर मौजूद पैनल में, कस्टम रिपोर्ट बनाएं पर क्लिक करें.

    रिपोर्ट बनाएं

    कस्टम रिपोर्ट पेज, नए टैब में दिखता है. इसमें काम के फ़ील्ड में पहले से जानकारी भरी होती है.

    ध्यान दें: कस्टम रिपोर्ट की डिफ़ॉल्ट सेटिंग के बारे में ज़्यादा जानने के लिए, कस्टम रिपोर्ट बनाना लेख पढ़ें.

    रिपोर्ट में बदलाव करें

  3. ज़रूरत के मुताबिक, कस्टम रिपोर्ट में बदलाव करें. कस्टम रिपोर्ट मैनेज करना लेख पढ़ें.

  4. कस्टम रिपोर्ट सेव करने के लिए, सेव करें पर क्लिक करें.

रिपोर्ट को डिफ़ॉल्ट रूप से, पिछले एक घंटे में इकट्ठा किए गए डेटा का इस्तेमाल करके जनरेट किया जाता है. साथ ही, डेटा को कस्टम रिपोर्ट के डैशबोर्ड में दिखाया जाता है. कस्टम रिपोर्ट डैशबोर्ड एक्सप्लोर करना लेख पढ़ें.

रिपोर्ट पेज पर, एपीआई मॉनिटरिंग का इस्तेमाल करके जनरेट की गई कस्टम रिपोर्ट के नाम इस फ़ॉर्मैट में होते हैं: API Monitoring Investigate Generated.

किसी खास सूचना की जांच करना

किसी सूचना की जांच करने के लिए, सूचना का इतिहास पेज पर सूचना का नाम चुनें. आपको 'जांच करें' डैशबोर्ड दिखेगा. ध्यान दें कि इसमें डैशबोर्ड के सबसे ऊपर एक ग्राफ़ दिया गया है. साथ ही, इसमें सिर्फ़ सूचना से जुड़ी जानकारी शामिल है:

चेतावनी की जांच करने वाला पेज

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

    प्लेबुक का लिंक

  • सूचना में बदलाव करने के लिए, सूचना मैनेज करें पर क्लिक करें.

  • कस्टम रिपोर्ट देखने के लिए, रिपोर्ट देखें पर क्लिक करें. यह विकल्प तब दिखता है, जब कोई रिपोर्ट उपलब्ध हो.

  • ज़रूरत के हिसाब से, पेज के अपने-आप रीफ़्रेश होने की सुविधा को चालू या बंद करें.