Analytics मेट्रिक, डाइमेंशन, और फ़िल्टर का रेफ़रंस

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

यह विषय, आंकड़ों की मेट्रिक, डाइमेंशन, और फ़िल्टर के लिए रेफ़रंस है. ज़्यादा जानकारी के लिए इनका इस्तेमाल करके, एपीआई से जुड़े आंकड़ों की खास जानकारी देखें.

यह विषय, यूज़र इंटरफ़ेस (यूआई) में और आपकी ज़रूरत के हिसाब से मेट्रिक और डाइमेंशन के नाम दिखाता है ताकि एपीआई कॉल में उनका इस्तेमाल किया जा सके.

मेट्रिक

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

कस्टम रिपोर्ट का नाम मैनेजमेंट एपीआई में इस्तेमाल करने के लिए नाम फ़ंक्शन ब्यौरा
प्रति सेकंड औसत लेन-देन टीपीएस कोई नहीं

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

एपीआई सिंटैक्स: tps

कैश मेमोरी हिट cache_hit कुल योग

ऐसे सफल एपीआई अनुरोधों की संख्या जो टारगेट की गई सेवा से मिलने वाले रिस्पॉन्स में.

एपीआई सिंटैक्स: sum(cache_hit)

L1 कैश एलिमेंट की संख्या ax_cache_l1_count औसत, मिनट, अधिकतम

किसी दिए गए लेन-देन पर L1 (इन-मेमोरी) कैश में मौजूद एलिमेंट की संख्या दिखाता है समयावधि. उदाहरण के लिए, अगर आपने दिन की पूरी अवधि के लिए max चुना है और किसी खास लेन-देन के लिए, कैश मेमोरी में सेव किए गए एलिमेंट की संख्या सबसे ज़्यादा 12 हो जाती है, तो संख्या 12 हो जाएगी. avg के लिए, अगर वह समयावधि है जिसके लिए क्वेरी की जा रही है और उनकी कैश मेमोरी 5, 6, और 7 है और औसत संख्या 6 है. L1 कैश मेमोरी, मेमोरी में सेव की गई कैश मेमोरी है. यह L2 डेटाबेस की कैश मेमोरी से अलग है, जैसा कि कैश मेमोरी में मौजूद कैश मेमोरी में बताया गया है.

एपीआई सिंटैक्स: avg(ax_cache_l1_count)

नीति से जुड़ी गड़बड़ियां policy_error कुल योग

किसी तय समयावधि के दौरान, नीति से जुड़ी गड़बड़ियों की कुल संख्या.

आम तौर पर, नीति से जुड़ी गड़बड़ियां डिज़ाइन के आधार पर होती हैं. उदाहरण के लिए, 'एपीआई की पुष्टि करें' नीति के उल्लंघन से जुड़ी जानकारी अनुरोध में अमान्य एपीआई पासकोड पास किए जाने पर गड़बड़ी और स्पाइक गिरफ़्तारी से जुड़ी नीति अगर एपीआई कॉल की संख्या, नीति में बताई गई सीमा से ज़्यादा हो जाती है, तो गड़बड़ी होती है. तो इस मेट्रिक से, आपके एपीआई में समस्या वाली संभावित जगहों को ढूंढने में मदद मिलती है. उदाहरण के लिए, developer_app डाइमेंशन के हिसाब से ग्रुप किया गया, policy_error मेट्रिक, आपके कारोबार को खोजने में आपकी मदद कर सकता है यह कि किसी ऐप्लिकेशन के लिए, एपीआई पासकोड या OAuth टोकन की समयसीमा खत्म हो गई है; इसके अलावा, आपको लगता है कि किसी खास एपीआई प्रॉक्सी के ज़रिए कई तरह की Spike Arrest गड़बड़ियां हो रही हैं. इससे आपको पता चलता है कि प्रॉक्सी की अचानक ज़्यादा गिरफ़्तारी की सीमा, छुट्टियों के सीज़न में आने वाले ट्रैफ़िक में बढ़ोतरी के लिए ज़िम्मेदार नहीं है.

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

