Google Cloud Apigee সহায়তা সংক্রান্ত কেসের জন্য পেশাদার পদ্ধতি

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

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

সহায়তা সংক্রান্ত কেসে বিস্তারিত ও প্রয়োজনীয় তথ্য প্রদান করলে, Google Cloud Apigee সহায়তা টিমের পক্ষে আপনাকে দ্রুত ও দক্ষতার সাথে উত্তর দেওয়া সহজ হয়ে যায়। আপনার সহায়তা কেসে গুরুত্বপূর্ণ বিবরণ না থাকলে, আমাদের আরও তথ্য জানতে চাইতে হয়, এর জন্য একাধিকবার যোগাযোগ করতে হতে পারে। এর ফলে বেশি সময় লাগে এবং সমস্যা সমাধানে দেরি হতে পারে। এই সেরা পেশাদার পদ্ধতি সংক্রান্ত নির্দেশিকা থেকে আপনি জানতে পারবেন যে আপনার টেকনিক্যাল সহায়তা সংক্রান্ত কেস দ্রুত সমাধান করার জন্য আমাদের কী কী তথ্য প্রয়োজন।

সমস্যার বিবরণ দেওয়া

সমস্যাতে কী ঘটেছে এবং কী ঘটার কথা ছিল, সেই বিষয়ে বিস্তারিত তথ্য থাকতে হবে। এছাড়াও, কখন এবং কীভাবে এটি ঘটেছে, সেই বিষয়েও তথ্য থাকতে হবে। ভাল Apigee সহায়তা কেসে প্রতিটি Apigee প্রোডাক্টের জন্য নিম্নলিখিত মূল তথ্য থাকতে হবে:

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

নিচের বিভাগে এইসব ধারণা আরও বিস্তারিতভাবে বর্ণনা করা হয়েছে।

প্রোডাক্ট

বিভিন্ন Apigee প্রোডাক্ট আছে, পাবলিক ক্লাউডে Apigee Edge এবং প্রাইভেট ক্লাউডে Apigee Edge, তাই কোন নির্দিষ্ট প্রোডাক্টে সমস্যা হচ্ছে সেই সম্পর্কে আমাদের নির্দিষ্ট তথ্য প্রয়োজন।

নিচের সারণীতে কী কী করা উচিত কলামে সম্পূর্ণ তথ্য এবং কী কী করা উচিত নয় কলামে অসম্পূর্ণ তথ্য দেখানো হয়েছে:

কী কী করা উচিত কী করবেন না
আমাদের পাবলিক ক্লাউড org-এ API প্রক্সি OAuth2 ডেপ্লয় করা যায়নি ...

API প্রক্সি ডিপ্লয় করা যায়নি

(আপনি কোন Apigee প্রোডাক্টে সমস্যাটি দেখতে পাচ্ছেন তা আমাদের জানতে হবে।)

আমাদের Edge প্রাইভেট ক্লাউড ভার্সন 4.50.00-এ নিম্নলিখিত সমস্যার কারণে ইনস্টলেশন সম্পূর্ণ করা যায়নি ...

আমাদের প্রাইভেট ক্লাউড সেট-আপে ইনস্টলেশন সম্পূর্ণ করা যায়নি।

(ভার্সন সংক্রান্ত তথ্য নেই)

সমস্যার বিবরণ

সমস্যার মেসেজ (যদি থাকে) এবং প্রত্যাশিত ও প্রকৃত আচরণ সহ সমস্যা সম্পর্কে সঠিক তথ্য প্রদান করুন।

নিচের সারণীতে কী কী করা উচিত কলামে সম্পূর্ণ তথ্য এবং কী কী করা উচিত নয় কলামে অসম্পূর্ণ তথ্য সহ কিছু উদাহরণ দেওয়া হল:

কী কী করা উচিত কী করবেন না

নতুন edgemicro প্রক্সি edgemicro_auth নিম্নলিখিত সমস্যার কারণে কাজ করছে না:

{"error":"missing_authorization","error_description":"Missing Authorization header"}

আজ তৈরি করা নতুন edgemicro প্রক্সি কাজ করছে না

(প্রক্সি নামটি জানা নেই। প্রক্সি কোনও সমস্যা বা কোনও অপ্রত্যাশিত উত্তর রিটার্ন করছে কিনা তা স্পষ্ট নয়।)

