আপনি Apigee Edge-এর ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশন .info- তে যান।
আপনি Apigee X ডকুমেন্টেশন দেখছেন।
Apigee Edge-এর ডকুমেন্টেশন দেখুন।
সাপোর্ট কেসে বিস্তারিত এবং প্রয়োজনীয় তথ্য প্রদান করলে গুগল ক্লাউড এপিজি সাপোর্ট টিমের পক্ষে আপনাকে দ্রুত এবং দক্ষতার সাথে উত্তর দেওয়া সহজ হয়। যখন আপনার সাপোর্ট কেসে গুরুত্বপূর্ণ বিবরণ অনুপস্থিত থাকে, তখন আমাদের আরও তথ্য চাইতে হয়, যার জন্য একাধিকবার আলোচনা করার প্রয়োজন হতে পারে। এতে বেশি সময় লাগে এবং সমস্যার সমাধানে বিলম্ব হতে পারে। এই বেস্ট প্র্যাকটিসেস গাইডটি আপনাকে সেই তথ্যগুলো সম্পর্কে জানায় যা আপনার টেকনিক্যাল সাপোর্ট কেসটি দ্রুত সমাধান করার জন্য আমাদের প্রয়োজন।
সমস্যাটির বর্ণনা
একটি ইস্যুতে কী ঘটেছে এবং কী ঘটার কথা ছিল তার বিশদ বিবরণ, সেইসাথে কখন ও কীভাবে এটি ঘটেছে, তা ব্যাখ্যা করা উচিত। একটি ভালো Apigee সাপোর্ট কেসে প্রতিটি Apigee প্রোডাক্টের জন্য নিম্নলিখিত মূল তথ্যগুলো থাকা উচিত:
| মূল তথ্য | বর্ণনা | পাবলিক ক্লাউডের জন্য Apigee Edge | প্রাইভেট ক্লাউডের জন্য Apigee Edge |
|---|---|---|---|
| পণ্য | যে নির্দিষ্ট Apigee প্রোডাক্টে সমস্যাটি দেখা যাচ্ছে, প্রযোজ্য ক্ষেত্রে ভার্সনের তথ্যসহ। |
| |
| সমস্যার বিবরণ | সমস্যার একটি স্পষ্ট ও বিস্তারিত বিবরণ দিন, যেখানে সমস্যাটি তুলে ধরা হবে এবং যদি কোনো ত্রুটির বার্তা থাকে, তবে সেটিও অন্তর্ভুক্ত করতে হবে। |
|
|
| সময় | সমস্যাটি ঠিক কখন শুরু হয়েছিল এবং কতক্ষণ স্থায়ী হয়েছিল তার নির্দিষ্ট সময়। |
|
|
| সেটআপ | সমস্যাটি কোথায় দেখা যাচ্ছে তার বিস্তারিত তথ্য। |
|
|
পরবর্তী অধ্যায়গুলোতে এই ধারণাগুলো আরও বিশদভাবে বর্ণনা করা হয়েছে।
পণ্য
Apigee-এর বিভিন্ন প্রোডাক্ট রয়েছে, যেমন পাবলিক ক্লাউডে Apigee Edge এবং প্রাইভেট ক্লাউডে Apigee Edge , তাই ঠিক কোন প্রোডাক্টটিতে সমস্যাটি হচ্ছে সে সম্পর্কে আমাদের সুনির্দিষ্ট তথ্য প্রয়োজন।
নিচের সারণিতে করণীয় (DOs) কলামে সম্পূর্ণ তথ্য এবং বর্জনীয় (DON'Ts) কলামে অসম্পূর্ণ তথ্য দেখানো হয়েছে:
| DOs | বর্জনীয় |
|---|---|
আমাদের পাবলিক ক্লাউড অর্গে API প্রক্সি OAuth2 স্থাপন ব্যর্থ হয়েছে... | এপিআই প্রক্সি স্থাপন ব্যর্থ হয়েছে আমাদের জানতে হবে আপনি Apigee-এর কোন প্রোডাক্টটিতে সমস্যাটি দেখতে পাচ্ছেন। |
| আমাদের এজ প্রাইভেট ক্লাউড সংস্করণ 4.50.00- এ নিম্নলিখিত ত্রুটির কারণে ইনস্টলেশন ব্যর্থ হয়েছে... | আমাদের প্রাইভেট ক্লাউড সেটআপে ইনস্টলেশন ব্যর্থ হয়েছে। (সংস্করণের তথ্য অনুপস্থিত) |
সমস্যার বিবরণ
পর্যবেক্ষণকৃত সমস্যা সম্পর্কে সুনির্দিষ্ট তথ্য প্রদান করুন, যার মধ্যে ত্রুটির বার্তা (যদি থাকে) এবং প্রত্যাশিত ও প্রকৃত আচরণ অন্তর্ভুক্ত থাকবে।
নিচের সারণিতে করণীয় (DOs) কলামে সম্পূর্ণ তথ্য এবং বর্জনীয় (DON'Ts) কলামে অসম্পূর্ণ তথ্য দেখানো হয়েছে:
| DOs | বর্জনীয় |
|---|---|
নতুন | আজ তৈরি করা নতুন (প্রক্সির নামটি অজানা। প্রক্সিটি কোনো ত্রুটি বা অপ্রত্যাশিত প্রতিক্রিয়া ফেরত দিচ্ছে কিনা তা স্পষ্ট নয়।) |
এপিআই প্রক্সিতে অনুরোধ করার সময় আমাদের ক্লায়েন্টরা নিম্নলিখিত ত্রুটি বার্তা সহ | এপিআই প্রক্সিতে অনুরোধ করার সময় আমাদের ক্লায়েন্টরা (শুধু |
সময়
সময় একটি অত্যন্ত গুরুত্বপূর্ণ তথ্য। আপনি কখন প্রথম এই সমস্যাটি লক্ষ্য করেছেন, এটি কতক্ষণ স্থায়ী ছিল এবং সমস্যাটি এখনও চলছে কিনা, তা সাপোর্ট ইঞ্জিনিয়ারের জানা জরুরি।
যে সাপোর্ট ইঞ্জিনিয়ার সমস্যাটির সমাধান করছেন, তিনি হয়তো আপনার টাইমজোনে নেই, তাই সময় সম্পর্কে আপেক্ষিক তথ্য দিলে সমস্যাটি নির্ণয় করা কঠিন হয়ে পড়ে। এই কারণে, সমস্যাটি কখন দেখা গিয়েছিল তার সঠিক সময় জানানোর জন্য তারিখ ও সময় স্ট্যাম্পে ISO 8601 ফরম্যাট ব্যবহার করার পরামর্শ দেওয়া হয়।
নিম্নলিখিত সারণিতে কিছু উদাহরণ দেওয়া হয়েছে, যেখানে 'করণীয়' (DOs) কলামে সমস্যাটি ঘটার সঠিক সময় ও সময়কাল এবং 'অকরণীয়' (DON'Ts) কলামে সমস্যাটি কখন ঘটেছিল সে সম্পর্কে অস্পষ্ট বা অনির্দিষ্ট তথ্য দেখানো হয়েছে:
| DOs | বর্জনীয় |
|---|---|
গতকাল 2020-11-06 17:30 PDT এবং 2020-11-06 17:35 PDT- এর মধ্যে বিপুল সংখ্যক 503s লক্ষ্য করা গেছে... | গতকাল বিকেল ৫:৩০ মিনিটে ৫ মিনিটের জন্য বিপুল সংখ্যক (আমরা অনুমিত তারিখটি ব্যবহার করতে বাধ্য হচ্ছি এবং এই সমস্যাটি কোন টাইমজোনে পরিলক্ষিত হয়েছিল, তাও স্পষ্ট নয়।) |
| ২০২০-১১-০৯ ১৫:৩০ IST থেকে ২০২০-১১-০৯ ১৮:১০ IST পর্যন্ত নিম্নলিখিত API প্রক্সিগুলিতে উচ্চ লেটেন্সি পরিলক্ষিত হয়েছিল... | গত সপ্তাহে কিছু এপিআই প্রক্সিতে উচ্চ লেটেন্সি লক্ষ্য করা গেছে। (গত সপ্তাহে কোন দিন এবং কত সময় ধরে এই সমস্যাটি দেখা গিয়েছিল তা স্পষ্ট নয়।) |
সেটআপ
আপনি ঠিক কোথায় সমস্যাটি দেখতে পাচ্ছেন, সে সম্পর্কে আমাদের বিস্তারিত জানতে হবে। আপনি যে পণ্যটি ব্যবহার করছেন, তার উপর নির্ভর করে আমাদের নিম্নলিখিত তথ্যগুলো প্রয়োজন:
- আপনি যদি Apigee Cloud ব্যবহার করেন, তাহলে আপনার একাধিক অর্গানাইজেশন থাকতে পারে, তাই আপনি ঠিক কোন অর্গানাইজেশন এবং অন্যান্য ক্ষেত্রে সমস্যাটি লক্ষ্য করছেন, তা আমাদের জানা প্রয়োজন।
- সংগঠন এবং পরিবেশের নাম
- এপিআই প্রক্সি নাম এবং রিভিশন নম্বর (এপিআই অনুরোধ ব্যর্থ হলে)
- আপনি যদি প্রাইভেট ক্লাউড ব্যবহার করেন, তাহলে আপনি হয়তো অনেকগুলো সমর্থিত ইনস্টলেশন টপোলজির মধ্যে একটি ব্যবহার করছেন। তাই, আপনি কোন টপোলজি ব্যবহার করছেন তা আমাদের জানা প্রয়োজন, যার মধ্যে ডেটা সেন্টার এবং নোডের সংখ্যার মতো বিস্তারিত তথ্যও অন্তর্ভুক্ত থাকবে।
নিচের সারণিতে করণীয় (DOs) কলামে সম্পূর্ণ তথ্য এবং বর্জনীয় (DON'Ts) কলামে অসম্পূর্ণ তথ্য দেখানো হয়েছে:
| DOs | বর্জনীয় |
|---|---|
২০২০-১১-০৬ ০৯:৩০ CST থেকে এজ পাবলিক ক্লাউডে এজ সেটআপের বিবরণ: ব্যর্থ হওয়া এপিআই-টির বিবরণ নিম্নরূপ: ত্রুটি: | (এটি ব্যবহৃত পণ্য, সমস্যাটি কবে থেকে দেখা যাচ্ছে বা সেটআপের কোনো বিবরণ সম্পর্কে কোনো তথ্য দেয় না।) |
অতিরিক্ত গেটওয়ে নোড যোগ করার পর এজ প্রাইভেট ক্লাউড সংস্করণ 4.19.06- এ মেসেজ প্রসেসর চালু করা সম্ভব হচ্ছে না। ডায়াগনস্টিক লগ: নেটওয়ার্ক টপোলজি: | অতিরিক্ত গেটওয়ে নোড যোগ করার পর এজ প্রাইভেট ক্লাউড সংস্করণ 4.19.06- এ মেসেজ প্রসেসর চালু করা সম্ভব হচ্ছে না। (মেসেজ প্রসেসর লগ এবং নেটওয়ার্ক টপোলজি অনুপস্থিত।) |
দরকারী নিদর্শন
সমস্যা-সম্পর্কিত প্রমাণাদি আমাদের প্রদান করলে এর সমাধান দ্রুত হবে, কারণ এটি আমাদের আপনার পর্যবেক্ষণ করা সঠিক আচরণটি বুঝতে এবং এ বিষয়ে আরও গভীর অন্তর্দৃষ্টি লাভ করতে সাহায্য করে।
এই বিভাগে কিছু দরকারি আর্টিফ্যাক্ট বর্ণনা করা হয়েছে যা Apigee-এর সকল পণ্যের জন্য সহায়ক:
Apigee-র সকল পণ্যের জন্য সাধারণ আর্টিফ্যাক্ট
নিম্নলিখিত আর্টিফ্যাক্টগুলি সকল Apigee প্রোডাক্টের জন্য উপযোগী: Apigee Edge on Public Cloud এবং Apigee Edge on Private Cloud :
| প্রত্নবস্তু | বর্ণনা |
|---|---|
| ট্রেস টুল আউটপুট | ট্রেস টুলের আউটপুটে Apigee প্রোডাক্টগুলোর মধ্য দিয়ে প্রবাহিত API রিকোয়েস্টগুলো সম্পর্কে বিস্তারিত তথ্য থাকে। এটি 4XX , 5XX মতো যেকোনো রানটাইম এরর এবং ল্যাটেন্সি সমস্যার ক্ষেত্রে সহায়ক। |
| স্ক্রিনশট | স্ক্রিনশট পর্যবেক্ষণ করা প্রকৃত আচরণ বা ত্রুটির প্রেক্ষাপট তুলে ধরতে সাহায্য করে। এটি UI বা অ্যানালিটিক্সের মতো ক্ষেত্রে দেখা যাওয়া যেকোনো ত্রুটি বা সমস্যার জন্য সহায়ক। |
| HAR (Http ARchive) | HAR হলো এমন একটি ফাইল যা যেকোনো UI সম্পর্কিত সমস্যা ডিবাগ করার জন্য HTTP সেশন টুল দ্বারা ক্যাপচার করা হয়। এটি Chrome, Firefox বা Internet Explorer-এর মতো ব্রাউজার ব্যবহার করে ক্যাপচার করা যেতে পারে। |
tcpdumps | tcpdump টুলটি নেটওয়ার্কের মাধ্যমে আদান-প্রদান হওয়া TCP/IP প্যাকেটগুলো ক্যাপচার করে। এটি TLS হ্যান্ডশেক ব্যর্থতা, 502 এরর, এবং ল্যাটেন্সি সমস্যা ইত্যাদির মতো যেকোনো নেটওয়ার্ক-সম্পর্কিত সমস্যার জন্য উপযোগী। |
Apigee Edge for Private Cloud-এর জন্য অতিরিক্ত আর্টিফ্যাক্ট
Apigee Edge for Private Cloud-এর ক্ষেত্রে, আমাদের কিছু অতিরিক্ত আর্টিফ্যাক্টের প্রয়োজন হতে পারে যা সমস্যাগুলি দ্রুত নির্ণয় করতে সহায়তা করবে।
| প্রত্নবস্তু | বর্ণনা |
|---|---|
| নেটওয়ার্ক টপোলজি | এজ ইনস্টলেশন টপোলজি ডায়াগ্রাম, যা আপনার প্রাইভেট ক্লাউড সেটআপের বর্ণনা দেয় এবং এতে সমস্ত ডেটা সেন্টার, নোড এবং প্রতিটি নোডে ইনস্টল করা উপাদানগুলো অন্তর্ভুক্ত থাকে। |
| এজ কম্পোনেন্ট ডায়াগনস্টিক লগ | নির্দিষ্ট Apigee Edge কম্পোনেন্ট, যেমন Message Processor, Router, বা Cassandra-এর সাথে সম্পর্কিত ডায়াগনস্টিক লগ। |
| ইনস্টলেশন কনফিগারেশন ফাইল | Apigee Edge ইনস্টল বা আপগ্রেড করার সময় ব্যবহৃত সাইলেন্ট কনফিগারেশন ফাইল। ইনস্টলেশন বা মাইগ্রেশন সংক্রান্ত সমস্যা দেখা দিলে, সমস্ত সেটিংস সঠিক আছে কিনা তা যাচাই করার জন্য এই ফাইলটি কার্যকর। |
| হিপ ডাম্প | হিপ ডাম্প হলো জাভা মেমরি প্রসেসের একটি স্ন্যাপশট। নির্দিষ্ট Edge কম্পোনেন্টগুলিতে উচ্চ মেমরি ব্যবহার বা OutOfMemory ত্রুটি দেখা গেলে এটি সহায়ক হয়। |
| থ্রেড ডাম্প | থ্রেড ডাম্প হলো একটি চলমান জাভা প্রসেসের সমস্ত থ্রেডের একটি স্ন্যাপশট। নির্দিষ্ট কিছু এজ কম্পোনেন্টে উচ্চ সিপিইউ বা লোড পরিলক্ষিত হলে এটি সহায়ক। |
মামলার টেমপ্লেট এবং নমুনা মামলা
এই বিভাগে এই নথিতে বর্ণিত সর্বোত্তম অনুশীলনের উপর ভিত্তি করে বিভিন্ন পণ্যের জন্য কেস টেমপ্লেট এবং নমুনা কেস প্রদান করা হয়েছে:
পাবলিক ক্লাউডে Apigee Edge
টেমপ্লেট
এই বিভাগে পাবলিক ক্লাউডে Apigee Edge- এর জন্য একটি নমুনা টেমপ্লেট দেওয়া হয়েছে।
সমস্যা:
আপনার প্রান্তে যে সমস্যা বা আচরণটি পরিলক্ষিত হচ্ছে তার বিস্তারিত বিবরণ দিন। প্রযোজ্য ক্ষেত্রে পণ্যের নাম এবং সংস্করণ উল্লেখ করুন।
ত্রুটি বার্তা:
<দেখা যাওয়া সম্পূর্ণ ত্রুটির বার্তাটি অন্তর্ভুক্ত করুন (যদি থাকে)>
সমস্যা শুরুর সময় (আইএসও ৮৬০১ ফরম্যাট):
সমস্যার সমাপ্তির সময় (আইএসও ৮৬০১ ফরম্যাট):
Apigee সেটআপের বিবরণ:
সংস্থার নাম:
পরিবেশের নাম:
এপিআই প্রক্সি নামসমূহ:
সংশোধন সংখ্যা:
পুনরাবৃত্তি করার ধাপসমূহ:
<সম্ভব হলে সমস্যাটি পুনরায় ঘটানোর ধাপগুলো উল্লেখ করুন>
রোগ নির্ণয় সংক্রান্ত তথ্য:
<সংযুক্ত ফাইলগুলোর তালিকা>
নমুনা ঘটনা
এই বিভাগে Apigee Cloud (Apigee on Google Cloud/Apigee Edge on Public Cloud)-এর জন্য একটি নমুনা কেস প্রদান করা হয়েছে।
সমস্যা:
আমরা আমাদের পাবলিক ক্লাউড অর্গে প্রচুর পরিমাণে 503 সার্ভিস আনঅ্যাভেইলেবল এরর দেখতে পাচ্ছি। আপনি কি অনুগ্রহ করে বিষয়টি খতিয়ে দেখে এর সমাধান করবেন, অথবা কীভাবে এটি সমাধান করা যায় সে বিষয়ে আমাদের পরামর্শ দেবেন?
ত্রুটি বার্তা:
{"fault":{"faultstring":"The Service is temporarily available", "detail":{"errorcode":"messaging.adaptors.http.flow.ServiceUnavailable"}}}সমস্যা শুরুর সময় (ISO 8601 ফর্ম্যাট): 2020-10-04 06:30 IST
সমস্যার সমাপ্তির সময় (আইএসও ৮৬০১ ফরম্যাট): সমস্যাটি এখনও বিদ্যমান।
Apigee ক্লাউড সেটআপের বিবরণ:
সংস্থার নাম: myorg
পরিবেশের নাম: dev
এপিআই প্রক্সি নাম: myproxy
সংশোধন সংখ্যা: 3
পুনরাবৃত্তি করার ধাপসমূহ:
সমস্যাটি পুনরুৎপাদন করতে নিম্নলিখিত curl কমান্ডটি চালান:
curl -X GET 'https://myorg-dev.apigee.net/v1/myproxy'
রোগ নির্ণয় সংক্রান্ত তথ্য:
ট্রেস টুলের আউটপুট ( trace-503.xml )
প্রাইভেট ক্লাউডের জন্য Apigee Edge
টেমপ্লেট
এই বিভাগে প্রাইভেট ক্লাউডের জন্য Apigee Edge- এর একটি নমুনা টেমপ্লেট দেওয়া হয়েছে।
সমস্যা:
আপনার প্রান্তে যে সমস্যা বা আচরণটি পরিলক্ষিত হচ্ছে তার বিস্তারিত বিবরণ দিন। প্রযোজ্য ক্ষেত্রে পণ্যের নাম এবং সংস্করণ উল্লেখ করুন।
ত্রুটি বার্তা:
<দেখা যাওয়া সম্পূর্ণ ত্রুটির বার্তাটি অন্তর্ভুক্ত করুন (যদি থাকে)>
সমস্যা শুরুর সময় (আইএসও ৮৬০১ ফরম্যাট):
সমস্যার সমাপ্তির সময় (আইএসও ৮৬০১ ফরম্যাট):
এজ প্রাইভেট ক্লাউড সেটআপের বিবরণ:
আপনার প্রাইভেট ক্লাউডের ডেটা সেন্টার এবং নোডসহ নেটওয়ার্ক টপোলজি সংযুক্ত করুন।
পুনরাবৃত্তি করার ধাপসমূহ:
<সম্ভব হলে সমস্যাটি পুনরায় ঘটানোর ধাপগুলো উল্লেখ করুন>
রোগ নির্ণয়ের তথ্য
<সংযুক্ত ফাইলগুলোর তালিকা>
নমুনা ঘটনা
এই বিভাগে প্রাইভেট ক্লাউডের জন্য Apigee Edge-এর একটি নমুনা কেস উপস্থাপন করা হয়েছে।
সমস্যা:
Linux RHEL 7.6 -এ Edge Private Cloud 4.19.06- এর অংশ হিসেবে Node #10-এ Apigee Management Server ইনস্টল করার সময় আমরা নিম্নলিখিত ত্রুটির সম্মুখীন হচ্ছি।
ত্রুটি বার্তা:
<snipped as the output is too long>
Checking for management-server uuid ................................................
Unable to get uuid for management-server.
Error: setup.sh: /opt/apigee/apigee-service/bin/apigee-service exited with unexpected status 1সমস্যা শুরুর সময় (ISO 8601 ফরম্যাট): যখনই আমরা ইনস্টল করি তখনই এটি ঘটে।
সমস্যার সমাপ্তির সময় (আইএসও ৮৬০১ ফরম্যাট): প্রযোজ্য নয়
এজ প্রাইভেট ক্লাউড সেটআপের বিবরণ:
network-topology.png ফাইলটি সংযুক্ত করা হয়েছে।
পুনরাবৃত্তি করার ধাপসমূহ:
এই সেই কমান্ড যা উপরের ত্রুটিটির কারণ হয়েছিল:
/opt/apigee/apigee-setup/bin/setup.sh -p ms -f /app/NonProdConfig.txt
রোগ নির্ণয় সংক্রান্ত তথ্য:
নিম্নলিখিত ফাইলগুলো সংযুক্ত করা হলো:
-
output.txtত্রুটির বার্তাসহ উপরোক্ত কমান্ডের সম্পূর্ণ আউটপুট - ম্যানেজমেন্ট সার্ভার লগ এবং
- কনফিগারেশন ফাইল
NonProdConfig.txt