ট্রেস টুল ব্যবহার করে

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

ট্রেস টুল কি?

Apigee Edge এ চলমান API প্রক্সিগুলির সমস্যা সমাধান ও নিরীক্ষণের জন্য ট্রেস একটি টুল। ট্রেস আপনাকে API প্রক্সি প্রবাহের মাধ্যমে প্রতিটি ধাপের বিশদ অনুসন্ধান করতে দেয়।

কিভাবে ট্রেস ব্যবহার করবেন

ট্রেস ব্যবহার করা সহজ। আপনি একটি ট্রেস সেশন শুরু করুন, তারপর এজ প্ল্যাটফর্মে একটি API কল করুন এবং ফলাফলগুলি পড়ুন।

1. API প্রক্সি পৃষ্ঠা অ্যাক্সেস করুন, নীচে বর্ণিত হিসাবে।
   

   প্রান্ত

   এজ UI ব্যবহার করে API প্রক্সি পৃষ্ঠা অ্যাক্সেস করতে:

   1. apigee.com/edge এ সাইন ইন করুন।
   2. বাম নেভিগেশন বারে বিকাশ > API প্রক্সি নির্বাচন করুন।

   ক্লাসিক এজ (ব্যক্তিগত ক্লাউড)

   ক্লাসিক এজ UI ব্যবহার করে API প্রক্সি পৃষ্ঠা অ্যাক্সেস করতে:

   1. http:// ms-ip :9000 এ সাইন ইন করুন, যেখানে ms-ip হল ম্যানেজমেন্ট সার্ভার নোডের IP ঠিকানা বা DNS নাম।
   2. শীর্ষ নেভিগেশন বারে APIs > API প্রক্সি নির্বাচন করুন।
2. API প্রক্সি পৃষ্ঠা থেকে একটি API প্রক্সি নির্বাচন করুন।
3. আপনি যে APIটি ট্রেস করতে চান সেটি স্থাপন করা হয়েছে তা নিশ্চিত করুন।
4. ট্রেস টুল ভিউতে যেতে ট্রেসে ক্লিক করুন।
5. আপনি কোন স্থাপনার পরিবেশ এবং প্রক্সি রিভিশন ট্রেস করতে চান তা নির্বাচন করতে ডিপ্লয়মেন্ট টু ট্রেস ড্রপডাউন মেনু ব্যবহার করুন।
6. স্টার্ট ট্রেস সেশন ক্লিক করুন। যখন ট্রেস সেশন সক্রিয় থাকে, তখন API প্রক্সি প্রক্রিয়াকরণ পাইপলাইনের প্রতিটি ধাপের বিবরণ রেকর্ড করে। ট্রেস সেশন চলাকালীন, বার্তা এবং প্রাসঙ্গিক ডেটা লাইভ ট্র্যাফিক থেকে ক্যাপচার করা হয়।
   

   

7. যদি আপনার প্রক্সির মাধ্যমে প্রবাহিত কোনো লাইভ ট্র্যাফিক না থাকে, তাহলে কেবল API এ একটি অনুরোধ পাঠান। আপনি অনুরোধ পাঠাতে চান যে কোনো টুল ব্যবহার করতে পারেন, যেমন কার্ল, পোস্টম্যান, বা কোনো পরিচিত টুল। অথবা, আপনি ট্রেস টুল থেকে সরাসরি অনুরোধ পাঠাতে পারেন। শুধু URL লিখুন এবং Send এ ক্লিক করুন। দ্রষ্টব্য: আপনি শুধুমাত্র ট্রেস টুল থেকে একটি GET অনুরোধ পাঠাতে পারেন, কিন্তু একটি POST অনুরোধ নয়৷
   
   দ্রষ্টব্য: একটি ট্রেস সেশন নির্বাচিত API প্রক্সির মাধ্যমে বার্তা প্রসেসর প্রতি 10টি অনুরোধ/প্রতিক্রিয়া লেনদেন সমর্থন করতে পারে। এজ ক্লাউডে, ট্রাফিক পরিচালনাকারী 2টি বার্তা প্রসেসর সহ, 20টি অনুরোধ/প্রতিক্রিয়া লেনদেন সমর্থিত। একটি ট্রেস সেশন 10 মিনিটের পরে স্বয়ংক্রিয়ভাবে বন্ধ হয়ে যায় যদি আপনি ম্যানুয়ালি এটি বন্ধ না করেন।
   
