Apigee Edge दस्तावेज़ देखा जा रहा है.
Apigee X दस्तावेज़ पर जाएं. जानकारी
इस विषय में, Analytics की मेट्रिक, डाइमेंशन, और फ़िल्टर का रेफ़रंस दिया गया है. इनका इस्तेमाल करने के बारे में ज़्यादा जानकारी के लिए, एपीआई के आंकड़ों की खास जानकारी देखें.
इस विषय में, मेट्रिक और डाइमेंशन के नाम उसी तरह दिखते हैं जैसे वे यूज़र इंटरफ़ेस (यूआई) में दिखते हैं. साथ ही, एपीआई कॉल में उनका इस्तेमाल करने की ज़रूरत होने पर उन्हें भी इस विषय में दिखाया जाता है.
- कस्टम रिपोर्ट बनाते समय आपको यूज़र इंटरफ़ेस (यूआई) के नाम दिखेंगे.
- मेट्रिक पाने, रिपोर्ट बनाने या रिपोर्ट की परिभाषा अपडेट करने के दौरान, एपीआई के हिसाब से दिए गए नामों का इस्तेमाल करें.
मेट्रिक
नीचे वे एपीआई मेट्रिक दिए गए हैं जिन्हें कस्टम रिपोर्ट और मैनेजमेंट एपीआई कॉल में हासिल किया जा सकता है.
कस्टम रिपोर्ट का नाम | मैनेजमेंट एपीआई में इस्तेमाल करने के लिए नाम | फ़ंक्शन | ब्यौरा |
---|---|---|---|
प्रति सेकंड औसत लेन-देन | टीपीएस | कभी नहीं |
हर सेकंड में हुए ट्रांज़ैक्शन की औसत संख्या, मतलब एपीआई प्रॉक्सी अनुरोध. ध्यान दें कि अगर इस समयावधि में आपके ट्रांज़ैक्शन की संख्या काफ़ी कम है, तो यूज़र इंटरफ़ेस (यूआई) की कस्टम रिपोर्ट में हर सेकंड पर हुए ट्रांज़ैक्शन की औसत संख्या शून्य दिख सकती है. ऐसा तब होगा, जब इनकी संख्या दशमलव के बाद के दो से कम हो. एपीआई सिंटैक्स: |
कैश हिट | cache_hit | योग |
ऐसे एपीआई अनुरोधों की संख्या जो टारगेट की गई सेवा से मिले रिस्पॉन्स के बजाय रिस्पॉन्स कैश का इस्तेमाल करते हैं. एपीआई सिंटैक्स: |
L1 कैश एलिमेंट की संख्या | ax_cache_l1_count | औसत, कम से कम, ज़्यादा से ज़्यादा |
किसी दी गई समयावधि में, हर लेन-देन के लिए L1 (इन-मेमोरी) कैश मेमोरी में मौजूद एलिमेंट की संख्या दिखाता है. उदाहरण के लिए, अगर किसी दिन की अवधि के लिए एपीआई सिंटैक्स: |
नीति से जुड़ी गड़बड़ियां | policy_error | योग |
किसी तय समयावधि के दौरान, नीति से जुड़ी गड़बड़ियों की कुल संख्या. नीति से जुड़ी गड़बड़ियां आम तौर पर डिज़ाइन के हिसाब से होती हैं. उदाहरण के लिए, 'एपीआई पासकोड की पुष्टि करें' नीति, अनुरोध में अमान्य एपीआई पासकोड पास किए जाने पर गड़बड़ी दिखाती है. साथ ही, अगर एपीआई कॉल की संख्या नीति में दी गई सीमा से ज़्यादा हो जाती है, तो स्पाइक अरेस्ट नीति के तहत गड़बड़ी की जानकारी दी जाती है. इसलिए, यह मेट्रिक आपके एपीआई में समस्या वाले संभावित स्पॉट का पता लगाने में मदद करती है. उदाहरण के लिए, developer_app डाइमेंशन के हिसाब से ग्रुप की गई policy_error मेट्रिक, यह पता लगाने में आपकी मदद कर सकती हैं कि किसी ऐप्लिकेशन के लिए, एपीआई पासकोड या OAuth टोकन की समयसीमा खत्म हो गई है. इसके अलावा, आपको यह भी दिख सकता है कि कोई खास एपीआई प्रॉक्सी बहुत सारी स्पाइक अररेस्ट गड़बड़ी दिखा रहा है. इससे आपको यह पता चल सकता है कि प्रॉक्सी की तेज़ी से होने वाली गिरफ़्तारी की सीमा से छुट्टियों के ट्रैफ़िक में बढ़ोतरी नहीं होती है. Analytics में नीति की गड़बड़ी सिर्फ़ तब लॉग इन की जाती है, जब गड़बड़ी की वजह से एपीआई प्रॉक्सी काम नहीं कर रहा हो.
उदाहरण के लिए, अगर किसी नीति का 'गड़बड़ी पर नीति का नाम' (ax_execution_fault_policy_name) डाइमेंशन, नीति के नाम के हिसाब से नीति की गड़बड़ियों को ग्रुप करने के लिए काम आता है. टारगेट पूरा न होने (जैसे कि 404 या 503) को नीति का उल्लंघन नहीं माना जाता. इन्हें एपीआई प्रॉक्सी की असफलताओं (is_error) के तौर पर गिना जाता है. एपीआई सिंटैक्स: |
प्रॉक्सी गड़बड़ियां | is_error | योग |
किसी तय समयावधि में, एपीआई प्रॉक्सी के फ़ेल होने की कुल संख्या. प्रॉक्सी तब नहीं हो सकता, जब कोई नीति काम नहीं करती या रनटाइम के दौरान कोई गड़बड़ी होती है. उदाहरण के लिए, टारगेट सेवा का 404 या 503. प्रॉक्सी (apiप्रॉक्सी) डाइमेंशन का इस्तेमाल, प्रॉक्सी सर्वर में एपीआई की असफलताओं को ग्रुप करने के लिए किया जा सकता है. एपीआई सिंटैक्स: |
अनुरोध को प्रोसेस करने में लगने वाला समय | request_processing_latency | औसत, कम से कम, ज़्यादा से ज़्यादा |
दिए गए अनुरोधों को प्रोसेस करने में, Edge को मिलीसेकंड में औसत, कम से कम या ज़्यादा से ज़्यादा समय (औसत, कम से कम या ज़्यादा से ज़्यादा) लग सकता है. यह समय तब शुरू होता है, जब अनुरोध Edge पर पहुंच जाता है और जब Edge, टारगेट सेवा को अनुरोध भेज देता है, खत्म हो जाता है. अलग-अलग डाइमेंशन का इस्तेमाल करके, एपीआई प्रॉक्सी, डेवलपर ऐप्लिकेशन, इलाके वगैरह के हिसाब से, अनुरोध प्रोसेस होने में लगने वाले समय की जांच की जा सकती है. एपीआई सिंटैक्स: |
अनुरोध का आकार | request_size | योग, औसत, कम से कम, अधिकतम |
Edge को मिले अनुरोध वाले पेलोड का साइज़, बाइट में. एपीआई सिंटैक्स: |
रिस्पॉन्स कैश मेमोरी का इस्तेमाल किया गया | ax_cache_executed | योग |
किसी खास समयावधि के दौरान, रिस्पॉन्स कैश मेमोरी की नीति को लागू किए जाने की कुल संख्या. रिस्पॉन्स कैश मेमोरी की नीति को एपीआई प्रॉक्सी में दो जगहों पर (अनुरोध में एक बार और रिस्पॉन्स में एक बार) अटैच किया जाता है. इसलिए, आम तौर पर यह एपीआई कॉल में दो बार एक्ज़ीक्यूट होती है. कैश मेमोरी में सेव किए गए डेटा को 'get' कहते हैं और कैश मेमोरी में मौजूद हर एक कैश मेमोरी को एक ही प्रोसेस के तौर पर गिना जाता है. हालांकि, अगर नीति में मौजूद ट्रेस टूल में,
चलाए गए एपीआई कॉल में रिस्पॉन्स कैश आइकॉन पर क्लिक किया जा सकता है. साथ ही,
एपीआई सिंटैक्स: |
जवाब प्रोसेस होने में लगने वाला समय | response_processing_latency | औसत, कम से कम, ज़्यादा से ज़्यादा |
एपीआई से मिले रिस्पॉन्स को प्रोसेस करने में, Edge को लगने वाला मिलीसेकंड में, औसतन, कम से कम या ज़्यादा से ज़्यादा समय. यह समय तब शुरू होता है, जब एपीआई प्रॉक्सी को टारगेट सेवा से रिस्पॉन्स मिलता है. यह तब खत्म होता है, जब Apigee, मूल कॉलर को जवाब देता है. अलग-अलग डाइमेंशन का इस्तेमाल करके, एपीआई प्रॉक्सी, इलाके वगैरह के हिसाब से रिस्पॉन्स प्रोसेस होने में लगने वाले समय की जांच की जा सकती है. एपीआई सिंटैक्स: |
जवाब का साइज़ | response_size | योग, औसत, कम से कम, अधिकतम |
क्लाइंट को वापस किए गए रिस्पॉन्स पेलोड का साइज़, बाइट में. एपीआई सिंटैक्स: |
टारगेट से जुड़ी गड़बड़ियां | target_error | योग |
टारगेट सेवा से मिले कुल 5xx रिस्पॉन्स. टारगेट सेवा से जुड़ी ये गड़बड़ियां हैं. ये Apigee की वजह से नहीं होती हैं. एपीआई सिंटैक्स: |
जवाब देने में लगने वाला टारगेट समय | target_response_time | योग, औसत, कम से कम, अधिकतम |
टारगेट सर्वर को किसी कॉल का जवाब देने में लगने वाला समय (कुल, औसत, कम से कम या ज़्यादा से ज़्यादा) मिलीसेकंड में. इस मेट्रिक से आपको पता चलता है कि टारगेट सर्वर कैसा परफ़ॉर्म कर रहे हैं. यह समय तब शुरू होता है, जब Edge, टारगेट की गई सेवा को अनुरोध भेजता है और 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" है, तो एनवायरमेंट "test" होगा और कैश मेमोरी का नाम "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 रजिस्टर किया गया डेवलपर ऐप्लिकेशन है जो एपीआई कॉल कर रहा है. यह डाइमेंशन पाने के लिए, ऐप्लिकेशन को एक या एक से ज़्यादा एपीआई प्रॉडक्ट से जोड़ना होगा. इनमें वे एपीआई प्रॉक्सी शामिल हैं जिन्हें कॉल किया जा रहा है. साथ ही, प्रॉक्सी को एपीआई कॉल के साथ भेजे गए एपीआई पासकोड या OAuth टोकन की जांच करनी होगी. कुंजी या टोकन, डेवलपर ऐप्लिकेशन की पहचान करता है. ज़्यादा जानकारी के लिए, सबसे पहले, बुनियादी बातें: आंकड़ों का पूरा डेटा कैसे जनरेट करें लेख देखें. अगर ऊपर दी गई शर्तें पूरी नहीं होती हैं, तो आपको "(not set)" वैल्यू दिखेगी. Analytics में मौजूद इकाई की वैल्यू "(not set)" का क्या मतलब होता है? भी देखें. |
डेवलपर का ईमेल | developer_email |
EDGE में रजिस्टर उन डेवलपर का ईमेल पता जिनके ऐप्लिकेशन ने एपीआई कॉल किए थे. यह डाइमेंशन पाने के लिए, डेवलपर के पास एक या एक से ज़्यादा एपीआई प्रॉडक्ट से जुड़े ऐप्लिकेशन होने चाहिए. इनमें, कॉल किए जा रहे एपीआई प्रॉक्सी शामिल होने चाहिए. साथ ही, प्रॉक्सी को एपीआई कॉल से भेजे गए एपीआई पासकोड या OAuth टोकन की जांच करनी होगी. कुंजी या टोकन से डेवलपर ऐप्लिकेशन की पहचान होती है. ज़्यादा जानकारी के लिए, सबसे ज़रूरी जानकारी: आंकड़ों का पूरा डेटा कैसे जनरेट करें लेख देखें. अगर ऊपर दी गई शर्तें पूरी नहीं होती हैं, तो आपको "(not set)" वैल्यू दिखेगी. Analytics में मौजूद इकाई की वैल्यू "(not set)" का क्या मतलब होता है? भी देखें. |
डेवलपर आईडी | डेवलपर |
org_name@@@unique_id के फ़ॉर्मैट में, Edge से जनरेट किया गया यूनीक डेवलपर आईडी. यह डाइमेंशन पाने के लिए, डेवलपर के पास एक या एक से ज़्यादा एपीआई प्रॉडक्ट से जुड़े ऐप्लिकेशन होने चाहिए. इनमें वे एपीआई प्रॉक्सी शामिल हैं जिन्हें कॉल किया जा रहा है. साथ ही, प्रॉक्सी को एपीआई कॉल के साथ भेजे गए एपीआई पासकोड या OAuth टोकन की जांच करनी होगी. कुंजी या टोकन से डेवलपर की पहचान होती है. ज़्यादा जानकारी के लिए, सबसे पहली बात: आंकड़ों का पूरा डेटा कैसे जनरेट करें लेख पढ़ें. अगर ऊपर दी गई शर्तें पूरी नहीं होती हैं, तो आपको "(not set)" वैल्यू दिखेगी. Analytics में मौजूद इकाई की वैल्यू "(not set)" का क्या मतलब होता है? भी देखें. |
एनवायरमेंट | वातावरण | एज एनवायरमेंट जिसमें एपीआई प्रॉक्सी डिप्लॉय की जाती हैं. उदाहरण के लिए, "test" या "prod". |
गड़बड़ी का कोड | ax_edge_execution_fault_code |
गड़बड़ी का गलत कोड. उदाहरण के लिए:
|
फ़्लो का नाम गड़बड़ी | ax_execution_fault _flow_name |
एपीआई प्रॉक्सी में नाम वाला flow, जिसकी वजह से गड़बड़ी हुई है. उदाहरण के लिए, "PreFlow", "PostFlow" या आपके बनाए गए कंडीशनल फ़्लो का नाम. ध्यान दें कि मैनेजमेंट एपीआई में इस्तेमाल किया जाने वाला पूरा नाम 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. गेटवे फ़्लो आईडी, हाई-TPS स्थितियों में मेट्रिक में अंतर करने के लिए उपयोगी होता है, जहां संगठन, परिवेश, और टाइमस्टैंप जैसे दूसरे डाइमेंशन कॉल में एक जैसे होते हैं. |
संगठन | संगठन | Edge का वह संगठन जिसमें एपीआई प्रॉक्सी डिप्लॉय की जाती हैं. |
नीति का नाम बदलने में गड़बड़ी हुई | ax_execution_fault _policy_name |
उस नीति का नाम जिसकी वजह से गड़बड़ी हुई और एपीआई कॉल पूरी नहीं हो सकी. ध्यान दें कि मैनेजमेंट एपीआई में इस्तेमाल किया जाने वाला पूरा नाम ax_execution_fault_policy_name है. इसमें लाइन ब्रेक नहीं है. अगर किसी नीति के तहत गड़बड़ी दिखती है, लेकिन नीति के रूट एट्रिब्यूट |
प्रॉक्सी | apiproxy | एपीआई प्रॉक्सी की मशीन का नाम (डिसप्ले नेम नहीं). |
प्रॉक्सी बेस पाथ | proxy_basepath |
एपीआई प्रॉक्सी प्रॉक्सीEndpoint पर कॉन्फ़िगर किया गया BasePath. बेस पाथ में, एपीआई प्रॉक्सी यूआरएल का डोमेन और पोर्ट वाला हिस्सा शामिल नहीं है. उदाहरण के लिए, अगर किसी एपीआई प्रॉक्सी का बेस यूआरएल https://apigeedocs-test.apigee.net/releasenotes/ है, तो बेस पाथ /releasenotes होता है. वैल्यू को |
प्रॉक्सी पाथ सफ़िक्स | proxy_pathsuffix |
एपीआई प्रॉक्सी बेस पाथ में जोड़ा गया संसाधन पाथ. उदाहरण के लिए, अगर किसी एपीआई प्रॉक्सी का
बेस यूआरएल अगर किसी भी पाथफ़िक्स का इस्तेमाल नहीं किया जाता है, तो वैल्यू खाली होती है. वैल्यू को |
प्रॉक्सी संशोधन | apiproxy_revision | API कॉल को हैंडल करने वाले एपीआई प्रॉक्सी का रिविज़न नंबर. यह ज़रूरी नहीं है कि एपीआई प्रॉक्सी में नया बदलाव किया गया हो. अगर किसी एपीआई प्रॉक्सी में 10 बदलाव किए गए हैं, तो आठवां वर्शन डिप्लॉय किया जा सकता है. साथ ही, एपीआई में कई बदलाव लागू किए जा सकते हैं, बशर्ते बदलावों में अलग-अलग बेस पाथ हों, जैसा कि यूज़र इंटरफ़ेस में प्रॉक्सी डिप्लॉय करना में बताया गया है. |
समाधान किए गए क्लाइंट आईपी | ax_resolved_client_ip |
इसमें मूल क्लाइंट का आईपी पता शामिल होता है. ध्यान दें कि क्लाइंट के सही आईपी पते को कैप्चर करने के लिए, अकामाई जैसे रूटिंग प्रॉडक्ट का इस्तेमाल करने पर, क्लाइंट आईपी को एचटीटीपी हेडर
|
जवाब की स्थिति का कोड | response_status_code | Apigee से क्लाइंट को भेजा गया एचटीटीपी रिस्पॉन्स स्टेटस कोड, जैसे कि 200, 404, 503 वगैरह. Edge में, टारगेट के रिस्पॉन्स स्टेटस कोड को मैसेज असाइन करें और गड़बड़ी बढ़ाएं जैसी नीतियों से ओवरराइट किया जा सकता है. इसलिए, यह डाइमेंशन, टारगेट रिस्पॉन्स कोड (target_response_code) से अलग हो सकता है. |
वर्चुअल होस्ट | virtual_host | उस वर्चुअल होस्ट का नाम
जिस पर एपीआई कॉल किया गया था. उदाहरण के लिए, संगठनों के पास डिफ़ॉल्ट रूप से दो
वर्चुअल होस्ट होते हैं: default (एचटीटीपी) और secure (एचटीटीपीएस). |
इनबाउंड/क्लाइंट | ||
क्लाइंट का आईपी पता | 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) के साथ दूसरे "ड्रिल-डाउन" डाइमेंशन के तौर पर इस्तेमाल किया जा सकता है. |
प्रॉक्सी क्लाइंट आईपी | proxy_client_ip |
कॉल करने वाले क्लाइंट का आईपी पता, जिसे |
रेफ़र किया गया क्लाइंट आईपी | ax_true_client_ip | क्लाइंट के सही आईपी पते को कैप्चर करने के लिए, अकामाई जैसे रूटिंग प्रॉडक्ट का इस्तेमाल करते समय, क्लाइंट के आईपी, एचटीटीपी हेडर
|
अनुरोध का पाथ | request_path |
टारगेट सेवा का रिसॉर्स पाथ, जिसमें डोमेन शामिल नहीं है. इसमें क्वेरी पैरामीटर शामिल नहीं हैं. उदाहरण के लिए, Apigee सैंपल टारगेट |
अनुरोध URI | request_uri |
टारगेट सेवा का रिसॉर्स पाथ, जिसमें डोमेन शामिल नहीं है. इसमें क्वेरी पैरामीटर भी शामिल हैं. उदाहरण के लिए, Apigee सैंपल टारगेट |
अनुरोध क्रिया | request_verb | एपीआई अनुरोधों में एचटीटीपी अनुरोध वाली कार्रवाई, जैसे कि GET, POST, PUT, DELETE. |
उपयोगकर्ता एजेंट | उपयोगकर्ता एजेंट |
एपीआई कॉल करने के लिए इस्तेमाल किए गए उपयोगकर्ता एजेंट या सॉफ़्टवेयर एजेंट का नाम. उदाहरण:
|
उपयोगकर्ता एजेंट फ़ैमिली | ax_ua_agent_family | उपयोगकर्ता एजेंट का फ़ैमिली ग्रुप, जैसे कि "Chrome Mobile" या "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 घंटे की घड़ी के आधार पर, 2-अंकों का घंटा जिसमें एपीआई कॉल किए गए थे. उदाहरण के लिए, रात 10 बजे से 11 बजे के बीच किए गए एपीआई कॉल की संख्या, ax_hour_of_day होगी. समय की वैल्यू यूटीसी में है. |
समय क्षेत्र | ax_geo_timezone | उन टाइम ज़ोन के सामान्य नाम जिनसे एपीआई कॉल किए गए थे, जैसे कि अमेरिका/New_York और यूरोप/डबलिन. |
महीने का हफ़्ता | ax_week_of_month | महीने का न्यूमेरिक हफ़्ता. उदाहरण के लिए, महीने के तीसरे हफ़्ते में किए गए एपीआई कॉल के लिए, ax_week_of_month की वैल्यू तीन है. |
जगह की जानकारी | ||
शहर | ax_geo_city | वह शहर जहां से एपीआई कॉल किए गए थे. |
महाद्वीप | ax_geo_continent | उस महाद्वीप का दो अक्षरों वाला कोड जिससे एपीआई कॉल किए गए थे. उदाहरण के लिए, उत्तरी अमेरिका के लिए NA. |
देश | ax_geo_country | उस देश का दो अक्षरों वाला कोड जहां से एपीआई कॉल किए गए थे. जैसे, अमेरिका के लिए US. |
भौगोलिक इलाका | ax_geo_region | भौगोलिक क्षेत्र के लिए हाइफ़न वाला कोड, जैसे कि STATE-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" से शुरू होते हैं:
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' लॉजिक का इस्तेमाल करके, अलग-अलग संभावित फ़िल्टर एक्सप्रेशन का आकलन करने में मदद मिलती है. फ़िल्टर में ऐसा डेटा शामिल होता है जो कम से कम कोई एक शर्त पूरी करता है. |