বিশ্লেষণ মেট্রিক্স, মাত্রা, এবং ফিল্টার রেফারেন্স

আপনি Apigee Edge ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশনে যান
তথ্য

এই বিষয় বিশ্লেষণ মেট্রিক্স, মাত্রা, এবং ফিল্টার জন্য একটি রেফারেন্স. এগুলি ব্যবহার করার বিষয়ে আরও প্রসঙ্গের জন্য, API বিশ্লেষণ ওভারভিউ দেখুন।

এই বিষয় মেট্রিক্স এবং মাত্রাগুলির নামগুলি দেখায় যেমন সেগুলি UI-তে প্রদর্শিত হয় এবং আপনাকে API কলগুলিতে সেগুলি ব্যবহার করতে হবে৷

মেট্রিক্স

নিম্নলিখিত API মেট্রিকগুলি আপনি কাস্টম রিপোর্ট এবং পরিচালনা API কলগুলিতে পুনরুদ্ধার করতে পারেন৷

কাস্টম রিপোর্টের নাম ব্যবস্থাপনা API-তে ব্যবহার করার জন্য নাম ফাংশন বর্ণনা
প্রতি সেকেন্ডে গড় লেনদেন টিপিএস কোনোটিই নয়

লেনদেনের গড় সংখ্যা, মানে API প্রক্সি অনুরোধ, প্রতি সেকেন্ডে। মনে রাখবেন যে সময়সীমার মধ্যে আপনার যদি তুলনামূলকভাবে কম সংখ্যক লেনদেন হয়, সংখ্যাটি দুই দশমিকের চেয়ে ছোট হলে প্রতি সেকেন্ডে লেনদেনের গড় সংখ্যা UI কাস্টম রিপোর্টে শূন্য বলে মনে হতে পারে।

API সিনট্যাক্স: tps

ক্যাশে হিট ক্যাশে_হিট যোগফল

সফল API অনুরোধের সংখ্যা যা লক্ষ্য পরিষেবা থেকে প্রতিক্রিয়ার পরিবর্তে প্রতিক্রিয়া ক্যাশে ব্যবহার করে।

API সিনট্যাক্স: sum(cache_hit)

L1 ক্যাশে উপাদান গণনা ax_cache_l1_count গড়, সর্বনিম্ন, সর্বোচ্চ

একটি নির্দিষ্ট সময়ের মধ্যে লেনদেন প্রতি L1 (ইন-মেমরি) ক্যাশে উপাদানের সংখ্যা প্রদান করে। উদাহরণস্বরূপ, যদি আপনি একটি দিনের সময়ের জন্য max নির্বাচন করেন এবং সেই দিনের মধ্যে একটি নির্দিষ্ট লেনদেনের জন্য ক্যাশে উপাদানগুলির সর্বোচ্চ সংখ্যা 12 হয়, তাহলে গণনা হবে 12। avg জন্য, যদি সময়ের মধ্যে তিনটি লেনদেন হয় আপনি যে সময়ের জন্য অনুসন্ধান করছেন, এবং তাদের ক্যাশে সংখ্যা হল 5, 6 এবং 7, গড় হল 6। L1 ক্যাশে হল ইন-মেমরি ক্যাশে L2 ডাটাবেস ক্যাশের বিপরীতে, যেমন ক্যাশে ইন্টার্নালগুলিতে বর্ণনা করা হয়েছে।

API সিনট্যাক্স: avg(ax_cache_l1_count)

নীতি ত্রুটি নীতি_ত্রুটি যোগফল

নির্দিষ্ট সময়ের মধ্যে নীতিগত ত্রুটির মোট সংখ্যা।

নীতিগত ত্রুটি সাধারণত নকশা দ্বারা ঘটতে পারে। উদাহরণস্বরূপ, অনুরোধে একটি অবৈধ API কী পাস করা হলে যাচাই API কী নীতি একটি ত্রুটি ছুঁড়ে দেয় এবং যদি API কলের সংখ্যা নীতিতে সংজ্ঞায়িত সীমা অতিক্রম করে তবে একটি স্পাইক অ্যারেস্ট নীতি একটি ত্রুটি ছুড়ে দেয়। তাই এই মেট্রিকটি আপনার API তে সম্ভাব্য সমস্যার জায়গা খুঁজে বের করার জন্য উপযোগী। উদাহরণ স্বরূপ, বিকাশকারী_অ্যাপের মাত্রা দ্বারা গোষ্ঠীবদ্ধ নীতি_ত্রুটি মেট্রিক্স, আপনাকে একটি API কী বা OAuth টোকেন একটি প্রদত্ত অ্যাপের মেয়াদ শেষ হয়ে গেছে তা আবিষ্কার করতে সাহায্য করতে পারে; অথবা আপনি দেখতে পারেন যে একটি নির্দিষ্ট API প্রক্সি প্রচুর স্পাইক অ্যারেস্ট ত্রুটি নিক্ষেপ করছে, যার ফলে আপনি আবিষ্কার করতে পারেন যে প্রক্সির স্পাইক অ্যারেস্ট সীমা ছুটির ট্রাফিক বৃদ্ধির জন্য দায়ী নয়৷

একটি নীতি ত্রুটি বিশ্লেষণে লগ ইন করা হয় শুধুমাত্র যদি ত্রুটির ফলে API প্রক্সি ব্যর্থ হয়৷ উদাহরণস্বরূপ, যদি একটি নীতির continueOnError অ্যাট্রিবিউট true সেট করা থাকে, তাহলে নীতি ব্যর্থ হলেও API প্রক্সি একটি অনুরোধ প্রক্রিয়াকরণ চালিয়ে যায়। এই ক্ষেত্রে, একটি নীতি ত্রুটি বিশ্লেষণ লগ ইন করা হয় না.

পলিসি নেম অন ইরর (ax_execution_fault_policy_name) ডাইমেনশন পলিসির নাম অনুসারে পলিসি ত্রুটি গ্রুপ করার জন্য উপযোগী।

