Google Cloud Apigee সহায়তার ক্ষেত্রে সেরা অনুশীলন

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

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

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

বিষয়টি বর্ণনা করছেন

একটি ইস্যুতে কী ঘটেছিল বনাম কী ঘটতে প্রত্যাশিত ছিল, সেইসাথে কখন এবং কীভাবে ঘটেছিল সে সম্পর্কে বিশদ ব্যাখ্যা করে তথ্য থাকা উচিত। একটি ভাল Apigee সমর্থন ক্ষেত্রে প্রতিটি Apigee পণ্যের জন্য নিম্নলিখিত মূল তথ্য থাকা উচিত:

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

নিম্নলিখিত বিভাগগুলি এই ধারণাগুলিকে আরও বিশদে বর্ণনা করে।

পণ্য

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

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

ডিও করবেন না
API প্রক্সি OAuth2 এর স্থাপনা আমাদের পাবলিক ক্লাউড অর্গে ব্যর্থ হয়েছে...

API প্রক্সি স্থাপন ব্যর্থ হয়েছে৷

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

আমাদের এজ প্রাইভেট ক্লাউড সংস্করণ 4.50.00 এ নিম্নলিখিত ত্রুটির সাথে ইনস্টলেশন ব্যর্থ হয়েছে ...

আমাদের ব্যক্তিগত ক্লাউড সেটআপে ইনস্টলেশন ব্যর্থ হয়েছে৷

(সংস্করণ তথ্য অনুপস্থিত)

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

ত্রুটি বার্তা (যদি থাকে) এবং প্রত্যাশিত এবং বাস্তব আচরণ পর্যবেক্ষণ সহ পরিলক্ষিত সমস্যা সম্পর্কে সুনির্দিষ্ট তথ্য প্রদান করুন।

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

ডিও করবেন না

নতুন 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 ফর্ম্যাট ব্যবহার করার পরামর্শ দেওয়া হয়।

নিম্নলিখিত সারণীটি কিছু উদাহরণ প্রদান করে যা সঠিক সময় এবং সময়কাল দেখায় যার জন্য DOs কলামে সমস্যাটি ঘটেছে, এবং করণীয় কলামে কখন সমস্যাটি ঘটেছে সে সম্পর্কে অস্পষ্ট বা অস্পষ্ট তথ্য:

ডিও করবেন না
গতকাল 2020-11-06 17:30 PDT এবং 2020-11-06 17:35 PDT এর মধ্যে বিপুল সংখ্যক 503s পর্যবেক্ষণ করা হয়েছে...

গতকাল বিকাল 5:30 টায় 5 মিনিটের জন্য বিপুল সংখ্যক 503s পর্যবেক্ষণ করা হয়েছিল৷

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

2020-11-09 15:30 IST থেকে 2020-11-09 18:10 IST পর্যন্ত নিম্নোক্ত API প্রক্সিগুলিতে উচ্চ বিলম্ব পরিলক্ষিত হয়েছে ...

গত সপ্তাহে কিছু API প্রক্সিতে উচ্চ বিলম্ব পরিলক্ষিত হয়েছে।

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

সেটআপ

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

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

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

ডিও করবেন না

2020-11-06 09:30 CST থেকে এজ পাবলিক ক্লাউডে 401 ত্রুটি বেড়েছে।

প্রান্ত সেটআপ বিশদ:

ব্যর্থ API এর বিবরণ নিম্নরূপ:
সংগঠনের নাম: myorg
Env নাম: 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 ত্রুটি বৃদ্ধি পেয়েছে।

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

অতিরিক্ত গেটওয়ে নোড যোগ করার পরে , এজ প্রাইভেট ক্লাউড সংস্করণ 4.19.06- এ মেসেজ প্রসেসর শুরু করতে অক্ষম৷

ডায়গনিস্টিক লগ:
বার্তা প্রসেসর লগ সংযুক্ত.

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

অতিরিক্ত গেটওয়ে নোড যোগ করার পরে , এজ প্রাইভেট ক্লাউড সংস্করণ 4.19.06- এ মেসেজ প্রসেসর শুরু করতে অক্ষম৷

(মেসেজ প্রসেসর লগ এবং নেটওয়ার্ক টপোলজি অনুপস্থিত।)

দরকারী নিদর্শন

সমস্যাটির সাথে সম্পর্কিত আর্টিফ্যাক্টগুলি আমাদের প্রদান করলে তা সমাধানের গতি বাড়িয়ে দেবে, কারণ এটি আমাদেরকে আপনি যে সঠিক আচরণটি পর্যবেক্ষণ করছেন তা বুঝতে এবং এটি সম্পর্কে আরও অন্তর্দৃষ্টি পেতে সহায়তা করে৷

এই বিভাগে কিছু দরকারী শিল্পকর্ম বর্ণনা করা হয়েছে যা সমস্ত Apigee পণ্যের জন্য সহায়ক:

সমস্ত Apigee পণ্যের জন্য সাধারণ শিল্পকর্ম

নিম্নলিখিত নিদর্শনগুলি সমস্ত Apigee পণ্যের জন্য দরকারী: পাবলিক ক্লাউডে Apigee Edge এবং Private Cloud-এ Apigee Edge :

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

ব্যক্তিগত ক্লাউডের জন্য Apigee Edge-এর জন্য অতিরিক্ত নিদর্শন

ব্যক্তিগত ক্লাউডের জন্য Apigee Edge-এর জন্য, আমাদের কিছু অতিরিক্ত শিল্পকর্মের প্রয়োজন হতে পারে যা সমস্যাগুলির দ্রুত নির্ণয়ের সুবিধা দেবে।