8. আপনি পর্যাপ্ত সংখ্যক অনুরোধ ক্যাপচার করলে, স্টপ ট্রেস সেশন ক্লিক করুন।
9. ক্যাপচার করা অনুরোধ/প্রতিক্রিয়া লেনদেনের একটি তালিকা বাম মেনুতে প্রদর্শিত হয়। বিস্তারিত ফলাফল দেখতে যেকোনো লেনদেনের উপর ক্লিক করুন।

কিভাবে একটি ট্রেস পড়া

ট্রেস টুলের দুটি প্রধান অংশ রয়েছে, লেনদেনের মানচিত্র এবং ফেজের বিবরণ:

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

লেবেলযুক্ত প্রধান প্রক্সি প্রসেসিং সেগমেন্ট সহ এখানে একটি নমুনা ট্রেস টুল ম্যাপ রয়েছে:

ট্রেস টুল এর লেনদেন মানচিত্র

লেনদেন মানচিত্র কিংবদন্তি

নিচের সারণীটি লেনদেনের মানচিত্রে যে আইকনগুলি দেখতে পাবেন তার উদ্দেশ্য বর্ণনা করে। এই আইকনগুলি প্রক্সি ফ্লো জুড়ে প্রতিটি উল্লেখযোগ্য প্রক্রিয়াকরণ ধাপ চিহ্নিত করে।