একটি লক্ষ্য ব্যর্থতা (যেমন একটি 404 বা 503) একটি নীতি ব্যর্থতা হিসাবে গণনা করা হয় না। এগুলিকে API প্রক্সি ব্যর্থতা হিসাবে গণনা করা হয় (is_error)।

API সিনট্যাক্স: sum(policy_error)

প্রক্সি ত্রুটি is_error যোগফল

নির্দিষ্ট সময়ের মধ্যে মোট কতবার API প্রক্সি ব্যর্থ হয়েছে৷ প্রক্সি ব্যর্থতা ঘটতে পারে যখন একটি নীতি ব্যর্থ হয় বা যখন একটি রানটাইম ব্যর্থ হয়, যেমন লক্ষ্য পরিষেবা থেকে 404 বা 503৷

প্রক্সি (এপিপ্রক্সি) মাত্রা প্রক্সি দ্বারা API প্রক্সি ব্যর্থতা গোষ্ঠীবদ্ধ করার জন্য উপযোগী।

API সিনট্যাক্স: sum(is_error)

প্রসেসিং লেটেন্সির অনুরোধ করুন অনুরোধ_প্রসেসিং_লেটেন্সি গড়, সর্বনিম্ন, সর্বোচ্চ

সময়ের পরিমাণ (গড়, সর্বনিম্ন বা সর্বোচ্চ), মিলিসেকেন্ডে , যা আগত অনুরোধগুলি প্রক্রিয়া করতে এজ নেয়৷ সময়টি শুরু হয় যখন অনুরোধটি এজে পৌঁছায় এবং শেষ হয় যখন এজ অনুরোধটি লক্ষ্য পরিষেবাতে ফরোয়ার্ড করে।

বিভিন্ন মাত্রা ব্যবহার করে, আপনি API প্রক্সি, ডেভেলপার অ্যাপ, অঞ্চল ইত্যাদির মাধ্যমে অনুরোধ প্রক্রিয়াকরণের বিলম্ব পরীক্ষা করতে পারেন।

এপিআই সিনট্যাক্স: max(request_processing_latency)

অনুরোধের আকার অনুরোধ_আকার যোগফল, গড়, সর্বনিম্ন, সর্বোচ্চ

এজ দ্বারা প্রাপ্ত অনুরোধ পেলোডের আকার, বাইটে

API সিনট্যাক্স: avg(request_size)

প্রতিক্রিয়া ক্যাশে কার্যকর করা হয়েছে৷ ax_cache_executed যোগফল

প্রদত্ত সময়ের মধ্যে একটি রেসপন্স ক্যাশে নীতি কতবার সম্পাদিত হয়েছে।

যেহেতু রেসপন্স ক্যাশে নীতিটি API প্রক্সিতে দুটি জায়গায় সংযুক্ত থাকে (একবার অনুরোধে এবং একবার প্রতিক্রিয়াতে), এটি সাধারণত একটি API কলে দুবার কার্যকর করে। একটি ক্যাশে 'গেট' এবং একটি ক্যাশে 'পুট' প্রতিটি গণনা একটি এক্সিকিউশন হিসাবে।

যাইহোক, নীতিতে <SkipCacheLookup> উপাদানটি সত্য (অনুরোধে) মূল্যায়ন করলে প্রতিক্রিয়া ক্যাশে সম্পাদন 0 হয় এবং নীতিতে <SkipCachePopulation> উপাদানটি সত্য (প্রতিক্রিয়ায়) মূল্যায়ন করলে 0 হয়।

ট্রেস টুলে , আপনি একটি এক্সিকিউটেড এপিআই কলে রেসপন্স ক্যাশে আইকনে ক্লিক করতে পারেন এবং ক্যাশে এক্সিকিউশন (1 এর মান) ছিল কিনা তা দেখতে responsecache.executed ফ্লো ভেরিয়েবল দেখতে পারেন।

API সিনট্যাক্স: sum(ax_cache_executed)

রেসপন্স প্রসেসিং লেটেন্সি রেসপন্স_প্রসেসিং_লেটেন্সি গড়, সর্বনিম্ন, সর্বোচ্চ

সময়ের পরিমাণ (গড়, সর্বনিম্ন বা সর্বোচ্চ), মিলিসেকেন্ডে , যেটি API প্রতিক্রিয়াগুলি প্রক্রিয়া করতে Edge নেয়৷ সময় শুরু হয় যখন এপিআই প্রক্সি টার্গেট সার্ভিস রেসপন্স পায় এবং শেষ হয় যখন এপিজি রেসপন্সটি আসল কলারের কাছে ফরওয়ার্ড করে।

বিভিন্ন মাত্রা ব্যবহার করে, আপনি API প্রক্সি, অঞ্চল ইত্যাদি দ্বারা প্রতিক্রিয়া প্রক্রিয়াকরণের বিলম্ব পরীক্ষা করতে পারেন।

API সিনট্যাক্স: min(response_processing_latency)

প্রতিক্রিয়া আকার প্রতিক্রিয়া_ আকার যোগফল, গড়, সর্বনিম্ন, সর্বোচ্চ

প্রতিক্রিয়া পেলোডের আকার ক্লায়েন্টের কাছে বাইটে ফিরে আসে।

API সিনট্যাক্স: max(response_size)

লক্ষ্য ত্রুটি লক্ষ্য_ত্রুটি যোগফল

লক্ষ্য পরিষেবা থেকে মোট 5xx প্রতিক্রিয়া। এগুলি টার্গেট পরিষেবা ত্রুটি যা Apigee দ্বারা সৃষ্ট নয়৷

API সিনট্যাক্স: sum(target_error)

টার্গেট রেসপন্স টাইম লক্ষ্য_প্রতিক্রিয়া_সময় যোগফল, গড়, সর্বনিম্ন, সর্বোচ্চ

