আপনি Apigee Edge-এর ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশন .info- তে যান।
এই বিষয়টি অ্যানালিটিক্স মেট্রিক্স, ডাইমেনশন এবং ফিল্টার সম্পর্কিত একটি নির্দেশিকা। এগুলির ব্যবহার সম্পর্কে আরও বিস্তারিত জানতে, এপিআই অ্যানালিটিক্স ওভারভিউ দেখুন।
এই বিষয়টিতে মেট্রিক এবং ডাইমেনশনের নামগুলো দেখানো হয়েছে, যেভাবে সেগুলো UI-তে প্রদর্শিত হয় এবং যেভাবে API কলে ব্যবহার করতে হয়।
- কাস্টম রিপোর্ট তৈরি করার সময় আপনি UI-এর নামগুলো দেখতে পাবেন।
- মেট্রিক্স সংগ্রহ করার সময়, রিপোর্ট ডেফিনিশন তৈরি করার সময়, বা রিপোর্ট ডেফিনিশন আপডেট করার সময় এপিআই-এর জন্য নির্দিষ্ট নামগুলো ব্যবহার করুন।
মেট্রিক্স
কাস্টম রিপোর্ট এবং ম্যানেজমেন্ট এপিআই কলের মাধ্যমে আপনি নিম্নলিখিত এপিআই মেট্রিকগুলো পেতে পারেন।
| কাস্টম রিপোর্টের নাম | ম্যানেজমেন্ট এপিআই-তে ব্যবহার করার জন্য নাম | কার্যাবলী | বর্ণনা |
|---|---|---|---|
| প্রতি সেকেন্ডে গড় লেনদেন | টিপিএস | কোনোটিই না | প্রতি সেকেন্ডে লেনদেনের গড় সংখ্যা, অর্থাৎ এপিআই প্রক্সি অনুরোধের সংখ্যা। উল্লেখ্য যে, যদি নির্দিষ্ট সময়কালে আপনার লেনদেনের সংখ্যা তুলনামূলকভাবে কম হয়, তবে সংখ্যাটি দুই দশমিক স্থানের চেয়ে ছোট হলে UI কাস্টম রিপোর্টে প্রতি সেকেন্ডে লেনদেনের গড় সংখ্যা শূন্য দেখাতে পারে। এপিআই সিনট্যাক্স: |
| ক্যাশে হিট | ক্যাশে_হিট | যোগফল | টার্গেট সার্ভিসের রেসপন্সের পরিবর্তে রেসপন্স ক্যাশে ব্যবহার করে এমন সফল এপিআই রিকোয়েস্টের সংখ্যা। এপিআই সিনট্যাক্স: |
| L1 ক্যাশে উপাদানের সংখ্যা | ax_cache_l1_count | গড়, সর্বনিম্ন, সর্বোচ্চ | একটি নির্দিষ্ট সময়কালে প্রতি ট্রানজ্যাকশনের জন্য L1 (ইন-মেমরি) ক্যাশে থাকা উপাদানের সংখ্যা ফেরত দেয়। উদাহরণস্বরূপ, যদি আপনি একদিনের সময়কালের জন্য এপিআই সিনট্যাক্স: |
| নীতিগত ত্রুটি | নীতি_ত্রুটি | যোগফল | নির্দিষ্ট সময়কালে নীতিগত ত্রুটির মোট সংখ্যা। পলিসি ত্রুটি সাধারণত ডিজাইনগতভাবেই ঘটে থাকে। উদাহরণস্বরূপ, অনুরোধে একটি অবৈধ এপিআই কী (API key) দেওয়া হলে 'ভেরিফাই এপিআই কী' (Verify API Key) পলিসিটি একটি ত্রুটি দেখায়, এবং এপিআই কলের সংখ্যা পলিসিতে সংজ্ঞায়িত সীমা অতিক্রম করলে 'স্পাইক অ্যারেস্ট' (Spike Arrest) পলিসি একটি ত্রুটি দেখায়। তাই আপনার এপিআই-এর সম্ভাব্য সমস্যা খুঁজে বের করার জন্য এই মেট্রিকটি কার্যকর। উদাহরণস্বরূপ, 'ডেভেলপার_অ্যাপ' (developer_app) ডাইমেনশন অনুযায়ী গ্রুপ করা 'পলিসি_এরর' (policy_error) মেট্রিকগুলো আপনাকে খুঁজে বের করতে সাহায্য করতে পারে যে একটি নির্দিষ্ট অ্যাপের জন্য এপিআই কী বা ওঅথ টোকেনের মেয়াদ শেষ হয়ে গেছে; অথবা আপনি হয়তো দেখতে পারেন যে একটি নির্দিষ্ট এপিআই প্রক্সি প্রচুর 'স্পাইক অ্যারেস্ট' ত্রুটি দেখাচ্ছে, যার ফলে আপনি আবিষ্কার করতে পারবেন যে প্রক্সিটির 'স্পাইক অ্যারেস্ট' সীমা ছুটির দিনের ট্র্যাফিক বৃদ্ধিকে হিসাবে ধরে না। অ্যানালিটিক্সে একটি পলিসি ত্রুটি তখনই লগ করা হয়, যখন সেই ত্রুটির ফলে এপিআই প্রক্সি ব্যর্থ হয়। উদাহরণস্বরূপ, যদি কোনো পলিসির ` পলিসির নাম অনুসারে পলিসি ত্রুটিগুলিকে গোষ্ঠীভুক্ত করার জন্য ‘পলিসি নেম অন এরর’ (ax_execution_fault_policy_name) ডাইমেনশনটি উপযোগী। টার্গেট ব্যর্থতা (যেমন 404 বা 503) পলিসি ব্যর্থতা হিসাবে গণ্য হয় না। এগুলো এপিআই প্রক্সি ব্যর্থতা (is_error) হিসাবে গণ্য হয়। এপিআই সিনট্যাক্স: |
| প্রক্সি ত্রুটি | ত্রুটি | যোগফল | নির্দিষ্ট সময়কালে এপিআই প্রক্সিগুলো মোট যতবার ব্যর্থ হয়েছে। কোনো পলিসি ব্যর্থ হলে অথবা রানটাইমে কোনো ত্রুটি, যেমন টার্গেট সার্ভিস থেকে আসা 404 বা 503 ত্রুটির কারণে প্রক্সি ব্যর্থ হতে পারে। প্রক্সি (apiproxy) ডাইমেনশনটি প্রক্সি অনুসারে এপিআই প্রক্সি ব্যর্থতাগুলোকে শ্রেণিবদ্ধ করার জন্য উপযোগী। API সিনট্যাক্স: |
| অনুরোধ প্রক্রিয়াকরণ বিলম্ব | অনুরোধ প্রক্রিয়াকরণের বিলম্ব | গড়, সর্বনিম্ন, সর্বোচ্চ | ইনকামিং রিকোয়েস্ট প্রসেস করতে Edge-এর যে সময় লাগে (গড়, সর্বনিম্ন বা সর্বোচ্চ), তা মিলিসেকেন্ডে পরিমাপ করা হয়। এই সময় গণনা শুরু হয় যখন রিকোয়েস্টটি Edge-এ পৌঁছায় এবং শেষ হয় যখন Edge রিকোয়েস্টটি টার্গেট সার্ভিসে ফরোয়ার্ড করে। বিভিন্ন মাত্রা ব্যবহার করে আপনি এপিআই প্রক্সি, ডেভেলপার অ্যাপ, অঞ্চল ইত্যাদির ভিত্তিতে অনুরোধ প্রক্রিয়াকরণের বিলম্ব পরীক্ষা করতে পারেন। এপিআই সিনট্যাক্স: |
| অনুরোধের আকার | অনুরোধের আকার | যোগফল, গড়, সর্বনিম্ন, সর্বোচ্চ | Edge কর্তৃক গৃহীত অনুরোধ পেলোডের আকার, বাইটে । এপিআই সিনট্যাক্স: |
| প্রতিক্রিয়া ক্যাশে কার্যকর করা হয়েছে | ax_cache_executed | যোগফল | প্রদত্ত সময়কালে একটি রেসপন্স ক্যাশ পলিসি মোট যতবার কার্যকর করা হয়েছিল। যেহেতু একটি এপিআই প্রক্সিতে রেসপন্স ক্যাশ পলিসি দুটি জায়গায় সংযুক্ত থাকে (একবার রিকোয়েস্টে এবং একবার রেসপন্সে), তাই এটি সাধারণত একটি এপিআই কলে দুইবার এক্সিকিউট হয়। একটি ক্যাশ 'গেট' এবং একটি ক্যাশ 'পুট' প্রতিটি একটি এক্সিকিউশন হিসেবে গণ্য হয়। তবে, পলিসিতে থাকা ট্রেস টুলে , আপনি একটি সম্পাদিত API কলের মধ্যে থাকা রেসপন্স ক্যাশ আইকনে ক্লিক করে এপিআই সিনট্যাক্স: |
| প্রতিক্রিয়া প্রক্রিয়াকরণ বিলম্ব | প্রতিক্রিয়া_প্রক্রিয়া_বিলম্ব | গড়, সর্বনিম্ন, সর্বোচ্চ | এপিআই প্রতিক্রিয়াগুলি প্রক্রিয়া করতে Edge-এর যে সময় (গড়, সর্বনিম্ন বা সর্বোচ্চ), তা মিলিসেকেন্ডে পরিমাপ করা হয়। এপিআই প্রক্সি যখন টার্গেট সার্ভিসের প্রতিক্রিয়া গ্রহণ করে তখন থেকে সময় গণনা শুরু হয় এবং Apigee যখন প্রতিক্রিয়াটি মূল কলারের কাছে ফরোয়ার্ড করে তখন তা শেষ হয়। বিভিন্ন মাত্রা ব্যবহার করে, আপনি এপিআই প্রক্সি, অঞ্চল ইত্যাদির ভিত্তিতে প্রতিক্রিয়া প্রক্রিয়াকরণের বিলম্ব পরীক্ষা করতে পারেন। এপিআই সিনট্যাক্স: |
| প্রতিক্রিয়ার আকার | প্রতিক্রিয়ার আকার | যোগফল, গড়, সর্বনিম্ন, সর্বোচ্চ | ক্লায়েন্টকে ফেরত পাঠানো প্রতিক্রিয়া পেলোডের আকার, বাইটে । এপিআই সিনট্যাক্স: |
| লক্ষ্য ত্রুটি | লক্ষ্য_ত্রুটি | যোগফল | টার্গেট সার্ভিস থেকে প্রাপ্ত মোট 5xx সংখ্যক রেসপন্স। এগুলো টার্গেট সার্ভিসের ত্রুটি, যা Apigee-এর কারণে ঘটেনি। এপিআই সিনট্যাক্স: |
| লক্ষ্য প্রতিক্রিয়া সময় | লক্ষ্য_প্রতিক্রিয়া_সময় | যোগফল, গড়, সর্বনিম্ন, সর্বোচ্চ | টার্গেট সার্ভারের একটি কলে সাড়া দিতে যে সময় লাগে (মোট, গড়, সর্বনিম্ন বা সর্বোচ্চ), তা মিলিসেকেন্ডে পরিমাপ করা হয়। এই মেট্রিকটি আপনাকে জানায় যে টার্গেট সার্ভারগুলো কেমন পারফর্ম করছে। এই সময় গণনা শুরু হয় যখন Edge টার্গেট সার্ভিসে একটি অনুরোধ ফরোয়ার্ড করে এবং শেষ হয় যখন Edge সেই প্রতিক্রিয়াটি গ্রহণ করে। উল্লেখ্য যে, যদি কোনো API কল ক্যাশে থেকে রেসপন্স ফেরত দেয় (উদাহরণস্বরূপ, রেসপন্স ক্যাশে পলিসি ব্যবহার করে), তাহলে কলটি কখনোই টার্গেট সার্ভিসে পৌঁছাবে না এবং কোনো টার্গেট রেসপন্স টাইম মেট্রিক্সও লগ করা হবে না। এপিআই সিনট্যাক্স: |
| মোট প্রতিক্রিয়া সময় | মোট প্রতিক্রিয়া সময় | যোগফল, গড়, সর্বনিম্ন, সর্বোচ্চ | যখন Edge কোনো ক্লায়েন্টের কাছ থেকে একটি অনুরোধ গ্রহণ করে, তখন থেকে শুরু করে যখন Edge ক্লায়েন্টকে প্রতিক্রিয়া ফেরত পাঠায়, সেই পর্যন্ত সময়ের পরিমাণ (মোট, গড়, সর্বনিম্ন বা সর্বোচ্চ), যা মিলিসেকেন্ডে পরিমাপ করা হয়। এই সময়ের মধ্যে অন্তর্ভুক্ত রয়েছে নেটওয়ার্ক ওভারহেড (যেমন লোড ব্যালেন্সার এবং রাউটারের কাজ করার সময়), অনুরোধ প্রক্রিয়াকরণের বিলম্ব, প্রতিক্রিয়া প্রক্রিয়াকরণের বিলম্ব, এবং টার্গেট প্রতিক্রিয়ার সময় (যদি প্রতিক্রিয়াটি ক্যাশের পরিবর্তে টার্গেট পরিষেবা থেকে পরিবেশন করা হয়)। বিভিন্ন মাত্রা ব্যবহার করে আপনি এপিআই প্রক্সি, ডেভেলপার অ্যাপ, অঞ্চল ইত্যাদির ভিত্তিতে প্রসেসিং ল্যাটেন্সি পরীক্ষা করতে পারেন। এপিআই সিনট্যাক্স: |
| ট্র্যাফিক | বার্তার সংখ্যা | যোগফল | নির্দিষ্ট সময়কালে Edge দ্বারা প্রক্রিয়াকৃত মোট API কলের সংখ্যা। আপনার জন্য সবচেয়ে অর্থপূর্ণ উপায়ে ট্র্যাফিক গণনাকে শ্রেণিবদ্ধ করতে ডাইমেনশন ব্যবহার করুন। এপিআই সিনট্যাক্স: |
মাত্রা
ডাইমেনশন আপনাকে মেট্রিকগুলোকে অর্থপূর্ণ গ্রুপে ভাগ করে দেখার সুযোগ দেয়। উদাহরণস্বরূপ, প্রতিটি ডেভেলপার অ্যাপ বা এপিআই প্রক্সির জন্য মোট ট্র্যাফিক সংখ্যা দেখলে তা আরও বেশি কার্যকরী হয়ে ওঠে।
নিচে Apigee-এর ডিফল্ট ডাইমেনশনগুলো দেওয়া হলো। এছাড়াও, ‘কাস্টম অ্যানালিটিক্স ব্যবহার করে API মেসেজের বিষয়বস্তু বিশ্লেষণ করুন ’ অংশে বর্ণিত পদ্ধতি অনুযায়ী আপনি আপনার নিজস্ব ডাইমেনশন তৈরি করতে পারেন।
| কাস্টম রিপোর্টের নাম | ম্যানেজমেন্ট এপিআই-তে ব্যবহার করার জন্য নাম | বর্ণনা |
|---|---|---|
| অ্যাপিজি সত্তা | ||
| অ্যাক্সেস টোকেন | অ্যাক্সেস_টোকেন | অ্যাপ ব্যবহারকারীর OAuth অ্যাক্সেস টোকেন। |
| এপিআই পণ্য | এপিআই_প্রোডাক্ট | যে এপিআই প্রক্সিগুলোকে কল করা হচ্ছে, সেই এপিআই প্রোডাক্টের নাম। এই ডাইমেনশনটি পেতে হলে, কলকারী ডেভেলপার অ্যাপগুলোকে অবশ্যই এক বা একাধিক এপিআই প্রোডাক্টের সাথে যুক্ত থাকতে হবে যেগুলোতে এপিআই প্রক্সিগুলো রয়েছে, এবং যে প্রক্সিগুলোকে কল করা হচ্ছে সেগুলোকে অবশ্যই এপিআই কলের সাথে পাঠানো একটি এপিআই কী বা OAuth টোকেন যাচাই করতে হবে। কী বা টোকেনটি একটি এপিআই প্রোডাক্টের সাথে যুক্ত থাকে। আরও তথ্যের জন্য, দেখুন ‘প্রথমেই যা করতে হবে: কীভাবে সম্পূর্ণ অ্যানালিটিক্স ডেটা তৈরি করবেন ’। যদি উপরের শর্তগুলো পূরণ না হয়, তাহলে আপনি "(not set)" মানটি দেখতে পাবেন। আরও দেখুন, একটি অ্যানালিটিক্স এনটিটি ভ্যালু "(not set)" এর অর্থ কী?। |
| ক্যাশে কী | ax_cache_key | যে কী-টিতে অ্যাক্সেস করা রেসপন্স ক্যাশ ভ্যালুটি রয়েছে। রেসপন্স ক্যাশের জন্য কী কীভাবে তৈরি করা হয় সে সম্পর্কে আরও তথ্যের জন্য, রেসপন্স ক্যাশ পলিসি দেখুন। ট্রেস টুলে , যখন আপনি এমন একটি রেসপন্স ক্যাশ পলিসি নির্বাচন করেন যা ক্যাশ থেকে রিড বা রাইট করে, তখন আপনি এই মানটি |
| ক্যাশে নাম | অক্ষ_ক্যাশের_নাম | রেসপন্স ক্যাশ পলিসি দ্বারা ব্যবহৃত কী/ভ্যালু ধারণকারী ক্যাশের নাম, যার শুরুতে orgName__envName__ যুক্ত থাকে। উদাহরণস্বরূপ, যদি অর্গ "foo," এনভায়রনমেন্ট "test," এবং ক্যাশের নাম "myCache" হয়, তাহলে ax_cache_name হবে foo__test__myCache। ট্রেস টুলে , যখন আপনি একটি রেসপন্স ক্যাশ পলিসি নির্বাচন করেন, তখন আপনি এই মানটি |
| ক্যাশে উৎস | ax_cache_source | যে ক্যাশ লেভেল ("L1" ইন-মেমরি অথবা "L2" ডেটাবেস) থেকে রেসপন্স ক্যাশটি পুনরুদ্ধার করা হয়েছিল। এই ডাইমেনশনটি "CACHE_MISS"ও দেখায় যখন রেসপন্সটি ক্যাশের পরিবর্তে টার্গেট থেকে ডেলিভার করা হয় (এবং রেসপন্স ক্যাশটি টার্গেট রেসপন্স দিয়ে রিফ্রেশ করা হয়); অথবা যখন রিকোয়েস্টের কোনো ক্যাশ কী অবৈধ হয়। ক্যাশ কী-গুলোর আকার ২ কিলোবাইটের মধ্যে সীমাবদ্ধ। ট্রেস টুলে , যখন আপনি রেসপন্স ক্যাশ পলিসি নির্বাচন করেন, তখন আপনি এই মানটি ক্যাশ লেভেল সম্পর্কে আরও তথ্যের জন্য, ক্যাশ ইন্টারনালস দেখুন। |
| ক্লায়েন্ট আইডি | ক্লায়েন্ট_আইডি | এপিআই কলকারী ডেভেলপার অ্যাপের কনজিউমার কী (এপিআই কী), যা রিকোয়েস্টে এপিআই কী হিসেবে পাঠানো হয় অথবা OAuth টোকেনে অন্তর্ভুক্ত থাকে। এই ডাইমেনশনটি পেতে হলে, কল গ্রহণকারী প্রক্সিগুলোকে একটি বৈধ API কী বা OAuth টোকেন যাচাই করার জন্য কনফিগার করতে হবে। Edge-এ ডেভেলপার অ্যাপগুলো রেজিস্টার করার সময় API কী পায়, যা OAuth টোকেন তৈরি করতে ব্যবহার করা যেতে পারে। আরও তথ্যের জন্য, দেখুন “প্রথমেই যা করতে হবে: কীভাবে সম্পূর্ণ অ্যানালিটিক্স ডেটা তৈরি করবেন ”। যদি উপরের শর্তগুলো পূরণ না হয়, তাহলে আপনি "(not set)" মানটি দেখতে পাবেন। আরও দেখুন, একটি অ্যানালিটিক্স এনটিটি ভ্যালু "(not set)" এর অর্থ কী?। |
| ডেভেলপার অ্যাপ | ডেভেলপার_অ্যাপ | Edge-এ নিবন্ধিত ডেভেলপার অ্যাপটি API কল করছে। এই ডাইমেনশনটি পেতে হলে, অ্যাপগুলোকে অবশ্যই এক বা একাধিক এপিআই প্রোডাক্টের সাথে যুক্ত থাকতে হবে, যেগুলোতে কল করা এপিআই প্রক্সিগুলো থাকে, এবং প্রক্সিগুলোকে অবশ্যই এপিআই কলের সাথে পাঠানো একটি এপিআই কী বা OAuth টোকেন যাচাই করতে হবে। এই কী বা টোকেনটি ডেভেলপার অ্যাপটিকে শনাক্ত করে। আরও তথ্যের জন্য, দেখুন ‘প্রথমেই যা করতে হবে: কীভাবে সম্পূর্ণ অ্যানালিটিক্স ডেটা তৈরি করবেন ’। যদি উপরের শর্তগুলো পূরণ না হয়, তাহলে আপনি "(not set)" মানটি দেখতে পাবেন। আরও দেখুন, একটি অ্যানালিটিক্স এনটিটি ভ্যালু "(not set)" এর অর্থ কী?। |
| ডেভেলপার ইমেল | ডেভেলপার_ইমেল | Edge-এ নিবন্ধিত সেই ডেভেলপারদের ইমেল, যাদের অ্যাপটি API কলগুলো করেছিল। এই ডাইমেনশনটি পেতে হলে, ডেভেলপারদের অবশ্যই এক বা একাধিক এপিআই প্রোডাক্টের সাথে যুক্ত অ্যাপ থাকতে হবে, যেগুলোতে কল করা এপিআই প্রক্সিগুলো অন্তর্ভুক্ত থাকে, এবং প্রক্সিগুলোকে অবশ্যই এপিআই কলের সাথে পাঠানো একটি এপিআই কী বা OAuth টোকেন যাচাই করতে হবে। এই কী বা টোকেনটি ডেভেলপার অ্যাপটিকে শনাক্ত করে। আরও তথ্যের জন্য, দেখুন ‘প্রথমেই যা করতে হবে: কীভাবে সম্পূর্ণ অ্যানালিটিক্স ডেটা তৈরি করবেন ’। যদি উপরের শর্তগুলো পূরণ না হয়, তাহলে আপনি "(not set)" মানটি দেখতে পাবেন। আরও দেখুন, একটি অ্যানালিটিক্স এনটিটি ভ্যালু "(not set)" এর অর্থ কী?। |
| ডেভেলপার আইডি | ডেভেলপার | Edge দ্বারা তৈরি অনন্য ডেভেলপার আইডিটি org_name @@@ unique_id আকারে থাকে। এই ডাইমেনশনটি পেতে হলে, ডেভেলপারদের অবশ্যই এক বা একাধিক এপিআই প্রোডাক্টের সাথে যুক্ত অ্যাপ থাকতে হবে, যেগুলোতে কল করা এপিআই প্রক্সিগুলো অন্তর্ভুক্ত থাকে, এবং প্রক্সিগুলোকে অবশ্যই এপিআই কলের সাথে পাঠানো একটি এপিআই কী বা OAuth টোকেন যাচাই করতে হবে। এই কী বা টোকেনটি ডেভেলপারকে শনাক্ত করে। আরও তথ্যের জন্য, দেখুন “প্রথমেই যা করতে হবে: কীভাবে সম্পূর্ণ অ্যানালিটিক্স ডেটা তৈরি করবেন ”। যদি উপরের শর্তগুলো পূরণ না হয়, তাহলে আপনি "(not set)" মানটি দেখতে পাবেন। আরও দেখুন, একটি অ্যানালিটিক্স এনটিটি ভ্যালু "(not set)" এর অর্থ কী?। |
| পরিবেশ | পরিবেশ | যে এজ এনভায়রনমেন্টে এপিআই প্রক্সিগুলো ডেপ্লয় করা হয়। উদাহরণস্বরূপ, 'test' বা 'prod'। |
| ত্রুটির ক্ষেত্রে ফল্ট কোড | ax_edge_execution_fault_code | ত্রুটির ফল্ট কোড । উদাহরণস্বরূপ: |
| ত্রুটির ক্ষেত্রে প্রবাহের নাম | ax_execution_fault _প্রবাহের_নাম | এপিআই প্রক্সিতে থাকা নামযুক্ত ফ্লো, যেটি ত্রুটি সৃষ্টি করেছে। উদাহরণস্বরূপ, "PreFlow," "PostFlow," অথবা আপনার তৈরি করা কোনো শর্তাধীন ফ্লো-এর নাম। উল্লেখ্য যে, ম্যানেজমেন্ট এপিআই-তে ব্যবহারের জন্য পূর্ণ নামটি হলো ax_execution_fault_flow_name, কোনো লাইন ব্রেক ছাড়া। যেখানে কোনো ত্রুটি ঘটেনি, সেখানে আপনি "(সেট করা হয়নি)" মানটি দেখতে পাবেন। |
| প্রবাহ সম্পদ | প্রবাহ_সম্পদ | শুধুমাত্র Apigee ব্যবহারের জন্য। আগ্রহী হলে এই কমিউনিটি পোস্টটি দেখুন। |
| ত্রুটির ক্ষেত্রে প্রবাহের অবস্থা | ax_execution_fault _প্রবাহ_অবস্থা | যে এপিআই প্রক্সি ফ্লোটি ত্রুটি তৈরি করেছে তার নাম থেকেই বোঝা যায়, যেমন "PROXY_REQ_FLOW" বা "TARGET_RESP_FLOW"। উল্লেখ্য যে, ম্যানেজমেন্ট এপিআই-তে ব্যবহারের জন্য পূর্ণ নামটি হলো ax_execution_fault_flow_state, কোনো লাইন ব্রেক ছাড়া। |
| গেটওয়ে ফ্লো আইডি | গেটওয়ে_ফ্লো_আইডি | Edge-এর মধ্য দিয়ে API কলগুলো যাওয়ার সময়, প্রতিটি কল তার নিজস্ব গেটওয়ে ফ্লো আইডি পায়। উদাহরণ: rrt329ea-12575-114653952-1। উচ্চ TPS পরিস্থিতিতে মেট্রিকগুলোকে আলাদা করার জন্য গেটওয়ে ফ্লো আইডি কার্যকর, যেখানে অর্গানাইজেশন, এনভায়রনমেন্ট এবং টাইমস্ট্যাম্পের মতো অন্যান্য ডাইমেনশনগুলো সব কলের ক্ষেত্রে একই থাকে। |
| সংগঠন | সংগঠন | এজ অর্গানাইজেশন যেখানে এপিআই প্রক্সিগুলো ডেপ্লয় করা হয়। |
| ত্রুটির ক্ষেত্রে পলিসির নাম | ax_execution_fault _নীতির_নাম | যে পলিসিটির কারণে ত্রুটি দেখা দিয়েছিল এবং এপিআই কলটি ব্যর্থ হয়েছিল, তার নাম। উল্লেখ্য যে, ম্যানেজমেন্ট এপিআই-তে ব্যবহারের জন্য পূর্ণ নামটি হলো ax_execution_fault_policy_name, কোনো লাইন ব্রেক ছাড়া। যদি কোনো পলিসি ত্রুটি দেখায় কিন্তু পলিসির রুট অ্যাট্রিবিউট |
| প্রক্সি | এপিপ্রক্সি | একটি এপিআই প্রক্সির মেশিন নেম (ডিসপ্লে নেম নয়)। |
| প্রক্সি বেস পাথ | প্রক্সি_বেসপাথ | এপিআই প্রক্সি ProxyEndpoint-এ BasePath কনফিগার করা থাকে। বেস পাথে এপিআই প্রক্সি ইউআরএল-এর ডোমেইন এবং পোর্ট অংশ অন্তর্ভুক্ত থাকে না। উদাহরণস্বরূপ, যদি কোনো এপিআই প্রক্সির বেস ইউআরএল হয় https://apigeedocs-test.apigee.net/releasenotes/, তাহলে বেস পাথ হবে /releasenotes। মানটি |
| প্রক্সি পাথ সাফিক্স | প্রক্সি_পাথসাফিক্স | এপিআই প্রক্সি বেস পাথের সাথে রিসোর্স পাথ যোগ করা হয়। উদাহরণস্বরূপ, যদি কোনো এপিআই প্রক্সির বেস ইউআরএল হয় যদি কোনো পাথসাফিক্স ব্যবহার না করা হয়, তাহলে মানটি খালি থাকে। মানটি |
| প্রক্সি সংশোধন | apiproxy_revision | যে এপিআই প্রক্সিটি এপিআই কলগুলো পরিচালনা করেছে, এটি তার রিভিশন নম্বর। এর মানে এই নয় যে এটিই এপিআই প্রক্সির সর্বশেষ রিভিশন। যদি একটি এপিআই প্রক্সির ১০টি রিভিশন থাকে, তবে বর্তমানে ৮ম রিভিশনটি ডেপ্লয় করা থাকতে পারে। এছাড়াও, একটি এপিআই-এর একাধিক রিভিশন ডেপ্লয় করা থাকতে পারে, যদি রিভিশনগুলোর বেস পাথ ভিন্ন হয়, যেমনটি UI-তে প্রক্সি ডেপ্লয় করা অংশে বর্ণনা করা হয়েছে। |
| সমাধান করা ক্লায়েন্ট আইপি | ax_resolved_client_ip | এতে উৎস ক্লায়েন্টের আইপি ঠিকানা থাকে। উল্লেখ্য যে, আকামাই-এর মতো রাউটিং প্রোডাক্ট ব্যবহার করে ক্লায়েন্টদের আসল আইপি অ্যাড্রেস ক্যাপচার করার সময়, ক্লায়েন্ট আইপি-টি HTTP হেডার
|
| প্রতিক্রিয়া স্থিতি কোড | প্রতিক্রিয়া_স্থিতি_কোড | Apigee থেকে ক্লায়েন্টের কাছে পাঠানো HTTP রেসপন্স স্ট্যাটাস কোড, যেমন 200, 404, 503, ইত্যাদি। Edge-এ, Assign Message এবং Raise Fault-এর মতো পলিসি দ্বারা টার্গেট থেকে আসা রেসপন্স স্ট্যাটাস কোড ওভাররাইট করা যেতে পারে, যে কারণে এই ডাইমেনশনটি Target Response Code (target_response_code) থেকে ভিন্ন হতে পারে। |
| ভার্চুয়াল হোস্ট | ভার্চুয়াল_হোস্ট | যে ভার্চুয়াল হোস্টে এপিআই কলটি করা হয়েছিল তার নাম। উদাহরণস্বরূপ, সংস্থাগুলোর ডিফল্টরূপে দুটি ভার্চুয়াল হোস্ট থাকে: default (http) এবং secure (https)। |
| ইনবাউন্ড/ক্লায়েন্ট | ||
| ক্লায়েন্টের আইপি ঠিকানা | ক্লায়েন্ট_আইপি | যে সিস্টেমটি রাউটারে সংযোগ স্থাপন করে, যেমন মূল ক্লায়েন্ট (proxy_client_ip) বা একটি লোড ব্যালেন্সার, তার আইপি অ্যাড্রেস। যখন X-Forwarded-For হেডারে একাধিক আইপি থাকে, তখন এটিই হলো তালিকায় থাকা সর্বশেষ আইপি। |
| ডিভাইসের বিভাগ | ax_ua_device_category | যে ডিভাইস থেকে এপিআই কলটি করা হয়েছিল তার ধরন, যেমন "ট্যাবলেট" বা "স্মার্টফোন"। |
| ওএস পরিবার | ax_ua_os_family | কলকারী ডিভাইসের অপারেটিং সিস্টেম পরিবার, যেমন 'অ্যান্ড্রয়েড' বা 'আইওএস'। |
| ওএস সংস্করণ | ax_ua_os_version | কলকারী ডিভাইসটির অপারেটিং সিস্টেম সংস্করণ। অপারেটিং সিস্টেমগুলোর সংস্করণগুলো দেখার জন্য, OS Family (ax_ua_os_family)-এর সাথে এটিকে দ্বিতীয় একটি "ড্রিল-ডাউন" ডাইমেনশন হিসেবে ব্যবহার করা সুবিধাজনক। |
| প্রক্সি ক্লায়েন্ট আইপি | প্রক্সি_ক্লায়েন্ট_আইপি | কলিং ক্লায়েন্টের আইপি অ্যাড্রেস, যা |
| রেফার করা ক্লায়েন্ট আইপি | ax_true_client_ip | Akamai-এর মতো রাউটিং প্রোডাক্ট ব্যবহার করে ক্লায়েন্টদের আসল আইপি অ্যাড্রেস ক্যাপচার করার সময়, ক্লায়েন্ট আইপিগুলো HTTP হেডার মূল ক্লায়েন্ট আইপি অ্যাড্রেস নির্ধারণ করতে, যা |
| অনুরোধের পথ | অনুরোধের পথ | কোয়েরি প্যারামিটার ব্যতীত, টার্গেট সার্ভিসের রিসোর্স পাথ (ডোমেইন ছাড়া)। উদাহরণস্বরূপ, Apigee-এর নমুনা টার্গেট |
| অনুরোধ URI | অনুরোধ_ইউআরআই | কোয়েরি প্যারামিটার সহ, টার্গেট সার্ভিসের রিসোর্স পাথ (ডোমেইন ব্যতীত)। উদাহরণস্বরূপ, Apigee-এর নমুনা টার্গেট |
| অনুরোধ ক্রিয়া | অনুরোধ_ক্রিয়া | এপিআই অনুরোধে ব্যবহৃত HTTP রিকোয়েস্ট ভার্ব, যেমন GET, POST, PUT, DELETE। |
| ব্যবহারকারী এজেন্ট | ব্যবহারকারী এজেন্ট | এপিআই কল করার জন্য ব্যবহৃত ইউজার এজেন্ট বা সফটওয়্যার এজেন্টের নাম। উদাহরণ:
|
| ব্যবহারকারী এজেন্ট পরিবার | ax_ua_agent_family | ইউজারএজেন্টের পরিবার, যেমন "Chrome Mobile" বা "cURL"। |
| ব্যবহারকারী এজেন্ট প্রকার | ax_ua_agent_type | ইউজারএজেন্ট টাইপ, যেমন "ব্রাউজার," "মোবাইল ব্রাউজার," "লাইব্রেরি," ইত্যাদি। |
| ব্যবহারকারী এজেন্ট সংস্করণ | ax_ua_agent_version | ইউজারএজেন্টের সংস্করণ। এজেন্ট ফ্যামিলির ভার্সনটি পাওয়ার জন্য ইউজার এজেন্ট ফ্যামিলি (ax_ua_agent_family)-এর সাথে এটিকে একটি দ্বিতীয় "ড্রিল-ডাউন" ডাইমেনশন হিসেবে ব্যবহার করা সুবিধাজনক। |
| বহির্গামী/লক্ষ্য | ||
| লক্ষ্য ভিত্তি পথ | লক্ষ্য_মূলপথ | প্রক্সির উদাহরণস্বরূপ, ধরা যাক একটি এপিআই প্রক্সি নিম্নলিখিত টার্গেটকে কল করে: <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-এর মান null হবে। ট্রেস টুলে , ফ্লো ডায়াগ্রামের শেষে AX আইকনটি নির্বাচন করলে, |
| টার্গেট হোস্ট | টার্গেট_হোস্ট | টার্গেট সার্ভিসের হোস্ট। উদাহরণস্বরূপ, যদি একটি এপিআই প্রক্সি http://mocktarget.apigee.net/help কল করে, তাহলে target_host হবে mocktarget.apigee.net । |
| লক্ষ্য আইপি ঠিকানা | টার্গেট_আইপি | এপিআই প্রক্সিতে প্রতিক্রিয়া ফেরতকারী টার্গেট সার্ভিসের আইপি অ্যাড্রেস। |
| লক্ষ্য প্রতিক্রিয়া কোড | লক্ষ্য_প্রতিক্রিয়া_কোড | টার্গেট সার্ভিস থেকে এপিআই প্রক্সিতে ফেরত পাঠানো HTTP রেসপন্স স্ট্যাটাস কোড, যেমন 200, 404, 503, ইত্যাদি। 'null' মানের অর্থ হলো অনুরোধটি কখনোই লক্ষ্য পরিষেবাতে পৌঁছায়নি। এটি তখন ঘটে যখন প্রতিক্রিয়াটি রেসপন্স ক্যাশ পলিসি দ্বারা পরিবেশিত হয় অথবা যখন অনুরোধ প্রক্রিয়াকরণে কোনো ব্যর্থতা ঘটে। এটি রেসপন্স স্ট্যাটাস কোড (response_status_code) ডাইমেনশন থেকে ভিন্ন। |
| লক্ষ্য URL | টার্গেট_ইউআরএল | একটি এপিআই প্রক্সির টার্গেটএন্ডপয়েন্টে সংজ্ঞায়িত টার্গেট সার্ভিসের সম্পূর্ণ ইউআরএল। <TargetEndpoint name="default"> ... <HTTPTargetConnection> <URL>http://mocktarget.apigee.net/user?user=Dude</URL> </HTTPTargetConnection> এই উদাহরণে, target_url হলো উল্লেখ্য যে, এপিআই প্রক্সি প্রসেসিং চলাকালীন প্রক্সি চেইনিং এবং স্ক্রিপ্ট টার্গেট (Node.js) ব্যবহারের ক্ষেত্রে, কলিং প্রক্সির target_url-টি null হয়। |
| এক্স ফরোয়ার্ড করা হয়েছে | x_forwarded_for_ip | মূল ক্লায়েন্ট আইপি অ্যাড্রেস নির্ধারণ করতে, যা |
| সময় | ||
| সপ্তাহের দিন | সপ্তাহের দিন | সপ্তাহের দিনের তিন অক্ষরের সংক্ষিপ্ত রূপ, যে দিনে এপিআই কলগুলো করা হয়েছিল। উদাহরণস্বরূপ, সোম, মঙ্গল, বুধ। |
| মাস | বছরের x_মাস | যে সংখ্যাসূচক মাসে এপিআই কলগুলো করা হয়েছিল। উদাহরণস্বরূপ, মার্চের জন্য "03"। |
| দিনের সময় | দিনের অক্ষ-ঘন্টা | ২৪-ঘণ্টার ঘড়ি অনুসারে, যে ২-অঙ্কের ঘণ্টায় এপিআই কলগুলো করা হয়েছিল। উদাহরণস্বরূপ, রাত ১০টা থেকে ১১টার মধ্যে এপিআই কল করা হলে, ax_hour_of_day হবে ২২। সময়টি UTC এককে রয়েছে। |
| সময় অঞ্চল | ax_geo_timezone | যেসব টাইম জোন থেকে এপিআই কলগুলো করা হয়েছিল, সেগুলোর প্রচলিত নাম, যেমন America/New_York এবং Europe/Dublin। |
| মাসের সপ্তাহ | মাসের_সপ্তাহ | মাসের সংখ্যাসূচক সপ্তাহ। উদাহরণস্বরূপ, কোনো মাসের ৩য় সপ্তাহে করা এপিআই কলের জন্য, ax_week_of_month হলো ৩। |
| অবস্থান | ||
| শহর | অক্ষ_ভূ_শহর | যে শহর থেকে এপিআই কলগুলো করা হয়েছিল। |
| মহাদেশ | অক্ষ_ভূ_মহাদেশ | যে মহাদেশ থেকে এপিআই কলগুলো করা হয়েছিল, তার দুই-অক্ষরের কোড। উদাহরণস্বরূপ, উত্তর আমেরিকার জন্য NA। |
| দেশ | ax_geo_country | যে দেশ থেকে এপিআই কলগুলো করা হয়েছিল, সেই দেশের দুই-অক্ষরের কোড। উদাহরণস্বরূপ, ইউনাইটেড স্টেটস-এর জন্য US। |
| ভৌগোলিক অঞ্চল | অক্ষ_ভূ-অঞ্চল | ভৌগোলিক অঞ্চলের জন্য হাইফেনযুক্ত কোড, যেমন রাজ্য-দেশ। উদাহরণস্বরূপ, ওয়াশিংটন-মার্কিন যুক্তরাষ্ট্রের জন্য WA-US। |
| অঞ্চল | ax_dn_region | Apigee ডেটা সেন্টারের নাম যেখানে API প্রক্সিগুলো স্থাপন করা হয়, যেমন 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%')
যেসব এপিআই কলের রেসপন্স স্ট্যাটাস কোড ৪০০ থেকে ৫৯৯-এর মধ্যে, সেগুলোর মেট্রিক্স ফেরত দেয়:
filter=(response_status_code ge 400 and response_status_code le 599)
যেসব এপিআই কলের রেসপন্স স্ট্যাটাস কোড ২০০ এবং টার্গেট রেসপন্স কোড ৪০৪, সেগুলোর মেট্রিক্স ফেরত দেয়:
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 | যদি স্ট্রিং প্যাটার্নটি প্রদত্ত প্যাটার্নের সাথে মিলে যায়, তাহলে true রিটার্ন করে। |
not like | যদি স্ট্রিং প্যাটার্নটি প্রদত্ত প্যাটার্নের সাথে মিলে যায়, তাহলে ফলস রিটার্ন করে। |
similar to | এর প্যাটার্নটি প্রদত্ত স্ট্রিংয়ের সাথে মেলে কিনা তার উপর নির্ভর করে এটি ট্রু বা ফলস রিটার্ন করে। এটি ' like -এর মতোই, তবে পার্থক্য হলো এটি SQL স্ট্যান্ডার্ডের রেগুলার এক্সপ্রেশনের সংজ্ঞা ব্যবহার করে প্যাটার্নটি ব্যাখ্যা করে। |
not similar to | এর প্যাটার্নটি প্রদত্ত স্ট্রিংয়ের সাথে মেলে কি না, তার উপর নির্ভর করে এটি ফলস বা ট্রু রিটার্ন করে। এটি not like এর অনুরূপ, তবে পার্থক্য হলো এটি SQL স্ট্যান্ডার্ডের রেগুলার এক্সপ্রেশনের সংজ্ঞা ব্যবহার করে প্যাটার্নটিকে ব্যাখ্যা করে। |
and | একাধিক ফিল্টার এক্সপ্রেশন অন্তর্ভুক্ত করতে আপনাকে 'অ্যান্ড' লজিক ব্যবহার করার সুযোগ দেয়। এই ফিল্টারে সেই ডেটা অন্তর্ভুক্ত থাকে যা সমস্ত শর্ত পূরণ করে। |
or | এটি আপনাকে বিভিন্ন সম্ভাব্য ফিল্টার এক্সপ্রেশন মূল্যায়ন করতে 'or' লজিক ব্যবহার করার সুযোগ দেয়। ফিল্টারটিতে এমন ডেটা অন্তর্ভুক্ত থাকে যা শর্তগুলোর মধ্যে অন্তত একটি পূরণ করে। |