লেনদেন মানচিত্র আইকন

	ক্লায়েন্ট অ্যাপ যেটি API প্রক্সির ProxyEndpoint-এ একটি অনুরোধ পাঠায়।
	চেনাশোনাগুলি প্রক্সি প্রবাহে ট্রানজিশনাল এন্ডপয়েন্টগুলিকে চিহ্নিত করে৷ যখন ক্লায়েন্টের কাছ থেকে একটি অনুরোধ আসে, যখন অনুরোধটি লক্ষ্যে যায়, যখন লক্ষ্য থেকে প্রতিক্রিয়া ফিরে আসে এবং যখন প্রতিক্রিয়াটি ক্লায়েন্টের কাছে ফিরে যায় তখন তারা সেখানে থাকে।
	লম্বা বারগুলি API প্রক্সি ফ্লোতে একটি ফ্লো সেগমেন্টের শুরু নির্দেশ করে৷ ফ্লো সেগমেন্টগুলি হল: ProxyEndpoint অনুরোধ, TargetEndpoint অনুরোধ, TargetEndpoint প্রতিক্রিয়া এবং ProxyEndpoint প্রতিক্রিয়া। একটি সেগমেন্টের মধ্যে রয়েছে প্রিফ্লো, কন্ডিশনাল ফ্লো এবং পোস্টফ্লো। আরও তথ্যের জন্য প্রবাহ কনফিগার করা দেখুন।
	ইঙ্গিত করে যে অ্যানালিটিক্স অ্যাকশনগুলি ব্যাকগ্রাউন্ডে ঘটেছে৷
	একটি শর্তাধীন প্রবাহ যা সত্যে মূল্যায়ন করে। শর্তসাপেক্ষ প্রবাহের ভূমিকার জন্য, প্রবাহ কনফিগার করা দেখুন। মনে রাখবেন কিছু শর্ত এজ-জেনারেটেড। উদাহরণস্বরূপ, নিম্নলিখিত একটি অভিব্যক্তি যা এজ প্রক্সিএন্ডপয়েন্টে একটি ত্রুটি ঘটেছে কিনা তা পরীক্ষা করতে ব্যবহার করে: ((error.state equals PROXY_REQ_FLOW) or (error.state equals PROXY_RESP_FLOW))
	একটি শর্তাধীন প্রবাহ যা মিথ্যাতে মূল্যায়ন করে। শর্তসাপেক্ষ প্রবাহের ভূমিকার জন্য, প্রবাহ কনফিগার করা দেখুন। মনে রাখবেন কিছু শর্ত এজ-জেনারেটেড। উদাহরণস্বরূপ, নিম্নলিখিত একটি অভিব্যক্তি যা এজ টার্গেটএন্ডপয়েন্টে একটি ত্রুটি ঘটেছে কিনা তা পরীক্ষা করতে ব্যবহার করে: (((error.state equals TARGET_REQ_FLOW) or (error.state equals TARGET_RESP_FLOW)) or ((error.state equals REQ_SENT) or (error.state equals RESP_START)))
	নীতিমালা। প্রতিটি ধরনের নীতির একটি অনন্য আইকন আছে। এটি একটি AssignMessage নীতির জন্য। এই আইকনগুলি আপনাকে দেখতে দেয় যেখানে নীতিগুলি সঠিক ক্রমে কার্যকর করা হয় এবং সেগুলি সফল হয় কি না৷ আপনি একটি পলিসি আইকনে ক্লিক করে সেটির বাস্তবায়নের ফলাফল দেখতে পারেন এবং সেগুলি প্রত্যাশিত কি না। উদাহরণস্বরূপ, আপনি দেখতে পারেন যে বার্তাটি সঠিকভাবে রূপান্তরিত হয়েছে কিনা বা এটি ক্যাশে করা হচ্ছে কিনা। সঠিকভাবে নীতি নির্বাহ করা চেক-মার্ক দ্বারা স্পষ্টভাবে নির্দেশিত হয়। ত্রুটির ক্ষেত্রে, একটি লাল বিস্ময়বোধক চিহ্ন আইকনে প্রদর্শিত হয়। পরামর্শ: কোনো নীতি প্রত্যাশিত সময়ের চেয়ে বেশি সময় নিচ্ছে কিনা তা দেখতে টুলটিপ বা টাইম লাইনে মনোযোগ দিন।
	ব্যাকএন্ড লক্ষ্য একটি Node.js অ্যাপ্লিকেশন হলে উপস্থিত হয়। Apigee Edge-এ Node.js-এর ওভারভিউ দেখুন।
	API প্রক্সি দ্বারা কল করা ব্যাকএন্ড লক্ষ্য।
	সময়রেখা নির্দেশ করে যে প্রক্রিয়াকরণের সময়টি সম্পূর্ণ হতে কতক্ষণ (মিলিসেকেন্ডে) লেগেছিল। অতিবাহিত সময়ের সেগমেন্টগুলির তুলনা করা আপনাকে সেই নীতিগুলিকে আলাদা করতে সাহায্য করে যেগুলি কার্যকর করতে সবচেয়ে বেশি সময় নেয় যা আপনার API কলগুলিকে ধীর করে দিচ্ছে৷
	এপসিলন একটি মিলিসেকেন্ডের চেয়ে ছোট একটি সময়কাল নির্দেশ করে।
	অক্ষম। যখন একটি নীতি অক্ষম করা হয় তখন একটি নীতি আইকনে প্রদর্শিত হয়৷ একটি নীতি সর্বজনীন API দিয়ে নিষ্ক্রিয় করা যেতে পারে। API প্রক্সি কনফিগারেশন রেফারেন্স দেখুন।
	ত্রুটি পলিসি স্টেপ কন্ডিশন মিথ্যা হলে ( ফ্লো ভেরিয়েবল এবং শর্ত দেখুন) বা RaiseFault পলিসি কার্যকর হলে RaiseFault পলিসি আইকনে প্রদর্শিত হয়।
	এড়িয়ে গেছে। নীতিটি কার্যকর না হলে একটি নীতি আইকনে প্রদর্শিত হবে কারণ ধাপের শর্তটি মিথ্যা হিসাবে মূল্যায়ন করা হয়েছে৷ আরও তথ্যের জন্য ফ্লো ভেরিয়েবল এবং শর্তাবলী দেখুন।

ফেজ বিস্তারিত বোঝা

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

ফিল্টার ব্যবহার করে বার্তা ক্যাপচার পরিশোধন