টার্গেট সার্ভার একটি কলে সাড়া দেওয়ার জন্য সময়ের পরিমাণ (সমষ্টি, গড়, সর্বনিম্ন বা সর্বোচ্চ), মিলিসেকেন্ডে । এই মেট্রিক আপনাকে বলে যে টার্গেট সার্ভারগুলি কীভাবে পারফর্ম করছে৷ সময় শুরু হয় যখন এজ টার্গেট সার্ভিসে একটি অনুরোধ ফরোয়ার্ড করে এবং শেষ হয় যখন এজ প্রতিক্রিয়া পায়।

মনে রাখবেন যে যদি একটি API কল ক্যাশে থেকে একটি প্রতিক্রিয়া প্রদান করে (উদাহরণস্বরূপ, প্রতিক্রিয়া ক্যাশে নীতি ব্যবহার করে), কলটি কখনই লক্ষ্য পরিষেবাতে পৌঁছাবে না এবং কোনও লক্ষ্য প্রতিক্রিয়া সময় মেট্রিক্স লগ করা হয় না।

API সিনট্যাক্স: avg(target_response_time)

মোট প্রতিক্রিয়া সময় মোট_প্রতিক্রিয়া_সময় যোগফল, গড়, সর্বনিম্ন, সর্বোচ্চ

সময়ের পরিমাণ (সমষ্টি, গড়, সর্বনিম্ন বা সর্বোচ্চ), মিলিসেকেন্ডে , যখন এজ একটি ক্লায়েন্টের কাছ থেকে একটি অনুরোধ পায় তখন থেকে এজ ক্লায়েন্টের কাছে প্রতিক্রিয়া ফেরত পাঠায়। সময়ের মধ্যে রয়েছে নেটওয়ার্ক ওভারহেড (যেমন লোড ব্যালেন্সার এবং রাউটারগুলিকে তাদের কাজ করতে যে সময় লাগে), অনুরোধ প্রক্রিয়াকরণ লেটেন্সি, রেসপন্স প্রসেসিং লেটেন্সি এবং টার্গেট রেসপন্স টাইম (যদি ক্যাশের পরিবর্তে টার্গেট সার্ভিস থেকে রেসপন্স দেওয়া হয়)।

বিভিন্ন মাত্রা ব্যবহার করে, আপনি API প্রক্সি, ডেভেলপার অ্যাপ, অঞ্চল ইত্যাদির মাধ্যমে প্রসেসিং লেটেন্সি পরীক্ষা করতে পারেন।

API সিনট্যাক্স: avg(total_response_time)

ট্রাফিক বার্তা_গণনা যোগফল

নির্দিষ্ট সময়ের মধ্যে এজ দ্বারা প্রসেস করা মোট API কলের সংখ্যা।

আপনার কাছে সবচেয়ে অর্থপূর্ণ উপায়ে ট্রাফিক গণনাগুলিকে গোষ্ঠীভুক্ত করতে মাত্রা ব্যবহার করুন৷

API সিনট্যাক্স: sum(message_count)

মাত্রা

মাত্রা আপনাকে অর্থপূর্ণ গ্রুপিং-এ মেট্রিক্স দেখতে দেয়। উদাহরণস্বরূপ, যখন আপনি প্রতিটি বিকাশকারী অ্যাপ বা API প্রক্সির জন্য সেগুলি দেখেন তখন মোট ট্র্যাফিকের সংখ্যা দেখা আরও শক্তিশালী হয়ে ওঠে।

Apigee বাক্সের বাইরে যে মাত্রাগুলি প্রদান করে তা নিম্নরূপ। উপরন্তু, আপনি কাস্টম বিশ্লেষণ ব্যবহার করে API বার্তা সামগ্রী বিশ্লেষণে বর্ণিত হিসাবে আপনার নিজস্ব মাত্রা তৈরি করতে পারেন।

কাস্টম রিপোর্টের নাম ব্যবস্থাপনা API-তে ব্যবহার করার জন্য নাম বর্ণনা
Apigee সত্তা
অ্যাক্সেস টোকেন অ্যাক্সেস_টোকেন অ্যাপটি শেষ ব্যবহারকারীর OAuth অ্যাক্সেস টোকেন।
API পণ্য api_product

API প্রক্সিগুলি ধারণকারী API পণ্যের নাম বলা হচ্ছে। এই মাত্রা পাওয়ার জন্য, কল করা ডেভেলপার অ্যাপগুলিকে অবশ্যই এক বা একাধিক API পণ্যের সাথে যুক্ত হতে হবে যেগুলিতে API প্রক্সি রয়েছে এবং কল করা প্রক্সিগুলিকে অবশ্যই API কলের সাথে পাঠানো একটি API কী বা OAuth টোকেন পরীক্ষা করতে হবে৷ কী বা টোকেন একটি API পণ্যের সাথে যুক্ত। আরও তথ্যের জন্য, প্রথম জিনিসগুলি দেখুন: সম্পূর্ণ বিশ্লেষণ ডেটা কীভাবে তৈরি করা যায়

উপরের মানদণ্ড পূরণ না হলে, আপনি "( সেট নয়)" মান দেখতে পাবেন৷ আরও দেখুন একটি বিশ্লেষণ সত্তা মান "(সেট নয়)" মানে কি? .

ক্যাশে কী ax_cache_key

প্রতিক্রিয়া ক্যাশে মান সম্বলিত কী যা অ্যাক্সেস করা হয়েছিল। প্রতিক্রিয়া ক্যাশের জন্য কী কীভাবে তৈরি করা হয় সে সম্পর্কে আরও তথ্যের জন্য, প্রতিক্রিয়া ক্যাশে নীতি দেখুন।

ট্রেস টুলে , যখন আপনি একটি রেসপন্স ক্যাশে নীতি নির্বাচন করেন যা ক্যাশে থেকে পড়া বা লেখা হয়েছে, আপনি responsecache.cachekey ফ্লো ভেরিয়েবলে এই মানটি দেখতে পাবেন।

ক্যাশে নাম ax_cache_name

orgName__envName__ এর সাথে প্রিফিক্সযুক্ত রেসপন্স ক্যাশে নীতি দ্বারা ব্যবহৃত কী/মান সমন্বিত ক্যাশের নাম। উদাহরণস্বরূপ, যদি org "foo" হয়, তাহলে পরিবেশটি "পরীক্ষা" এবং ক্যাশের নাম "myCache", ax_cache_name foo__test__myCache।