আমাদের ক্লায়েন্টরা API প্রক্সিতে অনুরোধ করার সময় নিম্নলিখিত সমস্যার মেসেজ সহ 500 সমস্যা পাচ্ছেন:

{"fault":{"faultstring":"Execution of JSReadResponse failed with error: Javascript runtime error: \"TypeError: Cannot read property \"content\" from undefined. (JSReadResponse.js:23)","detail":{"errorcode":"steps.javascript.ScriptExecutionFailed"}}}

API প্রক্সিতে অনুরোধ করার সময় আমাদের ক্লায়েন্টরা 500 সমস্যার সম্মুখীন হচ্ছেন।

(শুধুমাত্র 500 সমস্যার কথা জানালে, সমস্যাটি তদন্ত করে দেখার জন্য আমাদের কাছে পর্যাপ্ত তথ্য থাকে না। আমরা দেখতে পাচ্ছি যে আসল সমস্যার মেসেজ ও সমস্যার কোড হল ।

সময়

সময় হল তথ্যের একটি অত্যন্ত গুরুত্বপূর্ণ অংশ। সহায়তা ইঞ্জিনিয়ারের জন্য এটি জানা গুরুত্বপূর্ণ যে আপনি প্রথম কখন এই সমস্যাটি লক্ষ্য করেছেন, এটি কতক্ষণ স্থায়ী হয়েছে এবং সমস্যাটি এখনও চলছে কিনা।

যে সহায়তা ইঞ্জিনিয়ার সমস্যাটি সমাধান করছেন তিনি আপনার টাইমজোনে নাও থাকতে পারেন, তাই সময় সম্পর্কিত আপেক্ষিক বিবৃতি সমস্যাটি ডায়াগনসিস করা কঠিন করে তোলে। তাই, সমস্যাটি কখন লক্ষ্য করা গেছে সেই সম্পর্কে সঠিক সময়ের তথ্য প্রদান করতে, তারিখ ও সময়ের ISO 8601 ফর্ম্যাট ব্যবহার করার পরামর্শ দেওয়া হয়।

নিচের সারণীতে কিছু উদাহরণ দেওয়া হল, যেখানে কী কী করা উচিত কলামে সমস্যাটি কতক্ষণ ধরে চলেছিল তার সঠিক সময় ও ব্যাপ্তি দেখানো হয়েছে এবং কী কী করা উচিত নয় কলামে সমস্যাটি কখন হয়েছিল সেই বিষয়ে অস্পষ্ট বা অনিশ্চিত তথ্য দেখানো হয়েছে:

কী কী করা উচিত কী করবেন না
গতকাল ২০২০-১১-০৬ ১৭:৩০ PDT এবং ২০২০-১১-০৬ ১৭:৩৫ PDT-এর মধ্যে প্রচুর পরিমাণে 503s দেখা গেছে...

গতকাল ৫:৩০-এ ৫ মিনিটের জন্য প্রচুর পরিমাণে 503s দেখা গেছে।

(আমাদের বাধ্য হয়েই অনুমিত তারিখ ব্যবহার করতে হচ্ছে এবং এটিও স্পষ্ট নয় যে কোন টাইমজোনে এই সমস্যা দেখা গেছে।)

২০২০-১১-০৯ ১৫:৩০ IST থেকে ২০২০-১১-০৯ ১৮:১০ IST পর্যন্ত নিম্নলিখিত API প্রক্সিতে বেশি লেটেন্সি দেখা গেছে ...

গত সপ্তাহে কিছু API প্রক্সিতে হাই লেটেন্সি দেখা গেছে।

(গত সপ্তাহে কোন দিন এবং কতক্ষণ ধরে এই সমস্যা দেখা গেছে তা স্পষ্ট নয়।)

সেট-আপ করুন

আপনি ঠিক কোথায় সমস্যাটি দেখতে পাচ্ছেন সেই বিষয়ে আমাদের বিবরণ দিন। আপনি যে প্রোডাক্ট ব্যবহার করছেন তার উপর নির্ভর করে, আমাদের নিম্নলিখিত তথ্য প্রয়োজন:

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

নিচের সারণীতে কী কী করা উচিত কলামে সম্পূর্ণ তথ্য এবং কী কী করা উচিত নয় কলামে অসম্পূর্ণ তথ্য সহ কিছু উদাহরণ দেওয়া হল:

কী কী করা উচিত কী করবেন না

401 Edge Public Cloud-এ ২০২০-১১-০৬ ০৯:৩০ CST থেকে সমস্যা বেড়ে গেছে।

Edge সেট-আপের বিবরণ:

কাজ না করা API-এর বিবরণ নিচে দেওয়া হল:
  সংস্থাগুলির নাম: myorg
  এনভায়রনমেন্টের নাম: test
  API প্রক্সি নাম: myproxy
  রিভিশন নম্বর: 3

সমস্যা:

{"fault":{"faultstring":"Failed to resolve API Key variable request.header.X-APP-API_KEY","detail":{"errorcode":"steps.oauth.v2.FailedToResolveAPIKey"}}}

401 সমস্যা বেড়ে গেছে।

(এটি ব্যবহার করা হচ্ছে এমন প্রোডাক্ট, সমস্যাটি কখন থেকে দেখা যাচ্ছে বা কোনও সেট-আপ সংক্রান্ত বিবরণ সম্পর্কে কোনও তথ্য দেয় না।)

অতিরিক্ত গেটওয়ে নোড যোগ করার পরে Edge Private Cloud ভার্সন 4.19.06 -এ মেসেজ প্রসেসর চালু করা যাচ্ছে না।

ডায়াগনস্টিক লগ:
মেসেজ প্রসেসর লগ অ্যাটাচ করা হয়েছে।

নেটওয়ার্ক টপোলজি:
অতিরিক্ত নোড সহ ফাইল network-topology.png অ্যাটাচ করা হয়েছে।

অতিরিক্ত গেটওয়ে নোড যোগ করার পরে Edge Private Cloud ভার্সন 4.19.06 -এ মেসেজ প্রসেসর চালু করা যাচ্ছে না।

(The Message Processor Logs এবং নেটওয়ার্ক টপোলজি নেই।)

উপযোগী আর্টিফ্যাক্ট

সমস্যা সম্পর্কিত আর্টিফ্যাক্ট আমাদের দিলে তা সমাধান করার প্রসেসকে আরও দ্রুত করে তুলবে, কারণ এটি আপনাকে পর্যবেক্ষণ করা সঠিক আচরণ বুঝতে এবং সেই বিষয়ে আরও ইনসাইট পেতে সাহায্য করে।

এই বিভাগে কিছু দরকারী আর্টিফ্যাক্ট বর্ণনা করা হয়েছে যা সব Apigee প্রোডাক্টের জন্য সহায়ক:

সব Apigee প্রোডাক্টের জন্য সাধারণ আর্টিফ্যাক্ট

নিম্নলিখিত আর্টিফ্যাক্ট সব Apigee প্রোডাক্টের জন্য উপযোগী: পাবলিক ক্লাউডে Apigee Edge এবং প্রাইভেট ক্লাউডে Apigee Edge:

আর্টিফ্যাক্ট বিবরণ
ট্রেস টুলের আউটপুট Trace টুলের আউটপুটে Apigee প্রোডাক্টের মাধ্যমে প্রবাহিত API অনুরোধ সম্পর্কে বিস্তারিত তথ্য থাকে। এটি 4XX, 5XX এবং লেটেন্সি সংক্রান্ত সমস্যার মতো যেকোনও রানটাইম সমস্যার ক্ষেত্রে সহায়ক।
স্ক্রিনশট স্ক্রিনশট থেকে আসল আচরণ বা সমস্যা সম্পর্কে ধারণা পাওয়া যায়। এটি UI বা Analytics-এর মতো পর্যবেক্ষিত যেকোনও সমস্যা বা ভুলের ক্ষেত্রে সহায়ক।
HAR (Http ARchive) UI সংক্রান্ত কোনও সমস্যা ডিবাগ করার জন্য HTTP সেশন টুল দ্বারা ক্যাপচার করা ফাইল হল HAR। Chrome, Firefox বা Internet Explorer-এর মতো ব্রাউজার ব্যবহার করে এটি ক্যাপচার করা যেতে পারে।
tcpdumps tcpdump টুলটি নেটওয়ার্কের মাধ্যমে ট্রান্সফার করা বা পাওয়া TCP/IP প্যাকেট ক্যাপচার করে। এটি TLS হ্যান্ডশেক ব্যর্থতা, 502 সমস্যা এবং লেটেন্সি সংক্রান্ত সমস্যার মতো যেকোনও নেটওয়ার্ক-সম্পর্কিত সমস্যার জন্য সহায়ক।

প্রাইভেট ক্লাউডের জন্য Apigee Edge-এর অতিরিক্ত আর্টিফ্যাক্ট

প্রাইভেট ক্লাউডের জন্য Apigee Edge-এর ক্ষেত্রে, সমস্যা দ্রুত ডায়াগনসিস করার জন্য আমাদের কিছু অতিরিক্ত আর্টিফ্যাক্ট প্রয়োজন হতে পারে।

আর্টিফ্যাক্ট বিবরণ
নেটওয়ার্ক টপোলজি Edge ইনস্টলেশন টপোলজি ডায়াগ্রাম যা আপনার প্রাইভেট ক্লাউড সেট-আপের বর্ণনা দেয়, এর মধ্যে প্রতিটি নোডে ইনস্টল করা সব ডেটা সেন্টার, নোড ও কম্পোনেন্ট অন্তর্ভুক্ত।
এজ কম্পোনেন্ট ডায়াগনস্টিক লগ নির্দিষ্ট Apigee Edge কম্পোনেন্ট যেমন Message Processor, Router বা Cassandra সম্পর্কিত ডায়াগনস্টিক লগ।
ইনস্টলেশন কনফিগারেশন ফাইল Apigee Edge ইনস্টল বা আপগ্রেড করার সময় ব্যবহৃত সাইলেন্ট কনফিগারেশন ফাইল।

ইনস্টলেশন বা মাইগ্রেশন সংক্রান্ত সমস্যা হলে, এই ফাইলটি সব সেটিংস সঠিক আছে কিনা তা যাচাই করতে সাহায্য করে।

হিপ ডাম্প হিপ ডাম্প হল জাভা মেমরি প্রসেসের একটি স্ন্যাপশট। নির্দিষ্ট Edge কম্পোনেন্টে বেশি মেমরি ব্যবহার বা OutOfMemory সমস্যা দেখা দিলে এটি সহায়ক হয়।
থ্রেড ডাম্প থ্রেড ডাম্প হল কোনও রানিং Java প্রসেসের সব থ্রেডের স্ন্যাপশট।

নির্দিষ্ট Edge কম্পোনেন্টে বেশি CPU ব্যবহার বা লোড দেখা গেলে এটি সহায়ক হয়।

কেস টেমপ্লেট ও নমুনা কেস

এই বিভাগে, এই ডকুমেন্টে বর্ণিত পেশাদার পদ্ধতি অনুযায়ী বিভিন্ন প্রোডাক্টের জন্য কেস টেমপ্লেট ও নমুনা কেস প্রদান করা হয়েছে:

পাবলিক ক্লাউডে Apigee Edge

টেমপ্লেট

এই বিভাগে পাবলিক ক্লাউডে Apigee Edge-এর জন্য একটি নমুনা টেমপ্লেট প্রদান করা হয়েছে।

সমস্যা:

<আপনার এন্ডে দেখা যাওয়া সমস্যা বা আচরণের বিস্তারিত বিবরণ দিন। যেখানে প্রযোজ্য সেখানে প্রোডাক্টের নাম ও ভার্সন যোগ করুন।>

সমস্যার মেসেজ:

<Include the complete error message observed (if any)>

সমস্যা শুরুর সময় (ISO 8601 ফর্ম্যাট):

সমস্যার শেষ হওয়ার সময় (ISO 8601 ফর্ম্যাট):

Apigee সেট-আপের বিবরণ:
  সংস্থার নাম:
  এনভায়রনমেন্টের নাম:
  API প্রক্সির নাম:
  রিভিশন নম্বর:

সমস্যাটি আবার তৈরি করার ধাপ:

<সম্ভব হলে, সমস্যাটি কীভাবে রিপ্রোডিউস করা যায়, ধাপে ধাপে তা বর্ণনা করুন>

ডায়াগনস্টিক সংক্রান্ত তথ্য:

<List of files attached>

নমুনা কেস

এই বিভাগে Apigee Cloud (Google Cloud-এ Apigee/পাবলিক ক্লাউডে Apigee Edge)-এর জন্য একটি নমুনা কেস প্রদান করা হয়েছে।

সমস্যা:

আমাদের পাবলিক ক্লাউডে org-এ আমরা প্রচুর পরিমাণে 503 পরিষেবা অনুপলভ্য সংক্রান্ত সমস্যা দেখতে পাচ্ছি। আপনি কি সমস্যাটি খতিয়ে দেখে এর সমাধান করতে পারবেন অথবা কীভাবে এর সমাধান করা যায় সেই ব্যাপারে আমাদের পরামর্শ দিতে পারবেন?

সমস্যার মেসেজ:

{"fault":{"faultstring":"The Service is temporarily available", "detail":{"errorcode":"messaging.adaptors.http.flow.ServiceUnavailable"}}}

সমস্যা শুরু হওয়ার সময় (ISO 8601 ফর্ম্যাট): 2020-10-04 06:30 IST

সমস্যা শেষ হওয়ার সময় (ISO 8601 ফর্ম্যাট): সমস্যাটি এখনও চলছে।

Apigee Cloud সেট-আপ সংক্রান্ত বিবরণ:
  সংস্থার নাম: myorg
  এনভায়রনমেন্টের নাম: dev
  API প্রক্সির নাম: myproxy
  রিভিশন নম্বর: 3

সমস্যাটি আবার তৈরি করার ধাপ:

সমস্যাটি আবার তৈরি করতে, নিম্নলিখিত curl কমান্ডটি রান করুন:

curl -X GET 'https://myorg-dev.apigee.net/v1/myproxy'

ডায়াগনস্টিক সংক্রান্ত তথ্য:

ট্রেস টুলের আউটপুট (trace-503.xml)

প্রাইভেট ক্লাউডের জন্য Apigee Edge

টেমপ্লেট

এই বিভাগে প্রাইভেট ক্লাউডের জন্য Apigee Edge-এর একটি নমুনা টেমপ্লেট দেওয়া হয়েছে।

সমস্যা:

<আপনার এন্ডে দেখা যাওয়া সমস্যা বা আচরণের বিস্তারিত বিবরণ দিন। যেখানে প্রযোজ্য সেখানে প্রোডাক্টের নাম ও ভার্সন যোগ করুন।>

সমস্যার মেসেজ:

<Include the complete error message observed (if any)>

সমস্যা শুরুর সময় (ISO 8601 ফর্ম্যাট):

সমস্যা শেষ হওয়ার সময় (ISO 8601 ফর্ম্যাট):

Edge Private Cloud সেট-আপ সংক্রান্ত বিবরণ:

<আপনার প্রাইভেট ক্লাউডের সেট-আপের বিবরণ সহ নেটওয়ার্ক টপোলজি অ্যাটাচ করুন, যার মধ্যে ডেটা সেন্টার ও নোড অন্তর্ভুক্ত>

সমস্যাটি আবার তৈরি করার ধাপ:

<সম্ভব হলে, সমস্যাটি কীভাবে রিপ্রোডিউস করা যায়, ধাপে ধাপে তা বর্ণনা করুন>

ডায়াগনস্টিক তথ্য

<List of files attached>

নমুনা কেস

এই বিভাগে প্রাইভেট ক্লাউডের জন্য Apigee Edge-এর একটি নমুনা কেস প্রদান করা হয়েছে।

সমস্যা:

Linux RHEL 7.6-এ Edge Private Cloud 4.19.06-এর অংশ হিসেবে আমরা যখন নোড #10-এ Apigee ম্যানেজমেন্ট সার্ভার ইনস্টল করছিলাম, তখন নিম্নলিখিত সমস্যাটি হয়েছে।

সমস্যার মেসেজ:

<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 ফর্ম্যাট): এটি তখনই হয় যখন আমরা ইনস্টল করি

সমস্যা শেষ হওয়ার সময় (ISO 8601 ফর্ম্যাট): প্রযোজ্য নয়

Edge Private Cloud সেট-আপ সংক্রান্ত বিবরণ:

network-topology.png ফাইলটি অ্যাটাচ করা হয়েছে

সমস্যাটি আবার তৈরি করার ধাপ:

এই কমান্ডের ফলে উপরে উল্লেখ করা সমস্যাটি হয়েছে:

/opt/apigee/apigee-setup/bin/setup.sh -p ms -f /app/NonProdConfig.txt

ডায়াগনস্টিক সংক্রান্ত তথ্য:

নিচে উল্লেখ করা ফাইল অ্যাটাচ করা হয়েছে:

  • output.txt সমস্যার মেসেজ সহ উপরের কমান্ডের সম্পূর্ণ আউটপুট
  • ম্যানেজমেন্ট সার্ভার লগ এবং
  • কনফিগারেশন ফাইল NonProdConfig.txt