আপনি শিরোনাম এবং/অথবা ক্যোয়ারী প্যারামিটার মান নির্দিষ্ট করে ট্রেস টুলে কোন অনুরোধগুলি দেখানো হবে তা ফিল্টার করতে পারেন। ফিল্টারগুলি আপনাকে নির্দিষ্ট কলগুলিকে লক্ষ্য করতে সক্ষম করে যা সমস্যার কারণ হতে পারে। উদাহরণ স্বরূপ, নির্দিষ্ট বিষয়বস্তু বা নির্দিষ্ট অংশীদার বা অ্যাপ থেকে আসা অনুরোধে আপনাকে শূন্য করতে হতে পারে। আপনি ফিল্টার করতে পারেন:

• HTTP শিরোনাম - শুধুমাত্র একটি নির্দিষ্ট শিরোনাম আছে এমন কলগুলিতে ট্রেস সীমাবদ্ধ করুন। এটি আপনাকে সমস্যা সমাধানে সহায়তা করার একটি ভাল উপায়। আপনি আপনার অ্যাপ বিকাশকারীকে একটি শিরোনাম পাঠাতে পারেন এবং সমস্যা সৃষ্টিকারী কলটিতে এটি অন্তর্ভুক্ত করতে বলতে পারেন। তারপর Apigee Edge শুধুমাত্র সেই নির্দিষ্ট হেডারের সাথে কল রেকর্ড করবে যাতে আপনি ফলাফলগুলি পরীক্ষা করতে পারেন।
• ক্যোয়ারী প্যারামিটার - শুধুমাত্র একটি প্যারামিটারের একটি নির্দিষ্ট মান সহ কল ​​রেকর্ড করা হবে।

ফিল্টার বৈশিষ্ট্য সম্পর্কে আপনার যা জানা দরকার

• ফিল্টার ক্ষেত্রগুলিতে ফিল্টার পরামিতিগুলি নির্দিষ্ট করার পরে আপনাকে অবশ্যই আপনার ট্রেস সেশন পুনরায় চালু করতে হবে।
• ফিল্টার পরামিতি একসাথে AND'ed হয়। একটি সফল মিলের অনুরোধে সমস্ত নির্দিষ্ট ক্যোয়ারী এবং/অথবা হেডারের নাম/মান পেয়ার উপস্থিত থাকতে হবে।
• ফিল্টার টুলে প্যাটার্ন ম্যাচিং সমর্থিত নয়।
• ফিল্টার প্যারামিটার এবং মানগুলি কেস সংবেদনশীল।

কীভাবে একটি ট্রেস ফিল্টার তৈরি করবেন

1. যদি একটি ট্রেস সেশন চলছে, তাহলে স্টপ ট্রেস সেশন ক্লিক করে এটি বন্ধ করুন।
2. ফিল্টার ক্ষেত্রটি প্রসারিত করতে ট্রেস টুলের উপরের-বাম কোণে ফিল্টারগুলিতে ক্লিক করুন।
   
   
   
3. ফিল্টার ক্ষেত্রে, আপনি যে ক্যোয়ারী প্যারামিটার এবং/অথবা হেডার মানগুলি ফিল্টার করতে চান তা নির্দিষ্ট করুন। এই উদাহরণে, আমরা ফিল্টার করার জন্য দুটি ক্যোয়ারী প্যারামিটার নির্দিষ্ট করি। একটি সফল ম্যাচের অনুরোধে উভয় প্যারামিটার অবশ্যই উপস্থিত থাকতে হবে।
   
   
   
4. ট্রেস সেশন শুরু করুন।
5. আপনার API কল করুন. শুধুমাত্র সেই সব অনুরোধ যাতে নির্দিষ্ট হেডার(গুলি) এবং/অথবা ক্যোয়ারী প্যারামিটার(গুলি) অন্তর্ভুক্ত থাকে একটি সফল মিল তৈরি করে৷

উপরের উদাহরণে, এই API কল ট্রেসে প্রদর্শিত হবে:

http://docs-test.apigee.net/cats?name=Penny&breed=Calico