गड़बड़ी पर नीति का नाम (ax_execution_fault_policy_name) डाइमेंशन इनके लिए काम का है नीति से जुड़ी गड़बड़ियों को नीति के नाम के हिसाब से ग्रुप में बांटें.

टारगेट न होने की गड़बड़ी (जैसे कि 404 या 503) को नीति से जुड़ी गड़बड़ी के तौर पर नहीं गिना जाता. वे को एपीआई प्रॉक्सी फ़ेलियर (is_error) के तौर पर गिना जाएगा.

एपीआई सिंटैक्स: sum(policy_error)

प्रॉक्सी गड़बड़ियां is_error कुल योग

तय समयावधि में एपीआई प्रॉक्सी के काम न करने की कुल संख्या. प्रॉक्सी तब भी हो सकती है, जब कोई नीति काम न करे या जब रनटाइम फ़ेल हो जाए, जैसे कि 404 या टारगेट सेवा से 503 कोड मिला हो.

प्रॉक्सी (apiप्रॉक्सी) डाइमेंशन, प्रॉक्सी के ज़रिए एपीआई प्रॉक्सी विफलताओं को ग्रुप करने के लिए काम का है.

एपीआई सिंटैक्स: sum(is_error)

अनुरोध को प्रोसेस करने में लगने वाले समय का अंतर request_processing_latency औसत, मिनट, अधिकतम

समय (औसत, कम से कम या ज़्यादा से ज़्यादा), मिलीसेकंड में, आने वाले अनुरोधों को प्रोसेस करने में एज की ज़रूरत होती है. अनुरोध के पूरा होने का समय एज और एज, अनुरोध को टारगेट की गई सेवा पर भेजने के बाद ही खत्म होते हैं.

अलग-अलग डाइमेंशन का इस्तेमाल करके, एपीआई प्रॉक्सी की मदद से अनुरोध प्रोसेस होने में लगने वाले समय की जांच की जा सकती है. डेवलपर ऐप्लिकेशन, क्षेत्र वगैरह.

एपीआई सिंटैक्स: max(request_processing_latency)

अनुरोध का साइज़ request_size योग, औसत, कम, अधिकतम

Edge को मिलने वाले अनुरोध पेलोड का साइज़, बाइट में.

एपीआई सिंटैक्स: avg(request_size)

रिस्पॉन्स कैश मेमोरी एक्ज़ीक्यूट की गई ax_cache_executed कुल योग

दिए गए समय में रिस्पॉन्स कैश नीति को लागू किए जाने की कुल संख्या अवधि के लिए मान्य है.

चूंकि रिस्पॉन्स कैश नीति API प्रॉक्सी में दो जगहों पर जुड़ी होती है (एक बार में अनुरोध और एक बार जवाब में), यह आम तौर पर एपीआई कॉल में दो बार काम करता है. कैश मेमोरी 'पाएं' और एक कैश 'पुट' हर एक को एक एक्ज़ीक्यूशन के तौर पर गिना जाता है.

हालांकि, रिस्पॉन्स कैश मेमोरी को एक्ज़ीक्यूट नहीं किया जा सकता, अगर <SkipCacheLookup> अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है नीति के तत्व का मूल्यांकन 'सही' (अनुरोध में) के रूप में होता है. साथ ही, 0 होने पर, <SkipCachePopulation> नीति का एलिमेंट सही (जवाब में) के तौर पर मार्क होता है.

ट्रेस टूल में, किए गए एपीआई कॉल में रिस्पॉन्स कैश आइकॉन पर क्लिक करके, responsecache.executed फ़्लो वैरिएबल से यह देखने के लिए कि कैश मेमोरी एक्ज़ीक्यूट हुई है या नहीं (वैल्यू 1).

एपीआई सिंटैक्स: sum(ax_cache_executed)