ট্রেস টুলে , আপনি যখন একটি রেসপন্স ক্যাশে নীতি নির্বাচন করেন, তখন আপনি responsecache.cachename ফ্লো ভেরিয়েবলে এই মানটি দেখতে পাবেন।

ক্যাশে উৎস ax_cache_source

ক্যাশে স্তর ("L1" ইন-মেমরি বা "L2" ডাটাবেস) যেখান থেকে প্রতিক্রিয়া ক্যাশে পুনরুদ্ধার করা হয়েছিল৷ এই মাত্রাটি "CACHE_MISS"ও দেখায় যখন ক্যাশের পরিবর্তে লক্ষ্য থেকে প্রতিক্রিয়া প্রদান করা হয়েছিল (এবং লক্ষ্য প্রতিক্রিয়ার সাথে প্রতিক্রিয়া ক্যাশে রিফ্রেশ করা হয়েছিল); অথবা যখন অনুরোধে একটি ক্যাশে কী অবৈধ। ক্যাশে কী 2 KB আকারে সীমাবদ্ধ।

ট্রেস টুলে , আপনি যখন রেসপন্স ক্যাশে নীতি নির্বাচন করেন, তখন আপনি responsecache.cachesource ফ্লো ভেরিয়েবলে এই মানটি দেখতে পাবেন।

ক্যাশে স্তর সম্পর্কে আরও তথ্যের জন্য, ক্যাশে অভ্যন্তরীণ দেখুন।

ক্লায়েন্ট আইডি ক্লায়েন্ট_আইডি

API কল করে ডেভেলপার অ্যাপের কনজিউমার কী (API কী), অনুরোধে API কী হিসেবে পাস করা হোক বা OAuth টোকেনে অন্তর্ভুক্ত হোক।

এই মাত্রা পেতে, কল গ্রহণকারী প্রক্সিগুলিকে অবশ্যই একটি বৈধ API কী বা OAuth টোকেন চেক করতে কনফিগার করতে হবে৷ বিকাশকারী অ্যাপগুলি এপিআই কীগুলি পায়, যেটি অ্যাপগুলি এজ-এ নিবন্ধিত হলে OAuth টোকেন তৈরি করতে ব্যবহার করা যেতে পারে। আরও তথ্যের জন্য, প্রথম জিনিসগুলি দেখুন: সম্পূর্ণ বিশ্লেষণ ডেটা কীভাবে তৈরি করা যায়

উপরের মানদণ্ড পূরণ না হলে, আপনি "( সেট নয়)" মান দেখতে পাবেন৷ আরও দেখুন একটি বিশ্লেষণ সত্তা মান "(সেট নয়)" মানে কি? .

বিকাশকারী অ্যাপ বিকাশকারী_অ্যাপ

এজ-নিবন্ধিত ডেভেলপার অ্যাপ এপিআই কল করে।

এই মাত্রা পাওয়ার জন্য, অ্যাপগুলিকে এক বা একাধিক API পণ্যের সাথে যুক্ত হতে হবে যেগুলিতে API প্রক্সিগুলিকে কল করা হচ্ছে এবং প্রক্সিগুলিকে অবশ্যই API কলের সাথে পাঠানো একটি API কী বা OAuth টোকেন পরীক্ষা করতে হবে৷ কী বা টোকেন ডেভেলপার অ্যাপকে শনাক্ত করে। আরও তথ্যের জন্য, প্রথম জিনিসগুলি দেখুন: সম্পূর্ণ বিশ্লেষণ ডেটা কীভাবে তৈরি করা যায়

উপরের মানদণ্ড পূরণ না হলে, আপনি "( সেট নয়)" মান দেখতে পাবেন৷ আরও দেখুন একটি বিশ্লেষণ সত্তা মান "(সেট নয়)" মানে কি? .

বিকাশকারী ইমেল বিকাশকারী_ইমেল

এজ-নিবন্ধিত ডেভেলপারদের ইমেল যাদের অ্যাপ API কল করেছে।

এই মাত্রা পেতে, ডেভেলপারদের অবশ্যই এক বা একাধিক API পণ্যের সাথে যুক্ত অ্যাপ থাকতে হবে যেগুলিতে API প্রক্সি কল করা হচ্ছে এবং প্রক্সিগুলিকে অবশ্যই API কলের সাথে পাঠানো একটি API কী বা OAuth টোকেন পরীক্ষা করতে হবে। কী বা টোকেন ডেভেলপার অ্যাপকে শনাক্ত করে। আরও তথ্যের জন্য, প্রথম জিনিসগুলি দেখুন: সম্পূর্ণ বিশ্লেষণ ডেটা কীভাবে তৈরি করা যায়

উপরের মানদণ্ড পূরণ না হলে, আপনি "( সেট নয়)" মান দেখতে পাবেন৷ এছাড়াও দেখুন একটি বিশ্লেষণ সত্তা মান "(সেট নয়)" মানে কি? .

বিকাশকারী আইডি বিকাশকারী

org_name @@@ unique_id আকারে অনন্য এজ-জেনারেটেড ডেভেলপার আইডি।

এই মাত্রা পাওয়ার জন্য, ডেভেলপারদের অবশ্যই এক বা একাধিক API পণ্যের সাথে যুক্ত অ্যাপ থাকতে হবে যেখানে API প্রক্সিগুলিকে কল করা হচ্ছে এবং প্রক্সিগুলিকে অবশ্যই API কলগুলির সাথে পাঠানো একটি API কী বা OAuth টোকেন পরীক্ষা করতে হবে৷ কী বা টোকেন বিকাশকারীকে সনাক্ত করে। আরও তথ্যের জন্য, প্রথম জিনিসগুলি দেখুন: সম্পূর্ণ বিশ্লেষণ ডেটা কীভাবে তৈরি করা যায়

