নিম্নলিখিত বিভাগগুলি Apigee-এর সাথে পরিচিত সমস্যাগুলি বর্ণনা করে৷ বেশিরভাগ ক্ষেত্রে, তালিকাভুক্ত সমস্যাগুলি ভবিষ্যতের রিলিজে ঠিক করা হবে।
বিবিধ প্রান্ত পরিচিত সমস্যা
নিম্নলিখিত বিভাগগুলি এজ সহ বিবিধ পরিচিত সমস্যাগুলি বর্ণনা করে৷
এলাকা/সারাংশ
পরিচিত সমস্যা
ক্যাশের মেয়াদ শেষ হওয়ার ফলে ভুল cachehit মান
লুকআপক্যাচে নীতির পরে যখন cachehit ফ্লো ভেরিয়েবল ব্যবহার করা হয়, অ্যাসিঙ্ক্রোনাস আচরণের জন্য ডিবাগ পয়েন্টগুলি যেভাবে পাঠানো হয় তার কারণে, কল ব্যাক কার্যকর হওয়ার আগে LookupPolicy DebugInfo অবজেক্টকে পপুলেট করে, যার ফলে একটি ত্রুটি দেখা দেয়।
ওয়ার্কঅ্যারাউন্ড: প্রথম কলের ঠিক পরে আবার প্রক্রিয়াটি পুনরাবৃত্তি করুন (দ্বিতীয় কল করুন)।
InvalidateCache পলিসি PurgeChildEntries সত্যে সেট করা সঠিকভাবে কাজ করে না
InvalidateCache পলিসিতে PurgeChildEntries সেট করলে শুধুমাত্র KeyFragment এলিমেন্টের মানগুলি পরিষ্কার করা উচিত কিন্তু সম্পূর্ণ ক্যাশে সাফ করা হয়।
ওয়ার্কঅ্যারাউন্ড: ক্যাশে সংস্করণ পুনরাবৃত্তি করতে এবং ক্যাশে অবৈধকরণের প্রয়োজনীয়তা বাইপাস করতে KeyValueMapOperations নীতি ব্যবহার করুন৷
একটি SharedFlow বা API প্রক্সির জন্য সমসাময়িক স্থাপনার অনুরোধের ফলে ম্যানেজমেন্ট সার্ভারে একটি অসামঞ্জস্যপূর্ণ অবস্থা হতে পারে যেখানে একাধিক রিভিশন ডিপ্লোয়ড হিসাবে দেখানো হয়।
এটি ঘটতে পারে, উদাহরণস্বরূপ, যখন বিভিন্ন সংশোধন ব্যবহার করে একটি CI/CD স্থাপনার পাইপলাইনের একযোগে রান হয়। এই সমস্যা এড়াতে, বর্তমান স্থাপনা সম্পূর্ণ হওয়ার আগে API প্রক্সি বা SharedFlows স্থাপন করা এড়িয়ে চলুন।
ওয়ার্কঅ্যারাউন্ড: সমবর্তী API প্রক্সি বা SharedFlow স্থাপনা এড়িয়ে চলুন।
এজ এপিআই অ্যানালিটিক্স কখনও কখনও API কলগুলির জন্য ডুপ্লিকেট ডেটা থাকতে পারে। সেক্ষেত্রে এজ এপিআই অ্যানালিটিক্সে API কলগুলির জন্য দেখানো সংখ্যাগুলি তৃতীয়-পক্ষ বিশ্লেষণ সরঞ্জামগুলিতে দেখানো তুলনামূলক মানের থেকে বেশি।
উদাহরণস্বরূপ, OpenAPI স্পেসিফিকেশন 3.0 থেকে নিম্নলিখিত বৈশিষ্ট্যগুলি এখনও সমর্থিত নয়:
স্কিমা একত্রিত এবং প্রসারিত করার জন্য allOf বৈশিষ্ট্য
দূরবর্তী রেফারেন্স
যদি আপনার OpenAPI স্পেসিফিকেশনে একটি অসমর্থিত বৈশিষ্ট্য উল্লেখ করা হয়, কিছু ক্ষেত্রে টুলগুলি বৈশিষ্ট্যটিকে উপেক্ষা করবে কিন্তু তবুও API রেফারেন্স ডকুমেন্টেশন রেন্ডার করবে। অন্যান্য ক্ষেত্রে, একটি অসমর্থিত বৈশিষ্ট্য ত্রুটির কারণ হবে যা API রেফারেন্স ডকুমেন্টেশনের সফল রেন্ডারিংকে বাধা দেয়। উভয় ক্ষেত্রেই, ভবিষ্যতে রিলিজে সমর্থিত না হওয়া পর্যন্ত অসমর্থিত বৈশিষ্ট্যের ব্যবহার এড়াতে আপনাকে আপনার OpenAPI স্পেসিফিকেশন পরিবর্তন করতে হবে।
দ্রষ্টব্য : যেহেতু API রেফারেন্স ডকুমেন্টেশন রেন্ডার করার সময় spec editor SmartDocs থেকে কম সীমাবদ্ধ, আপনি টুলগুলির মধ্যে বিভিন্ন ফলাফল অনুভব করতে পারেন।
পোর্টালে এই API ব্যবহার করে দেখুন, OpenAPI স্পেসিফিকেশনে consumes জন্য সেট করা মান নির্বিশেষে Accept হেডারটি application/json এ সেট করা হয়।
SAML পরিচয় প্রদানকারীর সাথে একক লগআউট (SLO) কাস্টম ডোমেনের জন্য সমর্থিত নয়। একটি SAML পরিচয় প্রদানকারীর সাথে একটি কাস্টম ডোমেন সক্ষম করতে, আপনি যখন SAML সেটিংস কনফিগার করবেন তখন সাইন-আউট URL ক্ষেত্রটি ফাঁকা রাখুন৷
পোর্টাল অ্যাডমিন
একাধিক ব্যবহারকারীর দ্বারা একযোগে পোর্টাল আপডেট (যেমন পৃষ্ঠা, থিম, CSS, বা স্ক্রিপ্ট সম্পাদনা) এই সময়ে সমর্থিত নয়।
আপনি পোর্টাল থেকে একটি API রেফারেন্স ডকুমেন্টেশন পৃষ্ঠা মুছে ফেললে, এটি পুনরায় তৈরি করার কোন উপায় নেই; আপনাকে API পণ্যটি মুছে ফেলতে এবং পুনরায় যোগ করতে হবে এবং API রেফারেন্স ডকুমেন্টেশন পুনরায় তৈরি করতে হবে।
ভবিষ্যতের রিলিজে সার্চকে ইন্টিগ্রেটেড পোর্টালে একত্রিত করা হবে।
এজ ফর প্রাইভেট ক্লাউডের জ্ঞাত সমস্যা
নিম্নলিখিত বিভাগগুলিতে এজ ফর প্রাইভেট ক্লাউডের জ্ঞাত সমস্যাগুলি বর্ণনা করা হয়েছে।
এলাকা
জ্ঞাত সমস্যা
প্রাইভেট ক্লাউডের জন্য এজ 4.53.00
440148595: জীবনের শেষের দিকে পপআপ সতর্কতা অত্যধিকভাবে প্রদর্শিত হচ্ছে
প্রাইভেট ক্লাউড ৪.৫৩.০০ এবং পরবর্তী সংস্করণের জন্য এজ-এ, UI "End of Life" (EOL) সতর্কতা পপ-আপ প্রদর্শন করে। এই সতর্কতাটি প্রদর্শিত হয় বারবার এবং প্রতিরোধ বা ফ্রিকোয়েন্সি হ্রাস করা যাবে না।
ব্যবহারকারীদের জন্য বর্তমানে এই EOL সতর্কতার ফ্রিকোয়েন্সি নিষ্ক্রিয় বা কমানোর কোনও পদ্ধতি উপলব্ধ নেই।
প্রাইভেট ক্লাউডের জন্য এজ 4.53.01
443272053: এজ কম্পোনেন্টগুলিতে ডেটাস্টোর ত্রুটি
প্রাইভেট ক্লাউড ৪.৫৩.০০ বা তার পরবর্তী সংস্করণে, ক্যাসান্ড্রা এবং অ্যাপ্লিকেশন উপাদানগুলির (ম্যানেজমেন্ট সার্ভার, মেসেজ প্রসেসর বা রাউটার) মধ্যে একটি নির্দিষ্ট ধরণের মিথস্ক্রিয়া ডেটাস্টোর ত্রুটির কারণ হতে পারে। যখন এই ধরনের ত্রুটি ঘটে, তখন আপনি নির্দিষ্ট অ্যাপ্লিকেশন উপাদানের সিস্টেম লগে নিম্নলিখিত প্যাটার্নের লগগুলি লক্ষ্য করবেন:
com.datastax.driver.core.exceptions.ProtocolError: An unexpected protocol error occurred on host WW.XX.YY.ZZ:9042.
এই ত্রুটিগুলি তখন ঘটে যখন অ্যাপ্লিকেশন কম্পোনেন্টটি Cassandra ডাটাবেস দ্বারা তৈরি সতর্কতাগুলি পরিচালনা করার জন্য কনফিগার করা হয় না। আপনি আপনার Cassandra নোডগুলিতে সতর্কতাগুলি এড়িয়ে বা দমন করে এই সমস্যাটি কমাতে পারেন। বেশিরভাগ ক্ষেত্রে, অতিরিক্ত সমাধি পাথরের কারণে সতর্কতা তৈরি হয়। আপনি নিম্নলিখিত বিকল্পগুলির মধ্যে একটি বা তালিকাভুক্ত বিকল্পগুলির সংমিশ্রণ অনুসরণ করতে পারেন:
reduce gc_grace_seconds : ত্রুটির সাথে সম্পর্কিত লগ বার্তায় প্রদর্শিত টেবিলের জন্য, cqlsh ব্যবহার করে নিম্নলিখিত কমান্ডটি চালিয়ে gc_grace_seconds হ্রাস করুন:
Below command sets gc_grace_seconds of kms.oauth_20_access_tokens to 1 day from default 10 days
ALTER TABLE kms.oauth_20_access_tokens WITH gc_grace_seconds = '86400';
সতর্কতা তৈরির জন্য ক্যাসান্দ্রায় সমাধির পাথরের প্রান্তিক মান বৃদ্ধি করুন। এর জন্য, নিম্নলিখিত নির্দেশাবলী ব্যবহার করুন:
একটি ক্যাসান্ড্রা নোডে, $APIGEE_ROOT/customer/application/cassandra.properties ফাইল তৈরি বা সম্পাদনা করুন।
টম্বস্টোন ওয়ার্ন থ্রেশহোল্ড ডিফল্ট ১০k থেকে ১০০k এ বৃদ্ধি করুন অথবা নিম্নলিখিত লাইনটি যোগ করে যথাযথভাবে আরও বড় মান সেট করুন:
conf_cassandra_tombstone_warn_threshold=100000
উপরের ফাইলটি apigee ব্যবহারকারীর মালিকানাধীন এবং পাঠযোগ্য কিনা তা নিশ্চিত করুন:
নোডে ক্যাসান্ড্রা অ্যাপ্লিকেশনটি পুনরায় চালু করুন:
apigee-service apigee-cassandra restart
প্রতিটি ক্যাসান্ড্রা নোডে উপরের ধাপগুলি একের পর এক পুনরাবৃত্তি করুন।
৪২৭৩৩৮৫৭: এনক্রিপ্টেড কী ভ্যালু ম্যাপ (KVM) আপডেট করার ক্ষেত্রে বিলম্ব
এনক্রিপ্টেড কী ভ্যালু ম্যাপস ব্যবহার করে কাজ করার সময় যেখানে প্রচুর সংখ্যক এন্ট্রি থাকে, ব্যবহারকারীরা এন্ট্রি যোগ বা আপডেট করার সময় বিলম্বের সম্মুখীন হতে পারেন, তা সে ম্যানেজমেন্ট API অথবা KeyValueMapOperations নীতির মধ্যে PUT উপাদানের মাধ্যমেই হোক। কর্মক্ষমতা প্রভাবের পরিমাণ সাধারণত এনক্রিপ্ট করা KVM-এ সংরক্ষিত মোট এন্ট্রির সংখ্যার সমানুপাতিক।
এই সমস্যাটি কমাতে, ব্যবহারকারীদের অতিরিক্ত সংখ্যক এন্ট্রি সহ এনক্রিপ্ট করা KVM তৈরি করা এড়িয়ে চলার পরামর্শ দেওয়া হচ্ছে। একটি কার্যকর সমাধান হল একটি বৃহৎ KVM কে একাধিক, ছোট KVM এ ভাগ করা। উপরন্তু, যদি ব্যবহারের ক্ষেত্রে অনুমতি দেওয়া হয়, তাহলে একটি নন-এনক্রিপ্টেড KVM এ স্থানান্তর করাও কার্যকর প্রশমন কৌশল হিসেবে কাজ করতে পারে। অনুগ্রহ করে মনে রাখবেন যে Apigee এই সমস্যাটি সম্পর্কে সচেতন এবং ভবিষ্যতের প্যাচে একটি সমাধান প্রকাশ করার পরিকল্পনা করছে।
জাভা কলআউটস
"BC" নাম ব্যবহার করে বাউন্সি ক্যাসল ক্রিপ্টোগ্রাফি প্রদানকারী লোড করার চেষ্টা করা গ্রাহক জাভা কলআউটগুলি ব্যর্থ হতে পারে কারণ ডিফল্ট প্রদানকারী FIPS সমর্থন করার জন্য বাউন্সি ক্যাসল FIPS এ পরিবর্তন করা হয়েছে। ব্যবহার করার জন্য নতুন প্রদানকারীর নাম হল "BCFIPS" ।
প্রাইভেট ক্লাউডের জন্য এজ 4.53.00
জাভা কলআউটস
"BC" নাম ব্যবহার করে বাউন্সি ক্যাসল ক্রিপ্টোগ্রাফি প্রদানকারী লোড করার চেষ্টা করা গ্রাহক জাভা কলআউটগুলি ব্যর্থ হতে পারে কারণ ডিফল্ট প্রদানকারী FIPS সমর্থন করার জন্য বাউন্সি ক্যাসল FIPS এ পরিবর্তন করা হয়েছে। ব্যবহার করার জন্য নতুন প্রদানকারীর নাম হল "BCFIPS" ।
এজ ফর প্রাইভেট ক্লাউড ৪.৫২.০১ মিন্ট আপডেট
এই সমস্যাটি শুধুমাত্র তাদের ক্ষেত্রে প্রযোজ্য যারা MINT ব্যবহার করছেন অথবা Edge for Private Cloud ইনস্টলেশনে MINT সক্ষম করেছেন।
প্রভাবিত উপাদান: এজ-মেসেজ-প্রসেসর
সমস্যা: যদি আপনার মনিটাইজেশন সক্ষম থাকে এবং আপনি 4.52.01 কে নতুন ইনস্টল হিসেবে ইনস্টল করেন অথবা পূর্ববর্তী প্রাইভেট ক্লাউড সংস্করণ থেকে আপগ্রেড করেন, তাহলে আপনি মেসেজ প্রসেসরের সাথে একটি সমস্যার সম্মুখীন হবেন। ওপেন থ্রেড কাউন্ট ধীরে ধীরে বৃদ্ধি পাবে যার ফলে রিসোর্স ক্লান্ত হয়ে পড়বে। edge-message-processor system.log-এ নিম্নলিখিত ব্যতিক্রমটি দেখা যায়:
সম্প্রতি HTTP/2 প্রোটোকল (CVE-2023-44487) এর একাধিক বাস্তবায়নে (যার মধ্যে Apigee Edge for Private Cloud অন্তর্ভুক্ত) একটি ডিনায়াল-অফ-সার্ভিস (DoS) দুর্বলতা আবিষ্কৃত হয়েছে। এই দুর্বলতার ফলে Apigee API ব্যবস্থাপনা কার্যকারিতার DoS হতে পারে। আরও বিস্তারিত জানার জন্য, Apigee সিকিউরিটি বুলেটিন GCP-2023-032 দেখুন।
এজ ফর প্রাইভেট ক্লাউড রাউটার এবং ম্যানেজমেন্ট সার্ভারের উপাদানগুলি ইন্টারনেটের সংস্পর্শে আসে এবং সম্ভাব্যভাবে দুর্বল হতে পারে। যদিও এজ ফর প্রাইভেট ক্লাউডের অন্যান্য এজ-নির্দিষ্ট উপাদানগুলির ব্যবস্থাপনা পোর্টে HTTP/2 সক্ষম করা আছে, তবে এই উপাদানগুলির কোনওটিই ইন্টারনেটের সংস্পর্শে আসে না। ক্যাসান্ড্রা, জুকিপার এবং অন্যান্যগুলির মতো নন-এজ উপাদানগুলিতে, HTTP/2 সক্ষম করা নেই। আমরা আপনাকে এজ ফর প্রাইভেট ক্লাউডের দুর্বলতা মোকাবেলা করার জন্য নিম্নলিখিত পদক্ষেপগুলি গ্রহণ করার পরামর্শ দিচ্ছি:
Apigee-postgresql-এর Edge for Private Cloud সংস্করণ 4.50 অথবা 4.51 থেকে 4.52 সংস্করণে আপগ্রেড করার সময় সমস্যা হচ্ছে। সমস্যাগুলি মূলত তখনই ঘটে যখন টেবিলের সংখ্যা 500-এর বেশি হয়।
আপনি নীচের SQL কোয়েরিটি চালিয়ে Postgres-এ মোট টেবিলের সংখ্যা পরীক্ষা করতে পারেন:
১৪৯২৪৫৪০১: LDAP রিসোর্সের মাধ্যমে কনফিগার করা JNDI-এর জন্য LDAP সংযোগ পুল সেটিংস প্রতিফলিত হয় না এবং JNDI ডিফল্টের কারণে প্রতিবার একক ব্যবহারের সংযোগ তৈরি হয়। ফলস্বরূপ, একক ব্যবহারের জন্য প্রতিবার সংযোগ খোলা এবং বন্ধ করা হচ্ছে, যার ফলে LDAP সার্ভারে প্রতি ঘন্টায় প্রচুর সংখ্যক সংযোগ তৈরি হচ্ছে।
সমাধান:
LDAP সংযোগ পুলের বৈশিষ্ট্য পরিবর্তন করার জন্য, সমস্ত LDAP নীতি জুড়ে একটি বিশ্বব্যাপী পরিবর্তন সেট করার জন্য নিম্নলিখিত পদক্ষেপগুলি অনুসরণ করুন।
যদি ইতিমধ্যেই বিদ্যমান না থাকে, তাহলে একটি কনফিগারেশন প্রোপার্টি ফাইল তৈরি করুন:
ফাইলটিতে নিম্নলিখিতটি যোগ করুন (আপনার LDAP রিসোর্স কনফিগারেশনের প্রয়োজনীয়তার উপর ভিত্তি করে জাভা নামকরণ এবং ডিরেক্টরি ইন্টারফেস (JNDI) বৈশিষ্ট্যের মানগুলি প্রতিস্থাপন করুন)।
নিশ্চিত করুন যে /opt/apigee/customer/application/message-processor.properties ফাইলটি apigee:apigee এর মালিকানাধীন।
প্রতিটি বার্তা প্রসেসর পুনরায় চালু করুন।
আপনার সংযোগ পুলের JNDI বৈশিষ্ট্যগুলি কার্যকর হচ্ছে কিনা তা যাচাই করার জন্য, আপনি সময়ের সাথে সাথে LDAP সংযোগ পুলের আচরণ পর্যবেক্ষণ করার জন্য একটি tcpdump সম্পাদন করতে পারেন।
অনুরোধ প্রক্রিয়াকরণে উচ্চ বিলম্ব
১৩৯০৫১৯২৭: মেসেজ প্রসেসরে পাওয়া উচ্চ প্রক্সি প্রসেসিং ল্যাটেন্সি সমস্ত API প্রক্সিকে প্রভাবিত করছে। লক্ষণগুলির মধ্যে রয়েছে স্বাভাবিক API প্রতিক্রিয়া সময়ের তুলনায় প্রক্রিয়াকরণে ২০০-৩০০ মিলিসেকেন্ড বিলম্ব এবং কম TPS থাকা সত্ত্বেও এলোমেলোভাবে ঘটতে পারে। এটি তখন ঘটতে পারে যখন ৫০ টিরও বেশি টার্গেট সার্ভারে একটি মেসেজ প্রসেসর সংযোগ তৈরি করে।
মূল কারণ: মেসেজ প্রসেসরগুলি একটি ক্যাশে রাখে যা টার্গেট সার্ভারের সাথে আউটগোয়িং সংযোগের জন্য টার্গেট সার্ভার URL কে HTTPClient অবজেক্টে ম্যাপ করে। ডিফল্টরূপে এই সেটিংটি 50 এ সেট করা থাকে যা বেশিরভাগ স্থাপনার জন্য খুব কম হতে পারে। যখন একটি স্থাপনার সেটআপে একাধিক org/env সংমিশ্রণ থাকে এবং প্রচুর সংখ্যক টার্গেট সার্ভার থাকে যা মোট 50 এর বেশি হয়, তখন টার্গেট সার্ভার URL গুলি ক্যাশে থেকে বের করে দেওয়া হয়, যার ফলে বিলম্ব ঘটে।
যাচাইকরণ: টার্গেট সার্ভার URL উচ্ছেদের ফলে ল্যাটেন্সি সমস্যা হচ্ছে কিনা তা নির্ধারণ করতে, Message Processor system.logs-এ "onEvict" অথবা "Eviction" কীওয়ার্ড অনুসন্ধান করুন। লগে তাদের উপস্থিতি ইঙ্গিত দেয় যে টার্গেট সার্ভার URL গুলি HTTPClient ক্যাশে থেকে উচ্ছেদ করা হচ্ছে কারণ ক্যাশের আকার খুব ছোট।
সমাধান: Edge for Private Cloud সংস্করণ 19.01 এবং 19.06 এর জন্য, আপনি HTTPClient ক্যাশে সম্পাদনা এবং কনফিগার করতে পারেন, /opt/apigee/customer/application/message-processor.properties :
তারপর মেসেজ প্রসেসরটি পুনরায় চালু করুন। সমস্ত মেসেজ প্রসেসরের জন্য একই পরিবর্তন করুন।
৫০০ মানটি একটি উদাহরণ। আপনার সেটআপের জন্য সর্বোত্তম মানটি মেসেজ প্রসেসর যতগুলি টার্গেট সার্ভারের সাথে সংযুক্ত হবে তার চেয়ে বেশি হওয়া উচিত। এই বৈশিষ্ট্যটি বেশি সেট করার কোনও পার্শ্ব প্রতিক্রিয়া নেই এবং একমাত্র প্রভাব হবে মেসেজ প্রসেসরের প্রক্সি অনুরোধ প্রক্রিয়াকরণের সময় উন্নত করা।
দ্রষ্টব্য: প্রাইভেট ক্লাউড সংস্করণ ৫০.০০ এর জন্য এজ এর ডিফল্ট সেটিং ৫০০।
মূল মান মানচিত্রের জন্য একাধিক এন্ট্রি
১৫৭৯৩৩৯৫৯: প্রতিষ্ঠান বা পরিবেশ স্তরে স্কোপ করা একই কী ভ্যালু ম্যাপে (KVM) সমসাময়িক সন্নিবেশ এবং আপডেটের ফলে অসঙ্গতিপূর্ণ ডেটা এবং হারানো আপডেট দেখা দেয়।
দ্রষ্টব্য: এই সীমাবদ্ধতা শুধুমাত্র প্রাইভেট ক্লাউডের জন্য এজ-এর ক্ষেত্রে প্রযোজ্য। পাবলিক ক্লাউড এবং হাইব্রিডের জন্য এজ-এর এই সীমাবদ্ধতা নেই।
[[["সহজে বোঝা যায়","easyToUnderstand","thumb-up"],["আমার সমস্যার সমাধান হয়েছে","solvedMyProblem","thumb-up"],["অন্যান্য","otherUp","thumb-up"]],[["এতে আমার প্রয়োজনীয় তথ্য নেই","missingTheInformationINeed","thumb-down"],["খুব জটিল / অনেক ধাপ","tooComplicatedTooManySteps","thumb-down"],["পুরনো","outOfDate","thumb-down"],["অনুবাদ সংক্রান্ত সমস্যা","translationIssue","thumb-down"],["নমুনা / কোড সংক্রান্ত সমস্যা","samplesCodeIssue","thumb-down"],["অন্যান্য","otherDown","thumb-down"]],["2026-02-17 UTC-তে শেষবার আপডেট করা হয়েছে।"],[],[]]