আর্টিফ্যাক্ট বর্ণনা
নেটওয়ার্ক টপোলজি এজ ইনস্টলেশন টপোলজি ডায়াগ্রাম প্রতিটি নোডে ইনস্টল করা সমস্ত ডেটা সেন্টার, নোড এবং উপাদান সহ আপনার ব্যক্তিগত ক্লাউড সেটআপের বর্ণনা দেয়।
প্রান্ত উপাদান ডায়গনিস্টিক লগ মেসেজ প্রসেসর, রাউটার বা ক্যাসান্ড্রার মতো নির্দিষ্ট অ্যাপিজি এজ উপাদান সম্পর্কিত ডায়াগনস্টিক লগ।
ইনস্টলেশন কনফিগারেশন ফাইল Apigee Edge ইনস্টল বা আপগ্রেড করার সময় ব্যবহৃত নীরব কনফিগারেশন ফাইল।

ইনস্টলেশন বা স্থানান্তর সংক্রান্ত সমস্যাগুলির সম্মুখীন হলে সমস্ত সেটিংস সঠিক হলে এই ফাইলটি যাচাই করতে উপযোগী।

স্তূপ হিপ ডাম্প হল জাভা মেমরি প্রক্রিয়ার একটি স্ন্যাপশট। এটি সহায়ক যদি উচ্চ মেমরি ব্যবহার বা OutOfMemory ত্রুটি নির্দিষ্ট এজ উপাদানগুলিতে দেখা যায়।
থ্রেড ডাম্প একটি থ্রেড ডাম্প হল একটি চলমান জাভা প্রক্রিয়ার সমস্ত থ্রেডের একটি স্ন্যাপশট।

এটি সহায়ক যদি নির্দিষ্ট এজ উপাদানগুলিতে উচ্চ CPU বা লোড পরিলক্ষিত হয়।

কেস টেমপ্লেট এবং নমুনা কেস

এই বিভাগটি এই নথিতে বর্ণিত সেরা অনুশীলনের উপর ভিত্তি করে বিভিন্ন পণ্যের জন্য কেস টেমপ্লেট এবং নমুনা কেস সরবরাহ করে:

পাবলিক ক্লাউডে Apigee এজ

টেমপ্লেট

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

সমস্যা:

<সমস্যার বিশদ বিবরণ প্রদান করুন বা আপনার শেষে যে আচরণটি পর্যবেক্ষণ করা হচ্ছে। যেখানে প্রযোজ্য সেখানে পণ্যের নাম এবং সংস্করণ অন্তর্ভুক্ত করুন।>

ত্রুটি বার্তা:

<পরিক্ষিত সম্পূর্ণ ত্রুটি বার্তা অন্তর্ভুক্ত করুন (যদি থাকে)>

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

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

Apigee সেটআপ বিশদ:
প্রতিষ্ঠানের নাম:
Env নাম:
API প্রক্সি নাম:
রিভিশন নম্বর:

পুনরুত্পাদনের পদক্ষেপ:

<যথা সম্ভব সমস্যাটি পুনরুত্পাদন করার জন্য পদক্ষেপ প্রদান করুন>

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

<সংযুক্ত ফাইলের তালিকা>

নমুনা কেস

এই বিভাগটি Apigee ক্লাউডের জন্য একটি নমুনা কেস প্রদান করে (Google Cloud-এ Apigee/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

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

Apigee ক্লাউড সেটআপের বিশদ বিবরণ:
সংগঠনের নাম: myorg
Env নাম: dev
API প্রক্সি নাম: myproxy
রিভিশন নম্বর: 3

পুনরুত্পাদনের পদক্ষেপ:

সমস্যাটি পুনরুত্পাদন করতে নিম্নলিখিত curl কমান্ডটি চালান:

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

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

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

ব্যক্তিগত ক্লাউডের জন্য Apigee এজ

টেমপ্লেট

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

সমস্যা:

<সমস্যার বিশদ বিবরণ প্রদান করুন বা আপনার শেষে যে আচরণটি পর্যবেক্ষণ করা হচ্ছে। যেখানে প্রযোজ্য সেখানে পণ্যের নাম এবং সংস্করণ অন্তর্ভুক্ত করুন।>

ত্রুটি বার্তা:

<পরিক্ষিত সম্পূর্ণ ত্রুটি বার্তা অন্তর্ভুক্ত করুন (যদি থাকে)>

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

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

এজ প্রাইভেট ক্লাউড সেটআপের বিশদ বিবরণ:

<ডেটা সেন্টার এবং নোড সহ আপনার ব্যক্তিগত ক্লাউডের সেটআপের বর্ণনা করে নেটওয়ার্ক টপোলজি সংযুক্ত করুন>

পুনরুত্পাদনের পদক্ষেপ:

<যথা সম্ভব সমস্যাটি পুনরুত্পাদন করার জন্য পদক্ষেপ প্রদান করুন>

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

<সংযুক্ত ফাইলের তালিকা>

নমুনা কেস

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

সমস্যা:

যখন আমরা লিনাক্স RHEL 7.6 -এ এজ প্রাইভেট ক্লাউড 4.19.06- এর অংশ হিসাবে নোড #10-এ অ্যাপিজি ম্যানেজমেন্ট সার্ভার ইনস্টল করছিলাম, তখন আমরা নিম্নলিখিত ত্রুটির সম্মুখীন হচ্ছি।

ত্রুটি বার্তা:

<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 ফর্ম্যাট): প্রযোজ্য নয়

এজ প্রাইভেট ক্লাউড সেটআপের বিশদ বিবরণ:

নেটওয়ার্ক-টোপোলজি.পিএনজি ফাইল সংযুক্ত করা হয়েছে

পুনরুত্পাদনের পদক্ষেপ:

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

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

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

নিম্নলিখিত ফাইল সংযুক্ত:

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