উপরের মানদণ্ড পূরণ না হলে, আপনি "( সেট নয়)" মান দেখতে পাবেন৷ এছাড়াও দেখুন একটি বিশ্লেষণ সত্তা মান "(সেট নয়)" মানে কি? .

পরিবেশ পরিবেশ এজ পরিবেশ যেখানে API প্রক্সি স্থাপন করা হয়। উদাহরণস্বরূপ, "পরীক্ষা" বা "প্রোড"।
ত্রুটির উপর ফল্ট কোড ax_edge_execution_fault_code

ত্রুটির ফল্ট কোড . যেমন: messaging.adaptors.http.flow.GatewayTimeout

ত্রুটির উপর প্রবাহের নাম ax_execution_fault
_প্রবাহ_নাম

একটি API প্রক্সিতে নামযুক্ত প্রবাহ যা একটি ত্রুটি উত্থাপন করেছে৷ উদাহরণস্বরূপ, "প্রিফ্লো," "পোস্টফ্লো" বা আপনার তৈরি করা শর্তসাপেক্ষ প্রবাহের নাম।

মনে রাখবেন যে ম্যানেজমেন্ট API-এ ব্যবহার করার জন্য সম্পূর্ণ নামটি হল ax_execution_fault_flow_name, লাইন বিরতি ছাড়াই।

যেখানে কোনও ত্রুটি ঘটেনি, আপনি "(সেট নয়)" মানটি দেখতে পাবেন।

ফ্লো রিসোর্স প্রবাহ_সম্পদ Apigee শুধুমাত্র ব্যবহার. আপনি যদি আগ্রহী হন তবে এই সম্প্রদায় পোস্টটি দেখুন।
ত্রুটির উপর প্রবাহ অবস্থা ax_execution_fault
_ফ্লো_স্টেট

API প্রক্সি প্রবাহের নাম বলে যে ত্রুটিগুলি উত্থাপিত হয়েছে, যেমন "PROXY_REQ_FLOW" বা "TARGET_RESP_FLOW৷"

মনে রাখবেন যে ম্যানেজমেন্ট এপিআই-এ ব্যবহার করার পুরো নামটি হল ax_execution_fault_flow_state, লাইন বিরতি ছাড়াই।

গেটওয়ে ফ্লো আইডি গেটওয়ে_ফ্লো_আইডি এপিআই কলগুলি এজ এর মধ্য দিয়ে যাওয়ার সাথে সাথে প্রতিটি কল তার নিজস্ব গেটওয়ে ফ্লো আইডি পায়। উদাহরণ: rrt329ea-12575-114653952-1। গেটওয়ে ফ্লো আইডি উচ্চ-টিপিএস পরিস্থিতিতে মেট্রিকগুলিকে আলাদা করার জন্য দরকারী যেখানে অন্যান্য মাত্রা যেমন সংগঠন, পরিবেশ এবং টাইমস্ট্যাম্প কল জুড়ে অভিন্ন।
সংগঠন সংগঠন এজ সংস্থা যেখানে API প্রক্সিগুলি স্থাপন করা হয়৷
ত্রুটির উপর নীতির নাম ax_execution_fault
_নীতি_নাম

নীতির নাম যা একটি ত্রুটি ছুঁড়েছে এবং API কল ব্যর্থ হয়েছে৷

মনে রাখবেন যে ম্যানেজমেন্ট API-এ ব্যবহার করার জন্য সম্পূর্ণ নামটি হল ax_execution_fault_policy_name, লাইন বিরতি ছাড়াই।

যদি একটি নীতি একটি ত্রুটি থ্রো করে কিন্তু নীতির মূল বৈশিষ্ট্য continueOnError true সেট করা হয়, API প্রক্সি ফ্লো ব্যর্থতা ছাড়াই চলতে থাকে এবং নীতি ব্যর্থতা এই মাত্রায় গণনা করা হয় না৷

প্রক্সি এপিপ্রক্সি একটি API প্রক্সির মেশিনের নাম (প্রদর্শনের নাম নয়)।
প্রক্সি বেস পাথ proxy_basepath

এপিআই প্রক্সি প্রক্সিএন্ডপয়েন্টে বেসপাথ কনফিগার করা হয়েছে। বেস পাথ API প্রক্সি URL এর ডোমেন এবং পোর্ট অংশ অন্তর্ভুক্ত করে না। উদাহরণস্বরূপ, যদি একটি API প্রক্সির ভিত্তি URL হয় https://apigeedocs-test.apigee.net/releasenotes/, বেস পাথ হল /releasenotes।

মানটি proxy.basepath ফ্লো ভেরিয়েবলেও সংরক্ষিত থাকে।

প্রক্সি পাথ প্রত্যয় proxy_pathsuffix

এপিআই প্রক্সি বেস পাথে রিসোর্স পাথ যোগ করা হয়েছে। উদাহরণস্বরূপ, যদি একটি API প্রক্সির বেস URL হয় https://apigeedocs-test.apigee.net/hello/ , এবং একটি কল করা হয় https://apigeedocs-test.apigee.net/hello/json , তাহলে পাথসফিক্স হল /json

যদি কোনো পাথসফিক্স ব্যবহার না করা হয়, তাহলে মানটি খালি থাকে।

মানটি proxy.pathsuffix ফ্লো ভেরিয়েবলেও সংরক্ষণ করা হয়।

প্রক্সি রিভিশন apiproxy_revision API প্রক্সির সংশোধন নম্বর যা API কলগুলি পরিচালনা করে। এটি অগত্যা একটি API প্রক্সির সর্বশেষ সংশোধন মানে না। যদি একটি API প্রক্সিতে 10টি সংশোধন থাকে, তাহলে 8ম সংশোধন বর্তমানে স্থাপন করা হতে পারে। এছাড়াও, একটি API-তে একাধিক রিভিশন মোতায়েন থাকতে পারে যতক্ষণ পর্যন্ত রিভিশনের বিভিন্ন বেস পাথ থাকে, যেমনটি UI-তে প্রক্সি স্থাপনে বর্ণিত হয়েছে।
সমাধানকৃত ক্লায়েন্ট আইপি ax_resolved_client_ip