जवाब प्रोसेस होने में लगने वाला समय response_processing_latency औसत, मिनट, अधिकतम

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

अलग-अलग डाइमेंशन का इस्तेमाल करके, एपीआई के हिसाब से रिस्पॉन्स को प्रोसेस करने में लगने वाले समय की जांच की जा सकती है प्रॉक्सी, क्षेत्र वगैरह.

एपीआई सिंटैक्स: min(response_processing_latency)

रिस्पॉन्स का साइज़ response_size योग, औसत, कम, अधिकतम

क्लाइंट को लौटाए गए रिस्पॉन्स पेलोड का साइज़ बाइट में सबमिट कर सकते हैं.

एपीआई सिंटैक्स: max(response_size)

टारगेट से जुड़ी गड़बड़ियां target_error कुल योग

टारगेट की गई सेवा से मिले 5xx जवाबों की कुल संख्या. ये टारगेट की गई सेवाएं हैं ये गड़बड़ियां Apigee की वजह से नहीं हुई हैं.

एपीआई सिंटैक्स: sum(target_error)

जवाब देने का टारगेट समय target_response_time योग, औसत, कम, अधिकतम

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

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

एपीआई सिंटैक्स: avg(target_response_time)

जवाब देने में लगने वाला कुल समय total_response_time योग, औसत, कम, अधिकतम

