आपको Apigee Edge दस्तावेज़ दिख रहा है.
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है
इस पेज पर जाएं
Apigee X दस्तावेज़. जानकारी
यह विषय, आंकड़ों की मेट्रिक, डाइमेंशन, और फ़िल्टर के लिए रेफ़रंस है. ज़्यादा जानकारी के लिए इनका इस्तेमाल करके, एपीआई से जुड़े आंकड़ों की खास जानकारी देखें.
यह विषय, यूज़र इंटरफ़ेस (यूआई) में और आपकी ज़रूरत के हिसाब से मेट्रिक और डाइमेंशन के नाम दिखाता है ताकि एपीआई कॉल में उनका इस्तेमाल किया जा सके.
- कस्टम रिपोर्ट बनाते समय, आपको यूज़र इंटरफ़ेस (यूआई) के नाम दिखेंगे.
- मेट्रिक बनाते समय, एपीआई के खास नामों का इस्तेमाल करें. ऐसा करने के लिए, report की परिभाषा या रिपोर्ट की परिभाषा अपडेट करना.
मेट्रिक
नीचे एपीआई मेट्रिक की जानकारी दी गई है, जिसे कस्टम रिपोर्ट और मैनेजमेंट एपीआई कॉल में हासिल किया जा सकता है.
कस्टम रिपोर्ट का नाम | मैनेजमेंट एपीआई में इस्तेमाल करने के लिए नाम | फ़ंक्शन | ब्यौरा |
---|---|---|---|
प्रति सेकंड औसत लेन-देन | टीपीएस | कोई नहीं |
लेन-देन की औसत संख्या, यानी हर सेकंड में एपीआई प्रॉक्सी अनुरोध. ध्यान दें कि अगर आपके किसी अवधि में हुए लेन-देन की संख्या, हर लेन-देन की औसत संख्या अगर संख्या दो से छोटी है, तो यूज़र इंटरफ़ेस (यूआई) की कस्टम रिपोर्ट में सेकंड शून्य लग सकता है दशमलव स्थान. एपीआई सिंटैक्स: |
कैश मेमोरी हिट | cache_hit | कुल योग |
ऐसे सफल एपीआई अनुरोधों की संख्या जो टारगेट की गई सेवा से मिलने वाले रिस्पॉन्स में. एपीआई सिंटैक्स: |
L1 कैश एलिमेंट की संख्या | ax_cache_l1_count | औसत, मिनट, अधिकतम |
किसी दिए गए लेन-देन पर L1 (इन-मेमोरी) कैश में मौजूद एलिमेंट की संख्या दिखाता है
समयावधि. उदाहरण के लिए, अगर आपने दिन की पूरी अवधि के लिए एपीआई सिंटैक्स: |
नीति से जुड़ी गड़बड़ियां | policy_error | कुल योग |
किसी तय समयावधि के दौरान, नीति से जुड़ी गड़बड़ियों की कुल संख्या. आम तौर पर, नीति से जुड़ी गड़बड़ियां डिज़ाइन के आधार पर होती हैं. उदाहरण के लिए, 'एपीआई की पुष्टि करें' नीति के उल्लंघन से जुड़ी जानकारी अनुरोध में अमान्य एपीआई पासकोड पास किए जाने पर गड़बड़ी और स्पाइक गिरफ़्तारी से जुड़ी नीति अगर एपीआई कॉल की संख्या, नीति में बताई गई सीमा से ज़्यादा हो जाती है, तो गड़बड़ी होती है. तो इस मेट्रिक से, आपके एपीआई में समस्या वाली संभावित जगहों को ढूंढने में मदद मिलती है. उदाहरण के लिए, developer_app डाइमेंशन के हिसाब से ग्रुप किया गया, policy_error मेट्रिक, आपके कारोबार को खोजने में आपकी मदद कर सकता है यह कि किसी ऐप्लिकेशन के लिए, एपीआई पासकोड या OAuth टोकन की समयसीमा खत्म हो गई है; इसके अलावा, आपको लगता है कि किसी खास एपीआई प्रॉक्सी के ज़रिए कई तरह की Spike Arrest गड़बड़ियां हो रही हैं. इससे आपको पता चलता है कि प्रॉक्सी की अचानक ज़्यादा गिरफ़्तारी की सीमा, छुट्टियों के सीज़न में आने वाले ट्रैफ़िक में बढ़ोतरी के लिए ज़िम्मेदार नहीं है. Analytics में, नीति से जुड़ी गड़बड़ी को सिर्फ़ तब लॉग किया जाता है, जब गड़बड़ी की वजह से एपीआई प्रॉक्सी काम नहीं करता.
उदाहरण के लिए, अगर किसी नीति के गड़बड़ी पर नीति का नाम (ax_execution_fault_policy_name) डाइमेंशन इनके लिए काम का है नीति से जुड़ी गड़बड़ियों को नीति के नाम के हिसाब से ग्रुप में बांटें. टारगेट न होने की गड़बड़ी (जैसे कि 404 या 503) को नीति से जुड़ी गड़बड़ी के तौर पर नहीं गिना जाता. वे को एपीआई प्रॉक्सी फ़ेलियर (is_error) के तौर पर गिना जाएगा. एपीआई सिंटैक्स: |
प्रॉक्सी गड़बड़ियां | is_error | कुल योग |
तय समयावधि में एपीआई प्रॉक्सी के काम न करने की कुल संख्या. प्रॉक्सी तब भी हो सकती है, जब कोई नीति काम न करे या जब रनटाइम फ़ेल हो जाए, जैसे कि 404 या टारगेट सेवा से 503 कोड मिला हो. प्रॉक्सी (apiप्रॉक्सी) डाइमेंशन, प्रॉक्सी के ज़रिए एपीआई प्रॉक्सी विफलताओं को ग्रुप करने के लिए काम का है. एपीआई सिंटैक्स: |
अनुरोध को प्रोसेस करने में लगने वाले समय का अंतर | request_processing_latency | औसत, मिनट, अधिकतम |
समय (औसत, कम से कम या ज़्यादा से ज़्यादा), मिलीसेकंड में, आने वाले अनुरोधों को प्रोसेस करने में एज की ज़रूरत होती है. अनुरोध के पूरा होने का समय एज और एज, अनुरोध को टारगेट की गई सेवा पर भेजने के बाद ही खत्म होते हैं. अलग-अलग डाइमेंशन का इस्तेमाल करके, एपीआई प्रॉक्सी की मदद से अनुरोध प्रोसेस होने में लगने वाले समय की जांच की जा सकती है. डेवलपर ऐप्लिकेशन, क्षेत्र वगैरह. एपीआई सिंटैक्स: |
अनुरोध का साइज़ | request_size | योग, औसत, कम, अधिकतम |
Edge को मिलने वाले अनुरोध पेलोड का साइज़, बाइट में. एपीआई सिंटैक्स: |
रिस्पॉन्स कैश मेमोरी एक्ज़ीक्यूट की गई | ax_cache_executed | कुल योग |
दिए गए समय में रिस्पॉन्स कैश नीति को लागू किए जाने की कुल संख्या अवधि के लिए मान्य है. चूंकि रिस्पॉन्स कैश नीति API प्रॉक्सी में दो जगहों पर जुड़ी होती है (एक बार में अनुरोध और एक बार जवाब में), यह आम तौर पर एपीआई कॉल में दो बार काम करता है. कैश मेमोरी 'पाएं' और एक कैश 'पुट' हर एक को एक एक्ज़ीक्यूशन के तौर पर गिना जाता है. हालांकि, रिस्पॉन्स कैश मेमोरी को एक्ज़ीक्यूट नहीं किया जा सकता, अगर
ट्रेस टूल में,
किए गए एपीआई कॉल में रिस्पॉन्स कैश आइकॉन पर क्लिक करके,
एपीआई सिंटैक्स: |
जवाब प्रोसेस होने में लगने वाला समय | response_processing_latency | औसत, मिनट, अधिकतम |
समय (औसत, कम से कम या ज़्यादा से ज़्यादा), मिलीसेकंड में, कि एपीआई से मिले जवाबों को प्रोसेस करने में Edge की ज़रूरत होती है. एपीआई प्रॉक्सी को मिलने का समय शुरू होता है टारगेट सेवा का रिस्पॉन्स मिलता है. यह तब खत्म होता है, जब Apigee, ओरिजनल जवाब को भेजता है कॉलर है. अलग-अलग डाइमेंशन का इस्तेमाल करके, एपीआई के हिसाब से रिस्पॉन्स को प्रोसेस करने में लगने वाले समय की जांच की जा सकती है प्रॉक्सी, क्षेत्र वगैरह. एपीआई सिंटैक्स: |
रिस्पॉन्स का साइज़ | response_size | योग, औसत, कम, अधिकतम |
क्लाइंट को लौटाए गए रिस्पॉन्स पेलोड का साइज़ बाइट में सबमिट कर सकते हैं. एपीआई सिंटैक्स: |
टारगेट से जुड़ी गड़बड़ियां | target_error | कुल योग |
टारगेट की गई सेवा से मिले 5xx जवाबों की कुल संख्या. ये टारगेट की गई सेवाएं हैं ये गड़बड़ियां Apigee की वजह से नहीं हुई हैं. एपीआई सिंटैक्स: |
जवाब देने का टारगेट समय | target_response_time | योग, औसत, कम, अधिकतम |
समय की मात्रा (योग, औसत, कम से कम या ज़्यादा से ज़्यादा) मिलीसेकंड, टारगेट सर्वर किसी कॉल का जवाब देने के लिए. इस मेट्रिक में आपको बताती है कि टारगेट सर्वर कैसा परफ़ॉर्म कर रहे हैं. वह समय जब Edge किसी अनुरोध को फ़ॉरवर्ड करता है को टारगेट की जाती है. जब एज को जवाब मिलता है, तब यह सेवा बंद हो जाती है. ध्यान दें कि अगर एपीआई कॉल, कैश मेमोरी से जवाब देता है (रिस्पॉन्स कैश का इस्तेमाल करके) उदाहरण के लिए, नीति से जुड़ा है), तो कॉल कभी भी टारगेट सेवा तक नहीं पहुंचेगा और कोई टारगेट नहीं होगा जवाब देने में लगने वाले समय की मेट्रिक लॉग की जाती हैं. एपीआई सिंटैक्स: |
जवाब देने में लगने वाला कुल समय | total_response_time | योग, औसत, कम, अधिकतम |
समय की मात्रा (योग, औसत, कम से कम या ज़्यादा से ज़्यादा) मिलीसेकंड, जब Edge को क्लाइंट से अनुरोध मिलता है और जब Edge, क्लाइंट को जवाब वापस भेजता है. समय में नेटवर्क ओवरहेड शामिल होता है (जैसे लोड बैलेंसर और राऊटर को अपना काम करने में लगने वाला समय, प्रोसेसिंग के लिए अनुरोध करें इंतज़ार का समय, जवाब प्रोसेस होने में लगने वाला समय, और जवाब देने में लगने वाला टारगेट समय (अगर जवाब दिया जाता है को कैश मेमोरी में सेव करता है. अलग-अलग डाइमेंशन का इस्तेमाल करके, एपीआई प्रॉक्सी के ज़रिए डेटा प्रोसेस होने में लगने वाले समय की जांच की जा सकती है. डेवलपर ऐप्लिकेशन, क्षेत्र वगैरह. एपीआई सिंटैक्स: |
ट्रैफ़िक | message_count | कुल योग |
किसी तय समयावधि में Edge से प्रोसेस किए गए एपीआई कॉल की कुल संख्या. डाइमेंशन का इस्तेमाल करके, ट्रैफ़िक की गिनती को उन तरीकों से ग्रुप करें जो आपके लिए सबसे ज़्यादा मायने रखते हों. एपीआई सिंटैक्स: |
डाइमेंशन
डाइमेंशन की मदद से, काम के ग्रुप में मेट्रिक देखी जा सकती हैं. उदाहरण के लिए, कुल ट्रैफ़िक जब आप हर डेवलपर ऐप्लिकेशन या एपीआई प्रॉक्सी के लिए काउंट को देखते हैं, तो यह और ज़्यादा असरदार हो जाता है.
Apigee से मिलने वाले ये डाइमेंशन यहां दिए गए हैं. इसके अतिरिक्त, आप अपना अपने डाइमेंशन भी शामिल करने होंगे, जैसा कि कस्टम ऐनलिटिक्स का इस्तेमाल करके एपीआई मैसेज के कॉन्टेंट का विश्लेषण करना लेख में बताया गया है.
कस्टम रिपोर्ट का नाम | मैनेजमेंट एपीआई में इस्तेमाल करने के लिए नाम | ब्यौरा |
---|---|---|
Apigee इकाइयां | ||
ऐक्सेस टोकन | access_token | ऐप्लिकेशन के असली उपयोगकर्ता का OAuth ऐक्सेस टोकन. |
एपीआई प्रॉडक्ट | api_product |
उस एपीआई प्रॉडक्ट का नाम जिसमें एपीआई प्रॉक्सी को कॉल किया जा रहा है. पाने के लिए इस डाइमेंशन में, कॉल करने वाले डेवलपर ऐप्लिकेशन को एक या उससे ज़्यादा एपीआई से जोड़ा जाना चाहिए जिन प्रॉडक्ट में एपीआई प्रॉक्सी शामिल हैं और जिन्हें कॉल किया जा रहा है उन्हें एपीआई की जांच करनी होगी कुंजी या OAuth टोकन एपीआई कॉल के साथ भेजा गया. कुंजी या टोकन किसी एपीआई से जुड़ा हुआ है प्रॉडक्ट. ज़्यादा जानकारी के लिए, यह देखें सबसे पहली बात: आंकड़ों का पूरा डेटा जनरेट करने का तरीका. अगर ऊपर दी गई शर्तें पूरी नहीं होती हैं, तो आपको "(not set)" वैल्यू दिखेगी. यह भी देखें Analytics इकाई की वैल्यू "(not set)" का क्या मतलब है का मतलब है?. |
कैश कुंजी | ax_cache_key |
इस पासकोड में, रिस्पॉन्स कैश की वह वैल्यू मौजूद है जिसे ऐक्सेस किया गया था. अगर आपको ज़्यादा जानकारी चाहिए, तो रिस्पॉन्स कैश के लिए पासकोड बनाने का तरीका जानने के लिए, रिस्पॉन्स कैश मेमोरी से जुड़ी नीति देखें. ट्रेस टूल में,
जब कैश मेमोरी में सेव की गई रिस्पॉन्स कैश नीति चुनी जाती है, तो आपको
इस वैल्यू को |
कैश मेमोरी का नाम | ax_cache_name |
रिस्पॉन्स कैश से जुड़ी नीति में इस्तेमाल की जाने वाली कुंजियों/वैल्यू वाली कैश मेमोरी का नाम, इसके पहले orgName__envName__ का इस्तेमाल करें. उदाहरण के लिए, अगर संगठन "foo" है, यह एनवायरमेंट "टेस्ट" है, और कैश का नाम "myकैश" है, ax_cache_name है foo__test__myCache. ट्रेस टूल में,
रिस्पॉन्स कैश की नीति चुनने पर, यह वैल्यू
|
कैश सोर्स | ax_cache_source |
वह कैश लेवल ("L1" इन-मेमोरी या "L2" डेटाबेस) जिससे रिस्पॉन्स कैश था वापस लाया गया. यह डाइमेंशन "CACHE_MISS" भी दिखाता है जब से जवाब भेजा गया था कैश के बजाय टारगेट किया गया हो और टारगेट रिस्पॉन्स के साथ रिस्पॉन्स कैश को रीफ़्रेश किया गया हो; या जब अनुरोध में मौजूद कैश कुंजी अमान्य हो. कैश मेमोरी सिर्फ़ इन कुंजियों के लिए ही इस्तेमाल की जा सकती है साइज़ में 2 केबी. ट्रेस टूल में,
रिस्पॉन्स कैश नीति चुनने पर, यह वैल्यू
कैश मेमोरी के लेवल के बारे में ज़्यादा जानकारी के लिए, कैश मेमोरी में सेव की जाने वाली फ़ाइलों को देखें. |
Client ID | client_id |
एपीआई कॉल करने वाले डेवलपर ऐप्लिकेशन की उपभोक्ता कुंजी (एपीआई पासकोड), भले ही वह पास हो गई हो अनुरोध में एपीआई पासकोड के तौर पर या OAuth टोकन में शामिल किया गया है. इस डाइमेंशन को पाने के लिए, कॉल पाने वाली प्रॉक्सी को कॉन्फ़िगर करना ज़रूरी है, ताकि यह जांच की जा सके ताकि एपीआई पासकोड या OAuth टोकन का इस्तेमाल किया जा सके. डेवलपर ऐप्लिकेशन को एपीआई पासकोड मिलते हैं. इनका इस्तेमाल इन कामों के लिए किया जा सकता है उपयोगकर्ता के Edge पर ऐप्लिकेशन रजिस्टर होने पर, OAuth टोकन जनरेट किया जा सकता है. ज़्यादा जानकारी के लिए, यह देखें सबसे पहली बात: आंकड़ों का पूरा डेटा जनरेट करने का तरीका. अगर ऊपर दी गई शर्तें पूरी नहीं होती हैं, तो आपको "(not set)" वैल्यू दिखेगी. यह भी देखें कि Analytics इकाई की वैल्यू "(not set)" क्या होती है का मतलब है?. |
डेवलपर ऐप्लिकेशन | developer_app |
Edge के लिए रजिस्टर किया गया डेवलपर ऐप्लिकेशन, जो एपीआई कॉल करता है. इस डाइमेंशन को पाने के लिए, ऐप्लिकेशन का एक या ज़्यादा एपीआई प्रॉडक्ट से जुड़ा होना ज़रूरी है जिनमें कॉल की जा रही API प्रॉक्सी शामिल हों और प्रॉक्सी को किसी API कुंजी की जाँच करनी चाहिए या एपीआई कॉल के साथ OAuth टोकन भेजा गया. कुंजी या टोकन से डेवलपर ऐप्लिकेशन की पहचान होती है. इसके लिए ज़्यादा जानकारी के लिए, सबसे पहले ज़रूरी जानकारी: आंकड़ों का पूरा डेटा जनरेट करने का तरीका देखें. अगर ऊपर दी गई शर्तें पूरी नहीं होती हैं, तो आपको "(not set)" वैल्यू दिखेगी. यह भी देखें कि Analytics इकाई की वैल्यू "(not set)" क्या होती है का मतलब है?. |
डेवलपर का ईमेल | developer_email |
Edge पर रजिस्टर करने वाले उन डेवलपर का ईमेल पता जिनके ऐप्लिकेशन ने एपीआई कॉल किए थे. इस डाइमेंशन को पाने के लिए, डेवलपर के पास एक या उससे ज़्यादा ऐप्लिकेशन से जुड़े ऐप्लिकेशन होने चाहिए ऐसे एपीआई प्रॉडक्ट जिनमें कॉल की जा रही एपीआई प्रॉक्सी शामिल हैं और प्रॉक्सी को एपीआई कॉल के साथ एपीआई पासकोड या OAuth टोकन भेजा गया. कुंजी या टोकन से डेवलपर की पहचान की जाती है है. ज़्यादा जानकारी के लिए, सबसे पहले ज़रूरी जानकारी: आंकड़ों का पूरा डेटा जनरेट करने का तरीका लेख पढ़ें. अगर ऊपर दी गई शर्तें पूरी नहीं होती हैं, तो आपको "(not set)" वैल्यू दिखेगी. यह भी देखें कि Analytics इकाई की वैल्यू "(not set)" क्या होती है का मतलब है?. |
डेवलपर आईडी | डेवलपर |
एज से जनरेट किया गया यूनीक डेवलपर आईडी: org_name@@@unique_id. इस डाइमेंशन को पाने के लिए, डेवलपर के पास एक या उससे ज़्यादा ऐप्लिकेशन से जुड़े ऐप्लिकेशन होने चाहिए जिन एपीआई प्रॉडक्ट को कॉल किया जा रहा है उनमें मौजूद एपीआई प्रॉक्सी को कॉल किया जा रहा है. साथ ही, प्रॉक्सी को एपीआई कॉल के साथ भेजा गया एपीआई पासकोड या OAuth टोकन. कुंजी या टोकन डेवलपर. ज़्यादा जानकारी के लिए, सबसे पहले ज़रूरी जानकारी: आंकड़ों का पूरा डेटा जनरेट करने का तरीका लेख पढ़ें. अगर ऊपर दी गई शर्तें पूरी नहीं होती हैं, तो आपको "(not set)" वैल्यू दिखेगी. यह भी देखें कि Analytics इकाई की वैल्यू "(not set)" क्या होती है का मतलब है?. |
परिवेश | वातावरण | वह Edge एनवायरमेंट जिसमें एपीआई प्रॉक्सी डिप्लॉय की जाती हैं. उदाहरण के लिए, "test" या "प्रोडक्शन". |
गड़बड़ी होने पर गड़बड़ी कोड | ax_edge_execution_fault_code |
गड़बड़ी का गलत कोड. जैसे:
|
फ़्लो के नाम में गड़बड़ी हुई | ax_execution_fault _flow_name |
एपीआई प्रॉक्सी में दिया गया flow नाम, जिसकी वजह से गड़बड़ी हुई है. उदाहरण के लिए, "PreFlow," "पोस्टफ़्लो," या आपके बनाए गए कंडिशनल फ़्लो का नाम. ध्यान दें कि मैनेजमेंट एपीआई में इस्तेमाल करने के लिए पूरा नाम ax_execution_fault_flow_name है, वह भी बिना लाइन ब्रेक के. जहां कोई गड़बड़ी नहीं हुई, आपको "(not set)" वैल्यू दिखेगी. |
फ़्लो रिसॉर्स | flow_resource | सिर्फ़ Apigee का इस्तेमाल किया जा सकता है. अगर आपको इसके बारे में जानना है, तो यह कम्यूनिटी पोस्ट देखें. |
गड़बड़ी की सूचना मिलने पर फ़्लो स्टेट | ax_execution_fault _flow_state |
एपीआई प्रॉक्सी फ़्लो का नाम बताता है कि गड़बड़ियां बढ़ाई गई हैं, जैसे कि "PROXY_REQ_FLOW" या "TARGET_RESP_FLOW." ध्यान दें कि मैनेजमेंट एपीआई में इस्तेमाल किया जाने वाला पूरा नाम ax_execution_fault_flow_state है, वह भी बिना लाइन ब्रेक के. |
गेटवे फ़्लो आईडी | gateway_flow_id | Edge पर एपीआई कॉल आने पर, हर कॉल को अपना गेटवे फ़्लो आईडी मिलता है. उदाहरणः rrt329ea-12575-114653952-1. गेटवे फ़्लो आईडी की मदद से, मेट्रिक में अंतर किया जा सकता है हाई-टीपीएस स्थितियां, जिनमें दूसरे डाइमेंशन, जैसे कि संगठन, एनवायरमेंट, और टाइमस्टैंप सभी कॉल में एक जैसे हैं. |
संगठन | संगठन | Edge संगठन, जिसमें एपीआई प्रॉक्सी डिप्लॉय की गई हैं. |
गड़बड़ी पर नीति का नाम | ax_execution_fault _policy_name |
उस नीति का नाम जिसकी वजह से गड़बड़ी हुई और एपीआई कॉल पूरा नहीं हो सका. ध्यान दें कि मैनेजमेंट एपीआई में इस्तेमाल करने के लिए पूरा नाम ax_execution_fault_policy_name है, वह भी बिना लाइन ब्रेक के. अगर किसी नीति के तहत कोई गड़बड़ी होती है, लेकिन नीति का रूट एट्रिब्यूट |
प्रॉक्सी | एपीआई प्रॉक्सी | किसी एपीआई प्रॉक्सी की मशीन का नाम (न कि डिसप्ले नेम). |
प्रॉक्सी बेस पाथ | proxy_basepath |
एपीआई प्रॉक्सी ProxyEndpoint पर कॉन्फ़िगर किया गया BasePath. बेस पाथ में यह शामिल नहीं होता एपीआई प्रॉक्सी यूआरएल का डोमेन और पोर्ट हिस्सा. उदाहरण के लिए, अगर एपीआई प्रॉक्सी का बेस यूआरएल यह होता है https://apigeedocs-test.apigee.net/releasenotes/, इसका बेस पाथ /releasenotes है. वैल्यू को |
प्रॉक्सी पाथ का सफ़िक्स | proxy_pathsuffix |
एपीआई प्रॉक्सी बेस पाथ में संसाधन पाथ जोड़ा गया. उदाहरण के लिए, यदि किसी API प्रॉक्सी का
बेस यूआरएल अगर किसी पाथफ़ीक्स का इस्तेमाल नहीं किया गया है, तो वैल्यू खाली होती है. वैल्यू को |
प्रॉक्सी संशोधन | apiproxy_revision | एपीआई कॉल को मैनेज करने वाले एपीआई प्रॉक्सी की बदली गई संख्या. ऐसा ज़रूरी नहीं है का मतलब किसी API प्रॉक्सी का नवीनतम संशोधन है. अगर किसी एपीआई प्रॉक्सी में 10 बार बदलाव किए गए हैं, तो फ़िलहाल, बदलाव का डिप्लॉयमेंट किया जा सकता है. इसके अलावा, एक एपीआई में कई संशोधन इस रूप में भी लागू किए जा सकते हैं अगर बदलावों में अलग-अलग बेस पाथ हों, जैसा कि यूज़र इंटरफ़ेस (यूआई) में प्रॉक्सी डिप्लॉय करना लेख में बताया गया है. |
समाधान किया गया क्लाइंट IP | ax_resolved_client_ip |
इसमें ओरिजनल क्लाइंट आईपी पता शामिल होता है. ध्यान दें कि क्लाइंट के सही आईपी पतों को कैप्चर करने के लिए, Akamai जैसे प्रॉडक्ट का इस्तेमाल करते समय,
क्लाइंट आईपी को एचटीटीपी हेडर
|
जवाब की स्थिति का कोड | response_status_code | Apigee से क्लाइंट को फ़ॉरवर्ड किया गया एचटीटीपी रिस्पॉन्स स्टेटस कोड, जैसे कि 200, 404, 503 वगैरह के हिसाब से. Edge में, टारगेट के रिस्पॉन्स स्टेटस कोड को इससे बदला जा सकता है मैसेज असाइन करें और समस्या ठीक करें जैसी नीतियों के तहत, इसलिए, यह डाइमेंशन टारगेट रिस्पॉन्स कोड (target_response_code) से अलग हो सकता है. |
वर्चुअल होस्ट | virtual_host | वर्चुअल होस्ट का नाम
एपीआई कॉल किया गया था. उदाहरण के लिए, संगठनों के पास दो
डिफ़ॉल्ट रूप से वर्चुअल होस्ट: default (http) और secure (https). |
इनबाउंड/क्लाइंट | ||
क्लाइंट का आईपी पता | client_ip | राऊटर से हिट करने वाले सिस्टम का आईपी पता, जैसे कि ओरिजनल क्लाइंट
(प्रॉक्सी_client_ip) या लोड बैलेंसर. जब खोज के नतीजों में कई आईपी होते हैं
X-Forwarded-For हेडर, यह सूची में शामिल आखिरी आईपी है. |
डिवाइस की कैटगरी | ax_ua_device_category | उस डिवाइस का टाइप जिससे एपीआई कॉल किया गया था, जैसे कि "टैबलेट" या "स्मार्टफ़ोन". |
ओएस की कैटगरी | ax_ua_os_family | कॉल करने वाले डिवाइस का ऑपरेटिंग सिस्टम फ़ैमिली, जैसे कि "Android" या "iOS". |
OS वर्शन | ax_ua_os_version |
कॉल करने वाले डिवाइस के ऑपरेटिंग सिस्टम का वर्शन. इसे दूसरे "ड्रिल-डाउन" के तौर पर इस्तेमाल करना मददगार होता है ओएस फ़ैमिली के साथ डाइमेंशन (ax_ua_os_family) पर क्लिक करके ऑपरेटिंग सिस्टम के वर्शन देखें. |
प्रॉक्सी क्लाइंट IP | proxy_client_ip |
कॉल करने वाले क्लाइंट का आईपी पता, |
रेफ़र किया गया क्लाइंट आईपी | ax_true_client_ip | क्लाइंट के सही IP पते कैप्चर करने के लिए Akamai जैसे प्रॉडक्ट का उपयोग करते समय,
क्लाइंट आईपी, एचटीटीपी हेडर ओरिजनल क्लाइंट का आईपी पता तय करने के लिए, |
अनुरोध का पाथ | request_path |
टारगेट की जाने वाली सेवा के लिए संसाधन पाथ (इसमें डोमेन शामिल नहीं है), लेकिन क्वेरी को छोड़कर पैरामीटर का इस्तेमाल करें. उदाहरण के लिए, Apigee सैंपल टारगेट |
अनुरोध URI | request_uri |
टारगेट की जाने वाली सेवा का संसाधन पाथ (इसमें डोमेन शामिल नहीं है), जिसमें क्वेरी भी शामिल है पैरामीटर का इस्तेमाल करें. उदाहरण के लिए, Apigee सैंपल टारगेट |
अनुरोध क्रिया | request_verb | एपीआई अनुरोधों में एचटीटीपी अनुरोध की क्रिया, जैसे कि GET, POST, PUT, DELETE. |
उपयोगकर्ता एजेंट | useragent |
एपीआई कॉल करने के लिए इस्तेमाल किए जाने वाले उपयोगकर्ता एजेंट या सॉफ़्टवेयर एजेंट का नाम. उदाहरण:
|
उपयोगकर्ता एजेंट फ़ैमिली | ax_ua_agent_family | उपयोगकर्ता एजेंट का परिवार, जैसे कि "Chrome मोबाइल" या "cURL" शामिल है. |
उपयोगकर्ता एजेंट का टाइप | ax_ua_agent_type | उपयोगकर्ता एजेंट का टाइप, जैसे कि "ब्राउज़र," "मोबाइल ब्राउज़र" "लाइब्रेरी," वगैरह. |
उपयोगकर्ता एजेंट का वर्शन | ax_ua_agent_version |
उपयोगकर्ता एजेंट का वर्शन. इसे दूसरे "ड्रिल-डाउन" के तौर पर इस्तेमाल करना मददगार होता है उपयोगकर्ता एजेंट फ़ैमिली के साथ डाइमेंशन (ax_ua_agent_family) पर जाएं. |
आउटबाउंड/टारगेट | ||
टारगेट बेस पाथ | target_basepath |
टारगेट की जाने वाली सेवा के लिए संसाधन पाथ (इसमें डोमेन शामिल नहीं है), लेकिन क्वेरी को छोड़कर
पैरामीटर, जो प्रॉक्सी के उदाहरण के लिए, मान लें कि कोई एपीआई प्रॉक्सी नीचे दिए गए टारगेट को कॉल करता है: <TargetEndpoint name="default"> ... <HTTPTargetConnection> <URL>http://mocktarget.apigee.net/user?user=Dude</URL> </HTTPTargetConnection> इस उदाहरण में, target_basepath अगर टारगेट यह होता: <TargetEndpoint name="default"> ... <HTTPTargetConnection> <URL>http://mocktarget.apigee.net</URL> </HTTPTargetConnection> target_basepath शून्य होगा. ट्रेस टूल में, जब
फ़्लो डायग्राम के आखिर में मौजूद AX आइकॉन चुनें,
|
टारगेट होस्ट | target_host | टारगेट की गई सेवा का होस्ट. उदाहरण के लिए, अगर कोई एपीआई प्रॉक्सी
http://mocktarget.apigee.net/help , target_host है
mocktarget.apigee.net . |
टारगेट आईपी पता | target_ip | टारगेट सेवा का आईपी पता, जो एपीआई प्रॉक्सी को रिस्पॉन्स देता है. |
टारगेट रिस्पॉन्स कोड | target_response_code |
टारगेट सेवा की ओर से एपीआई प्रॉक्सी को दिया गया एचटीटीपी रिस्पॉन्स स्टेटस कोड, जैसे कि 200, 404, 503 वगैरह. "शून्य" का मान इसका मतलब है कि अनुरोध टारगेट सेवा तक कभी नहीं पहुंचा. ऐसा तब होता है, जब रिस्पॉन्स कैश मेमोरी की नीति के तहत या अनुरोध पूरा न होने पर, रिस्पॉन्स भेजा जाता है प्रोसेस चल रही है. यह जवाब के स्टेटस कोड से अलग है (response_status_code) डाइमेंशन के तौर पर दिखता है. |
लक्ष्य URL | target_url |
टारगेट सेवा का पूरा यूआरएल, जिसे एपीआई प्रॉक्सी के TargetEndpoint में बताया गया है. <TargetEndpoint name="default"> ... <HTTPTargetConnection> <URL>http://mocktarget.apigee.net/user?user=Dude</URL> </HTTPTargetConnection> इस उदाहरण में, target_url है
ध्यान दें कि एपीआई प्रॉक्सी प्रोसेसिंग के दौरान, यूआरएल को
प्रॉक्सी में चेन बनाना और स्क्रिप्ट का इस्तेमाल करते समय टारगेट (Node.js) हैं, तो कॉलिंग प्रॉक्सी में target_url खाली है. |
इसके लिए X फ़ॉरवर्ड किया गया | x_forwarded_for_ip |
ओरिजनल क्लाइंट का आईपी पता तय करने के लिए, |
समय | ||
हफ़्ते का दिन | ax_day_of_week | हफ़्ते के संक्षिप्त नाम का तीन अक्षर वाला दिन, जिस पर एपीआई कॉल किए गए थे. इसके लिए उदाहरण के लिए, सोमवार, मंगलवार, बुधवार. |
महीना | ax_month_of_year | वह संख्या जिसमें एपीआई कॉल किए गए थे. उदाहरण के लिए, "03" मार्च महीने के लिए. |
दिन का समय | ax_hour_of_day |
यह डेटा 24 घंटे की समयावधि के आधार पर सेट किया जाता है. इसमें दो अंकों का वह घंटा होता है जिसमें एपीआई कॉल किए गए थे. उदाहरण के लिए, रात 10 बजे से 11 बजे के बीच किए गए एपीआई कॉल का समय ax_hour_of_day 22 होगा. समय की वैल्यू यूटीसी में दी गई है. |
समय क्षेत्र | ax_geo_timezone | एपीआई कॉल किए गए टाइम ज़ोन के सामान्य नाम, जैसे कि अमेरिका/New_York और यूरोप/डबलिन. |
महीने का हफ़्ता | ax_week_of_month | महीने का अंकों वाला हफ़्ता. उदाहरण के लिए, महीना, ax_week_of_month 3 है. |
जगह की जानकारी | ||
शहर | ax_geo_city | वह शहर जहां से एपीआई कॉल किए गए थे. |
महाद्वीप | ax_geo_continent | उस महाद्वीप का दो अक्षरों वाला कोड जहां से एपीआई कॉल किए गए थे. उदाहरण के लिए, उत्तरी अमेरिका के लिए उत्तरी अमेरिका में लागू. |
देश | ax_geo_country | उस देश का दो अक्षर वाला कोड जहां से एपीआई कॉल किए गए थे. उदाहरण के लिए, US संयुक्त राज्य अमेरिका के लिए. |
भौगोलिक इलाका | ax_geo_region | भौगोलिक क्षेत्र के लिए हाइफ़न वाला कोड, जैसे कि स्टेट-COUNTRY. उदाहरण के लिए, वॉशिंगटन-अमेरिका के लिए WA-US. |
क्षेत्र | ax_dn_region | उस Apigee डेटा सेंटर का नाम जहां एपीआई प्रॉक्सी डिप्लॉय किए जाते हैं, जैसे कि us-east-1. |
कमाई करना | ||
मिंट लेन-देन को अनदेखा करने का मैसेज | x_apigee_mint_tx_ignoreMessage | इस फ़्लैग से पता चलता है कि कमाई करने से जुड़े मैसेज को अनदेखा करना है या नहीं. कमाई करने वाले सभी संगठनों के लिए, false पर सेट किया गया है. |
मिंट लेन-देन की स्थिति | x_apigee_mint_tx_status | कमाई करने के अनुरोध की स्थिति, जैसे कि सफल, पूरा नहीं हो सका, अमान्य या कोई नहीं. |
फ़िल्टर
फ़िल्टर की मदद से, खास विशेषताओं वाले मेट्रिक के हिसाब से नतीजों को सीमित किया जा सकता है. यहां कुछ उदाहरण दिए गए हैं सैंपल फ़िल्टर. फ़िल्टर तय करते समय, मेट्रिक और डाइमेंशन एपीआई-स्टाइल के नामों का इस्तेमाल करें.
नाम वाली किताबों या संगीत वाली एपीआई प्रॉक्सी के लिए मेट्रिक दिखाता है:
filter=(apiproxy in 'books','music')
"m" से शुरू होने वाले नामों वाली API प्रॉक्सी के लिए मेट्रिक लौटाता है:
filter=(apiproxy like 'm%')
यह फ़ंक्शन "m" से शुरू नहीं होने वाले नामों वाली एपीआई प्रॉक्सी की मेट्रिक दिखाता है:
filter=(apiproxy not like 'm%')
यह फ़ंक्शन एपीआई कॉल के लिए, 400 से 599 के बीच के रिस्पॉन्स स्टेटस कोड वाली मेट्रिक दिखाता है:
filter=(response_status_code ge 400 and response_status_code le 599)
यह फ़ंक्शन एपीआई कॉल के लिए मेट्रिक दिखाता है. इनमें रिस्पॉन्स स्टेटस कोड 200 और टारगेट रिस्पॉन्स कोड होता है 404:
filter=(response_status_code eq 200 and target_response_code eq 404)
यह फ़ंक्शन एपीआई कॉल के लिए, 500 रिस्पॉन्स स्टेटस कोड के साथ मेट्रिक दिखाता है:
filter=(response_status_code eq 500)
उन एपीआई कॉल की मेट्रिक दिखाता है जिनकी वजह से गड़बड़ियां नहीं हुईं:
filter=(is_error eq 0)
रिपोर्ट फ़िल्टर बनाने के लिए, नीचे दिए गए ऑपरेटर इस्तेमाल किए जा सकते हैं.
ऑपरेटर | ब्यौरा |
---|---|
in |
सूची में शामिल करें |
notin |
सूची से बाहर रखें |
eq |
इसके बराबर है, == |
ne |
इसके बराबर नहीं, != |
gt |
इससे ज़्यादा, > |
lt |
< से कम |
ge |
>= से ज़्यादा या इसके बराबर |
le |
<= से कम या इसके बराबर |
like |
अगर स्ट्रिंग पैटर्न, दिए गए पैटर्न से मेल खाता है, तो 'सही' दिखाता है. |
not like |
अगर स्ट्रिंग पैटर्न, दिए गए पैटर्न से मेल खाता है, तो गलत जानकारी देता है. |
similar to |
इस फ़ंक्शन का पैटर्न, दी गई स्ट्रिंग से मेल खाता है या नहीं, इसके आधार पर 'सही' या 'गलत' दिखाता है. हां
like से मिलती-जुलती है, लेकिन यह एसक्यूएल स्टैंडर्ड के
रेगुलर एक्सप्रेशन की परिभाषा. |
not similar to |
इसका पैटर्न, दी गई स्ट्रिंग से मेल खाता है या नहीं, इसके आधार पर 'गलत' या 'सही' दिखाता है. हां
not like से मिलती-जुलती है. हालांकि, यह एसक्यूएल का इस्तेमाल करके पैटर्न को समझाता है
रेगुलर एक्सप्रेशन की स्टैंडर्ड परिभाषा. |
and |
आपको 'और' का इस्तेमाल करने देता है लॉजिक का इस्तेमाल करें. फ़िल्टर सभी शर्तों को पूरा करने वाला डेटा शामिल होता है. |
or |
आपको 'or' का इस्तेमाल करने देता है लॉजिक का इस्तेमाल करें. फ़िल्टर इसमें ऐसा डेटा शामिल होता है जो कम से कम एक शर्त को पूरा करता हो. |