মূল ক্লায়েন্ট আইপি ঠিকানা রয়েছে। ax_resolved_client_ip মাত্রার মান ax_true_client_ip এবং x_forwarded_for_ip মাত্রার মান থেকে গণনা করা হয়।

নোট করুন যে ক্লায়েন্টদের সত্যিকারের আইপি অ্যাড্রেস ক্যাপচার করার জন্য আকামাইয়ের মতো রাউটিং পণ্য ব্যবহার করার সময়, ক্লায়েন্ট আইপি HTTP হেডার True-Client-IP এ এজ-এ পাস করা হয়, যা তারপর ax_true_client_ip ডাইমেনশন সেট করতে ব্যবহৃত হয়।

ax_resolved_client_ip মাত্রার মান নিম্নরূপ গণনা করা হয়:

  1. যদি ax_true_client_ip শূন্য না হয় এবং একটি স্থানীয় IP ঠিকানা না থাকে, তাহলে ax_resolved_client_ip ax_true_client_ip তে সেট করুন।
  2. অন্যথায়, x_forwarded_for_ip এ প্রথম অ-স্থানীয় IP ঠিকানায় ax_resolved_client_ip সেট করুন।
  3. যদি ax_true_client_ip এবং x_forwarded_for_ip উভয়েই শুধুমাত্র স্থানীয় IP ঠিকানা থাকে, তাহলে x_forwarded_for_ip এ প্রথম স্থানীয় IP ঠিকানায় ax_resolved_client_ip সেট করুন।
  4. যদি ax_true_client_ip এবং x_forwarded_for_ip উভয়ই শূন্য হয়, তাহলে ax_resolved_client_ip তে সেট করুন (not set)
  5. যদি ax_true_client_ip একটি স্থানীয় IP ঠিকানা হয় এবং x_forwarded_for_ip শূন্য হয়, তাহলে ax_resolved_client_ip তে সেট করুন (not set)
প্রতিক্রিয়া স্থিতি কোড প্রতিক্রিয়া_স্থিতি_কোড HTTP প্রতিক্রিয়া স্ট্যাটাস কোড Apigee থেকে ক্লায়েন্টের কাছে ফরোয়ার্ড করা হয়েছে, যেমন 200, 404, 503, ইত্যাদি। এজ-এ, টার্গেট থেকে রেসপন্স স্ট্যাটাস কোড অ্যাসাইন মেসেজ এবং রেইজ ফল্টের মতো নীতি দিয়ে ওভাররাইট করা যেতে পারে, যে কারণে এই মাত্রা টার্গেট রেসপন্স কোড (target_response_code) থেকে আলাদা হতে পারে।
ভার্চুয়াল হোস্ট ভার্চুয়াল_হোস্ট ভার্চুয়াল হোস্টের নামে API কল করা হয়েছিল। উদাহরণস্বরূপ, সংস্থাগুলির ডিফল্টরূপে দুটি ভার্চুয়াল হোস্ট রয়েছে: default (http) এবং secure (https)।
অন্তর্মুখী/ক্লায়েন্ট
ক্লায়েন্ট আইপি ঠিকানা ক্লায়েন্ট_আইপি সিস্টেমের IP ঠিকানা যা রাউটারে আঘাত করে, যেমন মূল ক্লায়েন্ট (proxy_client_ip) বা লোড ব্যালেন্সার। যখন X-Forwarded-For হেডারে একাধিক আইপি থাকে, তখন এটি তালিকাভুক্ত শেষ আইপি।
ডিভাইস বিভাগ ax_ua_device_category যে ধরনের ডিভাইস থেকে API কল করা হয়েছিল, যেমন "ট্যাবলেট" বা "স্মার্টফোন"।
ওএস পরিবার ax_ua_os_family কল করা ডিভাইসের অপারেটিং সিস্টেম পরিবার, যেমন "Android" বা "iOS"।
ওএস সংস্করণ ax_ua_os_version

কল করা ডিভাইসের অপারেটিং সিস্টেম সংস্করণ।

অপারেটিং সিস্টেমগুলির সংস্করণগুলি দেখতে OS Family (ax_ua_os_family) এর সাথে এটিকে দ্বিতীয় "ড্রিল-ডাউন" মাত্রা হিসাবে ব্যবহার করা দরকারী।

প্রক্সি ক্লায়েন্ট আইপি proxy_client_ip

কলিং ক্লায়েন্টের IP ঠিকানা, proxy.client.ip ফ্লো ভেরিয়েবলে সংরক্ষিত। এটি প্রায়শই ইনবাউন্ড কলের X-Forwarded-For ঠিকানা হয়, যা শেষ বাহ্যিক TCP হ্যান্ডশেক থেকে প্রাপ্ত IP ঠিকানা প্রান্ত। এটি কলিং ক্লায়েন্ট বা লোড ব্যালেন্সার হতে পারে। যখন X-Forwarded-For হেডারে একাধিক আইপি থাকে, তখন এটি তালিকাভুক্ত শেষ আইপি।

উল্লেখিত ক্লায়েন্ট আইপি ax_true_client_ip

ক্লায়েন্টদের সত্যিকারের আইপি অ্যাড্রেস ক্যাপচার করতে Akamai-এর মতো রাউটিং পণ্য ব্যবহার করার সময়, ক্লায়েন্ট আইপিগুলিকে HTTP হেডার True-Client-IP এ এজ-এ পাস করা হয়। এই মাত্রা সেই হেডার থেকে সেই সত্যিকারের ক্লায়েন্ট আইপিগুলিকে ক্যাপচার করে।

ax_resolved_client_ip ডাইমেনশনের মাধ্যমে অ্যাক্সেস করা আসল ক্লায়েন্ট আইপি অ্যাড্রেস নির্ধারণ করতে, এজ ax_true_client_ip এবং x_forwarded_for_ip মাত্রা ব্যবহার করে।

অনুরোধ পাথ অনুরোধ_পথ