কিন্তু এটি হবে না:

http://docs-test.apigee.net/cats?name=Penny

ট্রেস দিয়ে ডিবাগিং

ট্রেস আপনাকে একটি API প্রক্সি সম্পর্কে অনেক অভ্যন্তরীণ বিবরণ দেখতে দেয়। যেমন:

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

ভিউ অপশন নির্বাচন করা

ট্রেস সেশনের জন্য ভিউ অপশন বেছে নিন।

ট্রেস ফলাফল ডাউনলোড করা হচ্ছে

আপনি টেক্সট এডিটরে অফলাইনে দেখতে এবং অনুসন্ধান করার জন্য কাঁচা ট্রেস ফলাফলের একটি XML ফাইল ডাউনলোড করতে পারেন। ফাইলটি সমস্ত শিরোনাম, ভেরিয়েবল এবং নীতির বিষয়বস্তু সহ শোনার সেশনের সম্পূর্ণ বিবরণ দেখায়।

ডাউনলোড করতে, ডাউনলোড ট্রেস সেশন ক্লিক করুন।

কার্ল হিসাবে অনুরোধ দেখানো হচ্ছে

আপনি একটি টার্গেট সার্ভারে করা একটি API কল ট্রেস করার পরে, আপনি একটি কার্ল কমান্ড হিসাবে অনুরোধটি দেখতে পারেন। এটি কয়েকটি কারণে ডিবাগিংয়ের জন্য বিশেষভাবে কার্যকর:

• এপিআই প্রক্সি অনুরোধটি পরিবর্তন করতে পারে, তাই প্রক্সি থেকে লক্ষ্য সার্ভারের অনুরোধটি আসল অনুরোধ থেকে কীভাবে আলাদা তা দেখতে এটি কার্যকর। কার্ল কমান্ড পরিবর্তিত অনুরোধের প্রতিনিধিত্ব করে।
• বৃহত্তর বার্তা পেলোডের জন্য, কার্ল আপনাকে একক স্থানে HTTP শিরোনাম এবং বার্তা সামগ্রী দেখতে দেয়। (বর্তমানে প্রায় 1,000 অক্ষরের একটি সীমা রয়েছে। এই সীমা অতিক্রম করার জন্য একটি টিপের জন্য, এই সম্প্রদায় পোস্টটি দেখুন।)

নিরাপত্তার জন্য, কার্ল বৈশিষ্ট্য HTTP অনুমোদন শিরোনাম মাস্ক.

ট্রেসে এপিআই কল আসার পরে অনুরোধগুলিকে কার্ল হিসাবে দেখতে, লেনদেন মানচিত্র চিত্রে "অনুরোধ পাঠানো হয়েছে টার্গেট সার্ভারে" পর্যায়টি নির্বাচন করুন, তারপরে ফেজের বিবরণে "টার্গেট সার্ভারে পাঠানো অনুরোধ" কলামে কার্ল প্রদর্শন করুন বোতামে ক্লিক করুন। ফলক

Apigee সমর্থন ট্রেস ব্যবহার

ডিফল্টরূপে, Apigee Edge Apigee Support কে আপনার API প্রক্সিতে ট্রেস টুল ব্যবহার করতে সহায়তা প্রদানের অনুমতি দেয়। আপনি যেকোনো সময় এই বিকল্পটি অক্ষম করতে পারেন। যাইহোক, এই বিকল্পটি নিষ্ক্রিয় করলে Apigee সাপোর্টের আপনাকে সহায়তা প্রদানের ক্ষমতা সীমিত হতে পারে।

ট্রেস টুল ব্যবহার করে Apigee সমর্থন নিষ্ক্রিয় করতে:

1. https://apigee.com/edge- এ সাইন ইন করুন।
2. বাম নেভিগেশন বারে অ্যাডমিন > গোপনীয়তা এবং নিরাপত্তা নির্বাচন করুন।
3. Apigee Support দ্বারা ট্রেস টুলের ব্যবহার নিষ্ক্রিয় করতে Apigee Support to Trace টগল সক্ষম করুন ক্লিক করুন।