समय की मात्रा (योग, औसत, कम से कम या ज़्यादा से ज़्यादा) मिलीसेकंड, जब Edge को क्लाइंट से अनुरोध मिलता है और जब Edge, क्लाइंट को जवाब वापस भेजता है. समय में नेटवर्क ओवरहेड शामिल होता है (जैसे लोड बैलेंसर और राऊटर को अपना काम करने में लगने वाला समय, प्रोसेसिंग के लिए अनुरोध करें इंतज़ार का समय, जवाब प्रोसेस होने में लगने वाला समय, और जवाब देने में लगने वाला टारगेट समय (अगर जवाब दिया जाता है को कैश मेमोरी में सेव करता है.

अलग-अलग डाइमेंशन का इस्तेमाल करके, एपीआई प्रॉक्सी के ज़रिए डेटा प्रोसेस होने में लगने वाले समय की जांच की जा सकती है. डेवलपर ऐप्लिकेशन, क्षेत्र वगैरह.

एपीआई सिंटैक्स: avg(total_response_time)

ट्रैफ़िक message_count कुल योग

किसी तय समयावधि में Edge से प्रोसेस किए गए एपीआई कॉल की कुल संख्या.

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

एपीआई सिंटैक्स: sum(message_count)

डाइमेंशन

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

Apigee से मिलने वाले ये डाइमेंशन यहां दिए गए हैं. इसके अतिरिक्त, आप अपना अपने डाइमेंशन भी शामिल करने होंगे, जैसा कि कस्टम ऐनलिटिक्स का इस्तेमाल करके एपीआई मैसेज के कॉन्टेंट का विश्लेषण करना लेख में बताया गया है.

कस्टम रिपोर्ट का नाम मैनेजमेंट एपीआई में इस्तेमाल करने के लिए नाम ब्यौरा
Apigee इकाइयां
ऐक्सेस टोकन access_token ऐप्लिकेशन के असली उपयोगकर्ता का OAuth ऐक्सेस टोकन.
एपीआई प्रॉडक्ट api_product

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

अगर ऊपर दी गई शर्तें पूरी नहीं होती हैं, तो आपको "(not set)" वैल्यू दिखेगी. यह भी देखें Analytics इकाई की वैल्यू "(not set)" का क्या मतलब है का मतलब है?.

कैश कुंजी ax_cache_key

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

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

कैश मेमोरी का नाम ax_cache_name

रिस्पॉन्स कैश से जुड़ी नीति में इस्तेमाल की जाने वाली कुंजियों/वैल्यू वाली कैश मेमोरी का नाम, इसके पहले orgName__envName__ का इस्तेमाल करें. उदाहरण के लिए, अगर संगठन "foo" है, यह एनवायरमेंट "टेस्ट" है, और कैश का नाम "myकैश" है, ax_cache_name है foo__test__myCache.

ट्रेस टूल में, रिस्पॉन्स कैश की नीति चुनने पर, यह वैल्यू responsecache.cachename फ़्लो वैरिएबल.

कैश सोर्स ax_cache_source

वह कैश लेवल ("L1" इन-मेमोरी या "L2" डेटाबेस) जिससे रिस्पॉन्स कैश था वापस लाया गया. यह डाइमेंशन "CACHE_MISS" भी दिखाता है जब से जवाब भेजा गया था कैश के बजाय टारगेट किया गया हो और टारगेट रिस्पॉन्स के साथ रिस्पॉन्स कैश को रीफ़्रेश किया गया हो; या जब अनुरोध में मौजूद कैश कुंजी अमान्य हो. कैश मेमोरी सिर्फ़ इन कुंजियों के लिए ही इस्तेमाल की जा सकती है साइज़ में 2 केबी.

ट्रेस टूल में, रिस्पॉन्स कैश नीति चुनने पर, यह वैल्यू responsecache.cachesource फ़्लो वैरिएबल.

कैश मेमोरी के लेवल के बारे में ज़्यादा जानकारी के लिए, कैश मेमोरी में सेव की जाने वाली फ़ाइलों को देखें.

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

गड़बड़ी का गलत कोड. जैसे: messaging.adaptors.http.flow.GatewayTimeout अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है

फ़्लो के नाम में गड़बड़ी हुई 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 है, वह भी बिना लाइन ब्रेक के.

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

प्रॉक्सी एपीआई प्रॉक्सी किसी एपीआई प्रॉक्सी की मशीन का नाम (न कि डिसप्ले नेम).
प्रॉक्सी बेस पाथ proxy_basepath

एपीआई प्रॉक्सी ProxyEndpoint पर कॉन्फ़िगर किया गया BasePath. बेस पाथ में यह शामिल नहीं होता एपीआई प्रॉक्सी यूआरएल का डोमेन और पोर्ट हिस्सा. उदाहरण के लिए, अगर एपीआई प्रॉक्सी का बेस यूआरएल यह होता है https://apigeedocs-test.apigee.net/releasenotes/, इसका बेस पाथ /releasenotes है.

वैल्यू को proxy.basepath फ़्लो वैरिएबल में भी स्टोर किया जाता है.

प्रॉक्सी पाथ का सफ़िक्स proxy_pathsuffix

एपीआई प्रॉक्सी बेस पाथ में संसाधन पाथ जोड़ा गया. उदाहरण के लिए, यदि किसी API प्रॉक्सी का बेस यूआरएल https://apigeedocs-test.apigee.net/hello/ है. इसके बाद, इस नंबर पर कॉल किया गया है https://apigeedocs-test.apigee.net/hello/json, पाथफ़ीक्स यह है /json.

अगर किसी पाथफ़ीक्स का इस्तेमाल नहीं किया गया है, तो वैल्यू खाली होती है.

वैल्यू को proxy.pathsuffix फ़्लो वैरिएबल में भी स्टोर किया जाता है.

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

इसमें ओरिजनल क्लाइंट आईपी पता शामिल होता है. ax_resolved_client_ip की वैल्यू डाइमेंशन की गणना ax_true_client_ip और x_forwarded_for_ip डाइमेंशन.

ध्यान दें कि क्लाइंट के सही आईपी पतों को कैप्चर करने के लिए, Akamai जैसे प्रॉडक्ट का इस्तेमाल करते समय, क्लाइंट आईपी को एचटीटीपी हेडर True-Client-IP में Edge भेजा जाता है, जो कि फिर ax_true_client_ip डाइमेंशन को सेट करने के लिए इसका इस्तेमाल किया जाता है.

ax_resolved_client_ip डाइमेंशन की वैल्यू का हिसाब इस तरह से लगाया जाता है:

  1. अगर ax_true_client_ip खाली नहीं है और उसमें लोकल आईपी पता नहीं है, इसके बाद, ax_resolved_client_ip को ax_true_client_ip पर सेट करें.
  2. वरना, ax_resolved_client_ip को इसमें पहले गैर-स्थानीय आईपी पते पर सेट करें x_forwarded_for_ip.
  3. अगर ax_true_client_ip और x_forwarded_for_ip, दोनों में करने के बाद, ax_resolved_client_ip को x_forwarded_for_ip में पहला स्थानीय आईपी पता जोड़ा गया.
  4. अगर ax_true_client_ip और x_forwarded_for_ip, दोनों शून्य हैं, तो ax_resolved_client_ip को (not set) पर सेट करें.
  5. अगर ax_true_client_ip एक लोकल आईपी पता है और x_forwarded_for_ip शून्य है, ax_resolved_client_ip को (not set) पर सेट करें.
जवाब की स्थिति का कोड 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

कॉल करने वाले क्लाइंट का आईपी पता, proxy.client.ip में सेव किया गया फ़्लो वैरिएबल. यह अक्सर इनबाउंड कॉल का X-Forwarded-For पता होता है, जो पिछले एक्सटर्नल टीसीपी हैंडशेक से मिला आईपी पता Edge है. यह काम कर सका वह कॉल करने वाले क्लाइंट हो या लोड बैलेंसर. जब खोज के नतीजों में कई आईपी होते हैं X-Forwarded-For हेडर, यह सूची में शामिल आखिरी आईपी है.

रेफ़र किया गया क्लाइंट आईपी ax_true_client_ip

क्लाइंट के सही IP पते कैप्चर करने के लिए Akamai जैसे प्रॉडक्ट का उपयोग करते समय, क्लाइंट आईपी, एचटीटीपी हेडर True-Client-IP में Edge को भेजे जाते हैं. यह डाइमेंशन उस हेडर से उन सही क्लाइंट आईपी को कैप्चर करता है.

ओरिजनल क्लाइंट का आईपी पता तय करने के लिए, ax_resolved_client_ip से ऐक्सेस किया जाता है डाइमेंशन के तौर पर, Edge ax_true_client_ip और x_forwarded_for_ip डाइमेंशन.

अनुरोध का पाथ request_path

टारगेट की जाने वाली सेवा के लिए संसाधन पाथ (इसमें डोमेन शामिल नहीं है), लेकिन क्वेरी को छोड़कर पैरामीटर का इस्तेमाल करें.

उदाहरण के लिए, Apigee सैंपल टारगेट http://mocktarget.apigee.net इसमें कई संसाधन शामिल हैं. इनमें /user भी शामिल है, जो अभिवादन दिखाता है. भले ही, आपका एपीआई प्रॉक्सी http://mocktarget.apigee.net/user को कॉल करे, request_path /user है.

अनुरोध URI request_uri

टारगेट की जाने वाली सेवा का संसाधन पाथ (इसमें डोमेन शामिल नहीं है), जिसमें क्वेरी भी शामिल है पैरामीटर का इस्तेमाल करें.

उदाहरण के लिए, Apigee सैंपल टारगेट http://mocktarget.apigee.net कई संसाधन शामिल हैं, जिनमें /user?user={name} संसाधन और क्वेरी शामिल हैं पैरामीटर का इस्तेमाल, दिए गए नाम पर पसंद के मुताबिक बनाया गया वेलकम मैसेज दिखाने के लिए किया जाता है. भले ही आपका एपीआई प्रॉक्सी कॉल http://mocktarget.apigee.net/user?user=Dude, request_uri है /user?user=Dude.

अनुरोध क्रिया request_verb एपीआई अनुरोधों में एचटीटीपी अनुरोध की क्रिया, जैसे कि GET, POST, PUT, DELETE.
उपयोगकर्ता एजेंट useragent

एपीआई कॉल करने के लिए इस्तेमाल किए जाने वाले उपयोगकर्ता एजेंट या सॉफ़्टवेयर एजेंट का नाम. उदाहरण:

  • Pixel XL, Chrome से कॉल कर रहा है: Mozilla/5.0 (Linux; Android 7.1.2; Pixel XL Build/NHG47N) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/59.0.3071.92 Mobile Safari/537.36
  • iPad की मदद से, Chrome से कॉल किया जा रहा है: Mozilla/5.0 (iPad; CPU OS 10_2 like Mac OS X) AppleWebKit/602.1.50 (KHTML, like Gecko) CriOS/54.0.2840.91 Mobile/14C92 Safari/602.1
  • टर्मिनल से जुड़ा cURL: curl/7.51.0
उपयोगकर्ता एजेंट फ़ैमिली ax_ua_agent_family उपयोगकर्ता एजेंट का परिवार, जैसे कि "Chrome मोबाइल" या "cURL" शामिल है.
उपयोगकर्ता एजेंट का टाइप ax_ua_agent_type उपयोगकर्ता एजेंट का टाइप, जैसे कि "ब्राउज़र," "मोबाइल ब्राउज़र" "लाइब्रेरी," वगैरह.
उपयोगकर्ता एजेंट का वर्शन ax_ua_agent_version

उपयोगकर्ता एजेंट का वर्शन.

इसे दूसरे "ड्रिल-डाउन" के तौर पर इस्तेमाल करना मददगार होता है उपयोगकर्ता एजेंट फ़ैमिली के साथ डाइमेंशन (ax_ua_agent_family) पर जाएं.

आउटबाउंड/टारगेट
टारगेट बेस पाथ target_basepath

टारगेट की जाने वाली सेवा के लिए संसाधन पाथ (इसमें डोमेन शामिल नहीं है), लेकिन क्वेरी को छोड़कर पैरामीटर, जो प्रॉक्सी के <TargetEndpoint> में तय किए गए हैं.

उदाहरण के लिए, मान लें कि कोई एपीआई प्रॉक्सी नीचे दिए गए टारगेट को कॉल करता है:

<TargetEndpoint name="default">
...
<HTTPTargetConnection>
  <URL>http://mocktarget.apigee.net/user?user=Dude</URL>
</HTTPTargetConnection>

इस उदाहरण में, target_basepath /user है.

अगर टारगेट यह होता:

<TargetEndpoint name="default">
...
<HTTPTargetConnection>
  <URL>http://mocktarget.apigee.net</URL>
</HTTPTargetConnection>

target_basepath शून्य होगा.

ट्रेस टूल में, जब फ़्लो डायग्राम के आखिर में मौजूद AX आइकॉन चुनें, target.basepath flow वैरिएबल target_basepath डाइमेंशन का डेटा.

टारगेट होस्ट 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 है http://mocktarget.apigee.net/user?user=Dude.

ध्यान दें कि एपीआई प्रॉक्सी प्रोसेसिंग के दौरान, यूआरएल को target.url फ़्लो वैरिएबल.

प्रॉक्सी में चेन बनाना और स्क्रिप्ट का इस्तेमाल करते समय टारगेट (Node.js) हैं, तो कॉलिंग प्रॉक्सी में target_url खाली है.

इसके लिए X फ़ॉरवर्ड किया गया x_forwarded_for_ip

X-Forwarded-For हेडर में आईपी पतों की सूची.

ओरिजनल क्लाइंट का आईपी पता तय करने के लिए, ax_resolved_client_ip से ऐक्सेस किया जाता है डाइमेंशन के तौर पर, Edge ax_true_client_ip और 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' का इस्तेमाल करने देता है लॉजिक का इस्तेमाल करें. फ़िल्टर इसमें ऐसा डेटा शामिल होता है जो कम से कम एक शर्त को पूरा करता हो.