রিসোর্স পাথ (ডোমেন সহ নয়) টার্গেট সার্ভিসে, কোয়েরি প্যারামিটার বাদ দিয়ে।

উদাহরণস্বরূপ, Apigee নমুনা লক্ষ্য http://mocktarget.apigee.net /user সহ বেশ কিছু সংস্থান রয়েছে, যা একটি শুভেচ্ছা প্রদান করে। আপনার API প্রক্সি http://mocktarget.apigee.net/user যেভাবে কল করুক না কেন, request_path হল /user

URI অনুরোধ করুন অনুরোধ_উরি

রিসোর্স পাথ (ডোমেন সহ নয়) টার্গেট সার্ভিসে, কোয়েরি প্যারামিটার সহ।

উদাহরণ স্বরূপ, Apigee নমুনা টার্গেট http://mocktarget.apigee.net প্রদত্ত নামের একটি কাস্টম অভিবাদন ফেরত দেওয়ার জন্য /user?user={name} রিসোর্স এবং ক্যোয়ারী প্যারামিটার সহ বেশ কয়েকটি সংস্থান অন্তর্ভুক্ত করে। আপনার API প্রক্সি http://mocktarget.apigee.net/user?user=Dude যেভাবে কল করুক না কেন, request_uri হল /user?user=Dude

Request Verb অনুরোধ_ক্রিয়া API অনুরোধে HTTP অনুরোধ ক্রিয়া, যেমন GET, POST, PUT, DELETE।
ব্যবহারকারী এজেন্ট ব্যবহারকারী

API কল করতে ব্যবহৃত ব্যবহারকারী এজেন্ট বা সফ্টওয়্যার এজেন্টের নাম। উদাহরণ:

  • একটি 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
  • 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 Mobile" বা "cURL"।
ব্যবহারকারী এজেন্ট প্রকার ax_ua_agent_type ইউজারজেন্ট টাইপ, যেমন "ব্রাউজার," "মোবাইল ব্রাউজার," "লাইব্রেরি" ইত্যাদি।
ব্যবহারকারী এজেন্ট সংস্করণ ax_ua_agent_version

ব্যবহারকারীর সংস্করণ.

এজেন্ট পরিবারের সংস্করণ পেতে ব্যবহারকারী এজেন্ট ফ্যামিলি (ax_ua_agent_family) এর সাথে এটিকে দ্বিতীয় "ড্রিল-ডাউন" মাত্রা হিসাবে ব্যবহার করা দরকারী।

আউটবাউন্ড/টার্গেট
টার্গেট বেস পাথ লক্ষ্য_বেসপথ

রিসোর্স পাথ (ডোমেন সহ নয়) টার্গেট সার্ভিসে, ক্যোয়ারী প্যারামিটার বাদ দিয়ে, যেটি প্রক্সির <TargetEndpoint> এ সংজ্ঞায়িত করা হয়েছে।

উদাহরণস্বরূপ, বলুন একটি API প্রক্সি নিম্নলিখিত লক্ষ্যকে কল করে:

<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>

লক্ষ্য_বেসপথটি শূন্য হবে।

ট্রেস টুলে , যখন আপনি ফ্লো ডায়াগ্রামের শেষে AX আইকন নির্বাচন করেন, target.basepath ফ্লো ভেরিয়েবল মানচিত্র টার্গেট_বেসপাথ ডাইমেনশনে।

লক্ষ্য হোস্ট টার্গেট_হোস্ট টার্গেট সার্ভিসের হোস্ট। উদাহরণস্বরূপ, যদি একটি API প্রক্সি http://mocktarget.apigee.net/help কল করে, তাহলে target_host হল mocktarget.apigee.net
লক্ষ্য আইপি ঠিকানা লক্ষ্য_আইপি টার্গেট সার্ভিসের IP ঠিকানা API প্রক্সিতে প্রতিক্রিয়া প্রদান করে।
টার্গেট রেসপন্স কোড লক্ষ্য_প্রতিক্রিয়া_কোড

HTTP প্রতিক্রিয়া স্ট্যাটাস কোড টার্গেট পরিষেবা দ্বারা API প্রক্সিতে ফেরত দেওয়া হয়েছে, যেমন 200, 404, 503, ইত্যাদি।

"নাল" এর একটি মান মানে অনুরোধটি কখনই লক্ষ্য পরিষেবাতে পৌঁছায় না। এটি ঘটে যখন প্রতিক্রিয়া ক্যাশে নীতি দ্বারা প্রতিক্রিয়া পরিবেশন করা হয় বা যখন অনুরোধ প্রক্রিয়াকরণে ব্যর্থ হয়।

এটি রেসপন্স স্ট্যাটাস কোড (response_status_code) মাত্রার চেয়ে আলাদা।

লক্ষ্য URL লক্ষ্য_ইউআরএল

একটি API প্রক্সির TargetEndpoint-এ সংজ্ঞায়িত লক্ষ্য পরিষেবার সম্পূর্ণ URL।

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

এই উদাহরণে, target_url হল http://mocktarget.apigee.net/user?user=Dude

লক্ষ্য করুন যে URL-কে API প্রক্সি প্রক্রিয়াকরণের সময় target.url ফ্লো ভেরিয়েবলের সাথে ওভাররাইড করা যেতে পারে।

প্রক্সি চেইনিংয়ে এবং স্ক্রিপ্ট টার্গেট (Node.js) ব্যবহার করার সময়, কলিং প্রক্সিতে target_url শূন্য থাকে।

এক্স ফরওয়ার্ড করা হয়েছে x_forwarded_for_ip

X-Forwarded-For শিরোনামে আইপি ঠিকানার তালিকা।

ax_resolved_client_ip ডাইমেনশনের মাধ্যমে অ্যাক্সেস করা আসল ক্লায়েন্ট আইপি অ্যাড্রেস নির্ধারণ করতে, এজ ax_true_client_ip এবং x_forwarded_for_ip মাত্রা ব্যবহার করে।

সময়
সপ্তাহের দিন ax_s_day_of_week সপ্তাহের তিন-অক্ষরের দিনটির সংক্ষিপ্ত রূপ যেখানে API কলগুলি করা হয়েছিল৷ যেমন সোম, মঙ্গল, বুধ।
মাস ax_month_of_year যে সাংখ্যিক মাসে API কলগুলি করা হয়েছিল৷ উদাহরণস্বরূপ, মার্চের জন্য "03"।
দিনের সময় ax_hour_of_day

24-ঘন্টা ঘড়ির উপর ভিত্তি করে, 2-সংখ্যার ঘন্টা যেখানে API কল করা হয়েছিল। উদাহরণস্বরূপ, রাত 10pm থেকে 11pm এর মধ্যে একটি ঘন্টায় করা API কল, ax_hour_of_day হবে 22।

সময়ের মান UTC-তে রয়েছে।

টাইম জোন ax_geo_timezone টাইম জোনগুলির সাধারণ নাম যেগুলি থেকে API কল করা হয়েছিল, যেমন আমেরিকা/নিউইয়র্ক এবং ইউরোপ/ডাবলিন।
মাসের সপ্তাহ মাসের_সপ্তাহ মাসের সংখ্যাসূচক সপ্তাহ। উদাহরণস্বরূপ, এক মাসের 3য় সপ্তাহে করা API কলগুলির জন্য, ax_week_of_month হল 3।
অবস্থান
শহর ax_geo_city যে শহর থেকে API কল করা হয়েছিল।
মহাদেশ ax_geo_continent মহাদেশের দুই-অক্ষরের কোড যেখান থেকে API কল করা হয়েছে। উদাহরণস্বরূপ, উত্তর আমেরিকার জন্য NA।
দেশ ax_geo_country যে দেশ থেকে API কল করা হয়েছে তার দুই-অক্ষরের কোড। উদাহরণস্বরূপ, মার্কিন যুক্তরাষ্ট্রের জন্য মার্কিন যুক্তরাষ্ট্র।
ভৌগলিক অঞ্চল ax_geo_region ভৌগলিক অঞ্চলের জন্য হাইফেনযুক্ত কোড, যেমন STATE-COUNTRY৷ উদাহরণস্বরূপ, ওয়াশিংটন-যুক্তরাষ্ট্রের জন্য WA-US।
অঞ্চল ax_dn_region Apigee ডেটা সেন্টারের নাম যেখানে API প্রক্সি স্থাপন করা হয়, যেমন us-east-1।
নগদীকরণ
মিন্ট লেনদেন উপেক্ষা বার্তা x_apigee_mint_tx_ignoreMessage পতাকা যা নগদীকরণ সম্পর্কিত বার্তাগুলিকে উপেক্ষা করবে কিনা তা নির্দিষ্ট করে৷ সমস্ত নগদীকরণ সংস্থার জন্য false সেট করুন৷
মিন্ট লেনদেনের অবস্থা x_apigee_mint_tx_status একটি নগদীকরণ অনুরোধের স্থিতি, যেমন সাফল্য, ব্যর্থতা, অবৈধ, বা কিছুই নয়৷

ফিল্টার

ফিল্টারগুলি আপনাকে নির্দিষ্ট বৈশিষ্ট্যের সাথে মেট্রিক্সে ফলাফল সীমাবদ্ধ করতে দেয়। নিচে কিছু নমুনা ফিল্টার দেওয়া হল। ফিল্টার সংজ্ঞায়িত করার সময় মেট্রিক এবং মাত্রা API-স্টাইল নাম ব্যবহার করুন।

নামের বই বা সঙ্গীত সহ API প্রক্সিগুলির জন্য মেট্রিক্স প্রদান করে:

filter=(apiproxy in 'books','music')

"m" দিয়ে শুরু হওয়া নামের সাথে API প্রক্সিগুলির জন্য মেট্রিক্স প্রদান করে:

filter=(apiproxy like 'm%')

API প্রক্সিগুলির জন্য মেট্রিক্স প্রদান করে যার নাম "m" দিয়ে শুরু হয় না:

filter=(apiproxy not like 'm%')

400 এবং 599 এর মধ্যে প্রতিক্রিয়া স্ট্যাটাস কোড সহ API কলগুলির জন্য মেট্রিক্স প্রদান করে:

filter=(response_status_code ge 400 and response_status_code le 599)

200 এর রেসপন্স স্ট্যাটাস কোড এবং 404 এর টার্গেট রেসপন্স কোড সহ API কলের জন্য মেট্রিক্স প্রদান করে:

filter=(response_status_code eq 200 and target_response_code eq 404)

500 এর প্রতিক্রিয়া স্ট্যাটাস কোড সহ API কলগুলির জন্য মেট্রিক্স প্রদান করে:

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 এর মতই যে এটি একটি রেগুলার এক্সপ্রেশনের SQL স্ট্যান্ডার্ডের সংজ্ঞা ব্যবহার করে প্যাটার্নটিকে ব্যাখ্যা করে।
not similar to এর প্যাটার্ন প্রদত্ত স্ট্রিংয়ের সাথে মেলে কিনা তার উপর নির্ভর করে মিথ্যা বা সত্য প্রদান করে। এটি একটি নিয়মিত অভিব্যক্তির SQL স্ট্যান্ডার্ডের সংজ্ঞা ব্যবহার করে প্যাটার্নটি ব্যাখ্যা not like
and একাধিক ফিল্টার এক্সপ্রেশন অন্তর্ভুক্ত করতে আপনাকে 'এবং' যুক্তি ব্যবহার করতে দেয়। ফিল্টারটি এমন ডেটা অন্তর্ভুক্ত করে যা সমস্ত শর্ত পূরণ করে।
or বিভিন্ন সম্ভাব্য ফিল্টার এক্সপ্রেশন মূল্যায়ন করতে আপনাকে 'বা' যুক্তি ব্যবহার করতে দেয়। ফিল্টারটি এমন ডেটা অন্তর্ভুক্ত করে যা কমপক্ষে একটি শর্ত পূরণ করে।