توضّح الأقسام التالية المشاكل المعروفة في Apigee. في معظم الحالات، سيتم حلّ المشاكل المُدرَجة في إصدار مستقبلي.
مشاكل Edge المعروفة الأخرى
توضّح الأقسام التالية مشاكل معروفة متنوعة في Edge.
المنطقة/الملخّص
المشاكل المعروفة
تؤدي انتهاء صلاحية ذاكرة التخزين المؤقت إلى ظهور قيمة cachehit غير صحيحة
عند استخدام متغيّر تدفق cachehit بعد سياسة
LookupCache، بسبب طريقة إرسال نقاط تصحيح الأخطاء للسلوك
غير المتزامن، تملأ LookupPolicy عنصر DebugInfo
قبل تنفيذ طلب الاستدعاء، ما يؤدي إلى حدوث خطأ.
الحلّ: كرِّر العملية (إجراء مكالمة ثانية) مرة أخرى
بعد المكالمة الأولى مباشرةً.
ضبط سياسة InvalidateCache
PurgeChildEntries على "صحيح" لا يعمل بشكل صحيح
من المفترض أن يؤدي ضبط القيمة PurgeChildEntries في سياسة
InvalidateCache إلى محو قيم عنصر KeyFragment فقط، ولكن
يتم محو ذاكرة التخزين المؤقت بالكامل.
الحلّ: استخدِم
سياسة KeyValueMapOperations
للتنقّل في إصدارات ذاكرة التخزين المؤقت وتجاوز الحاجة إلى إلغاء صلاحية ذاكرة التخزين المؤقت.
يمكن أن تؤدي طلبات النشر المتزامنة لمسار SharedFlow أو وكيل واجهة برمجة التطبيقات
إلى حالة غير متّسقة في "خادم الإدارة"
حيث يتم عرض نُسخ متعددة على أنّها منشورة.
يمكن أن يحدث ذلك، مثلاً، عند إجراء عمليات تشغيل متزامنة لقناة النشر في عملية التطوير/النشر
باستخدام نُسخ مختلفة. لتجنّب هذه المشكلة، تجنَّب
نشر أدوات الربط بين واجهة برمجة التطبيقات أو SharedFlows قبل اكتمال عملية النشر
الحالية.
الحلّ البديل: تجنَّب عمليات نشر واجهة برمجة التطبيقات الوكيلة أو SharedFlow المتزامنة.
قد تحتوي أعداد طلبات البيانات من واجهة برمجة التطبيقات المعروضة في
إحصاءات Edge API على
بيانات مكرّرة.
يمكن أن تحتوي "إحصاءات Edge API" أحيانًا على بيانات مكرّرة لطلبات البيانات من واجهة برمجة التطبيقات. وفي هذه الحالة، تكون الأعداد المعروضة لطلبات بيانات من واجهة برمجة التطبيقات في Edge API Analytics أعلى من القيم المماثلة المعروضة في أدوات الإحصاءات التابعة لجهات خارجية.
توضح الأقسام التالية المشكلات المعروفة في واجهة مستخدم Edge.
المساحة
المشاكل المعروفة
يتعذّر الوصول إلى صفحة إدارة منطقة الدخول الموحَّد (SSO) على Edge من شريط التنقل بعد ربط المؤسسة بمنطقة هوية.
عند ربط مؤسسة بمنطقة هوية،
لن تتمكّن بعد ذلك من الوصول إلى صفحة إدارة منطقة الدخول المُوحَّد (SSO) على Edge من
شريط التنقل الأيمن من خلال اختيار المشرف > الدخول المُوحَّد (SSO). كحل بديل، يمكنك الانتقال إلى الصفحة مباشرةً باستخدام عنوان URL التالي:
https://apigee.com/sso
المشاكل المعروفة في البوابة المدمجة
توضّح الأقسام التالية المشاكل المعروفة في البوابة المدمجة.
على سبيل المثال، الميزات التالية من مواصفات OpenAPI 3.0 غير متاحة بعد:
allOf خصائص لدمج المخططات وتوسيع نطاقها
المراجع البعيدة
إذا تمت الإشارة إلى ميزة غير متوافقة في مواصفات OpenAPI، ستتجاهل الأدوات الميزة في بعض الحالات، ولكن ستظل تعرِض مستندات مرجعية لواجهة برمجة التطبيقات. وفي حالات أخرى، ستؤدي الميزة غير المتوافقة إلى ظهور أخطاء تمنع المعالجة الناجحة
لمستندات مرجع واجهة برمجة التطبيقات. وفي كلتا الحالتَين، عليك تعديل مواصفات OpenAPI لتجنُّب استخدام الميزة غير المتوافقة
إلى أن تصبح متوافقة في إصدار مستقبلي.
ملاحظة: بما أنّ محرِّر المواصفات أقل تقييدًا من SmartDocs عند عرض مستندات مرجعية لواجهة برمجة التطبيقات،
قد تلاحظ نتائج مختلفة بين الأداتَين.
عند استخدام ميزة "تجربة واجهة برمجة التطبيقات هذه" في البوابة، يتم ضبط رأس Accept على application/json بغض النظر عن القيمة التي تم ضبطها لـ consumes في مواصفات OpenAPI.
لا تتوفّر ميزة "تسجيل الخروج الفردي" (SLO) باستخدام موفِّر الهوية SAML لنطاقات الويب المخصّصة. لتفعيل نطاق مخصّص باستخدام موفِّر هوية SAML، اترك الحقل عنوان URL لتسجيل الخروج فارغًا عند ضبط إعدادات SAML.
مشرف البوابة
لا تتوفّر حاليًا إمكانية إجراء تعديلات متزامنة على البوابة (مثل تعديلات الصفحة أو المظهر أو CSS أو النصوص البرمجية) من قِبل مستخدمين متعدّدين.
إذا حذفت صفحة مستندات مرجعية لواجهة برمجة التطبيقات من البوابة، لن تتمكّن من إعادة إنشائها. عليك حذف
منتج واجهة برمجة التطبيقات وإعادة إضافته، ثم إعادة إنشاء مستندات مرجعية لواجهة برمجة التطبيقات.
لا تتوفّر حاليًا أي طريقة للمستخدمين لإيقاف تحذير انتهاء العمر الافتراضي هذا أو تقليل عدد مرات ظهوره.
Edge for Private Cloud 4.53.01
443272053: أخطاء في مخزن البيانات في مكوّنات Edge
في Edge for Private Cloud 4.53.00 أو الإصدارات الأحدث، قد يؤدي نوع معيّن من التفاعل بين Cassandra ومكوّنات التطبيق (خادم الإدارة أو معالج الرسائل أو جهاز التوجيه) إلى حدوث أخطاء في مخزن البيانات. عند حدوث مثل هذا الخطأ، ستلاحظ سجلّات بالنمط التالي في سجلّات النظام الخاصة بمكوّن التطبيق المحدّد:
com.datastax.driver.core.exceptions.ProtocolError: An unexpected protocol error occurred on host WW.XX.YY.ZZ:9042.
تحدث هذه الأخطاء عندما لا يتم ضبط مكوّن التطبيق للتعامل مع التحذيرات التي تنشئها قاعدة بيانات Cassandra. يمكنك الحدّ من هذه المشكلة من خلال تجنُّب التحذيرات أو إيقافها في عقد Cassandra. في معظم الحالات، يتم إنشاء التحذيرات بسبب عدد كبير جدًا من علامات الحذف. يمكنك اتّباع أحد الخيارات التالية أو مجموعة من الخيارات المُدرَجة:
تقليل gc_grace_seconds: بالنسبة إلى الجدول المعروض في رسالة السجلّ المرتبطة بالخطأ، قلِّل قيمة gc_grace_seconds من خلال تنفيذ الأمر التالي على النحو التالي باستخدام cqlsh:
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';
زيادة حدود tombstone في Cassandra لإنشاء تحذيرات لإجراء ذلك، اتّبِع التعليمات التالية:
في عقدة Cassandra، أنشئ الملف $APIGEE_ROOT/customer/application/cassandra.properties أو عدِّله.
ارفع Tombstone warn threshold إلى 100 ألف من القيمة التلقائية البالغة 10 آلاف أو اضبط قيمًا أكبر حسب الاقتضاء عن طريق إضافة السطر التالي:
conf_cassandra_tombstone_warn_threshold=100000
تأكَّد من أنّ مستخدم Apigee يملك الملف أعلاه ويمكنه قراءته:
كرِّر الخطوات أعلاه على كل عقدة Cassandra، واحدة تلو الأخرى.
42733857: تأخُّر في تعديل خرائط قيم المفاتيح (KVM) المشفرة
عند استخدام خرائط قيم المفاتيح المشفّرة التي تحتوي على عدد كبير من الإدخالات، قد يواجه المستخدمون حالات تأخير عند إضافة الإدخالات أو تعديلها، سواء من خلال واجهات برمجة التطبيقات الإدارية أو العنصر PUT ضمن السياسة KeyValueMapOperations . يتناسب مدى تأثير الأداء بشكل عام مع إجمالي عدد الإدخالات المخزَّنة في KVM المشفَّرة.
للحدّ من هذه المشكلة، يُنصح المستخدمون بتجنُّب إنشاء KVM مشفّرة تتضمّن عددًا كبيرًا من الإدخالات. الحلّ المناسب هو تقسيم آلة KVM كبيرة إلى عدة آلات KVM أصغر. بالإضافة إلى ذلك، إذا كانت حالة الاستخدام تسمح بذلك، يمكن أن يكون الانتقال إلى KVM غير مشفّر أيضًا بمثابة استراتيجية فعّالة للحدّ من المخاطر. يُرجى العِلم أنّ فريق Apigee على عِلم بهذه المشكلة ويخطّط لإصدار حلّ لها في رمز تصحيح مستقبلي.
وسائل شرح Java
قد يتعذّر تنفيذ عمليات ربط Java المخصّصة التي تحاول تحميل موفّر التشفير Bouncy Castle باستخدام الاسم "BC"، وذلك لأنّه تم تغيير الموفّر التلقائي إلى Bouncy Castle FIPS من أجل توفير دعم لمعيار FIPS. اسم مقدّم الخدمة الجديد الذي سيتم استخدامه هو "BCFIPS".
الإصدار 4.53.00 من Edge for Private Cloud
وسائل شرح Java
قد يتعذّر تنفيذ عمليات ربط Java المخصّصة التي تحاول تحميل موفّر التشفير Bouncy Castle باستخدام الاسم "BC"، وذلك لأنّه تم تغيير الموفّر التلقائي إلى Bouncy Castle FIPS من أجل توفير دعم لمعيار FIPS. اسم مقدّم الخدمة الجديد الذي سيتم استخدامه هو "BCFIPS".
تحديث Mint في الإصدار 4.52.01 من Edge for Private Cloud
لا تؤثّر هذه المشكلة إلا في المستخدمين الذين يستخدمون MINT أو فعّلوا MINT في عمليات تثبيت Edge for Private Cloud.
المكوّن المتأثر: edge-message-processor
المشكلة: إذا كانت ميزة تحقيق الربح مفعّلة وكنت بصدد تثبيت الإصدار 4.52.01 كتثبيت جديد أو الترقية من إصدارات Private Cloud السابقة، ستواجه مشكلة في معالجات الرسائل. سيحدث ارتفاع تدريجي في عدد سلاسل المحادثات المفتوحة، ما يؤدي إلى استنفاد الموارد. يظهر الاستثناء التالي في ملف system.log الخاص بـ edge-message-processor:
تم مؤخرًا اكتشاف ثغرة أمنية تؤدي إلى رفض الخدمة (DoS) في عمليات تنفيذ متعددة لبروتوكول HTTP/2 (CVE-2023-44487)، بما في ذلك في Apigee Edge للسحابة الخاصة. يمكن أن يؤدي الثغرة الأمنية إلى حدوث هجوم DoS على وظائف إدارة واجهة برمجة التطبيقات في Apigee.
لمزيد من التفاصيل، يُرجى الاطّلاع على نشرة أمان Apigee GCP-2023-032.
تكون مكوّنات جهاز التوجيه وخادم الإدارة في Edge for Private Cloud معرَّضة للإنترنت، وقد تكون عرضة للخطر. على الرغم من تفعيل بروتوكول HTTP/2 على منفذ الإدارة الخاص بمكوّنات Edge الأخرى المخصّصة لـ Edge for Private Cloud، لا يتم عرض أي من هذه المكوّنات على الإنترنت. في المكوّنات غير التابعة لـ Edge، مثل Cassandra وZookeeper وغيرها، لا يتم تفعيل HTTP/2. ننصحك باتّباع الخطوات التالية لمعالجة الثغرة الأمنية في Edge for Private Cloud:
تواجه Apigee-postgresql مشاكل في الترقية من الإصدار 4.50 أو 4.51 إلى الإصدار 4.52 من Edge for Private Cloud. تحدث المشاكل بشكل أساسي عندما يكون عدد الجداول أكبر من 500.
يمكنك التحقّق من إجمالي عدد الجداول في Postgres من خلال تنفيذ طلب بحث SQL أدناه:
149245401: لا تظهر إعدادات مجموعة اتصالات LDAP لـ JNDI التي تم ضبطها من خلال مورد LDAP، وتتسبّب إعدادات JNDI التلقائية في إنشاء اتصالات للاستخدام الفردي في كل مرة.
ونتيجةً لذلك، يتم فتح الاتصالات وإغلاقها في كل مرة لاستخدامها مرة واحدة، ما يؤدي إلى إنشاء عدد كبير من الاتصالات في الساعة بخادم LDAP.
الحل البديل:
لتغيير خصائص مجموعة اتصالات LDAP، اتّبِع الخطوات التالية لإجراء تغيير عام على مستوى جميع سياسات LDAP.
تأكَّد من أنّ الملف /opt/apigee/customer/application/message-processor.properties مملوك من خلال apigee:apigee.
أعِد تشغيل كل معالج رسائل.
للتحقّق من أنّ خصائص JNDI لمجموعة الاتصالات تعمل، يمكنك تنفيذ tcpdump لمراقبة سلوك مجموعة اتصالات LDAP بمرور الوقت.
وقت استجابة طويل لمعالجة الطلبات
139051927: تم رصد حالات تأخير عالية في معالجة الخادم الوكيل في "معالج الرسائل"،
ما يؤثر في
جميع خوادم API الوكيلة. تشمل الأعراض تأخيرًا يتراوح بين 200 و300 مللي ثانية في أوقات المعالجة مقارنةً بأوقات ردّ من واجهة برمجة التطبيقات العادية، ويمكن أن تحدث بشكل عشوائي حتى مع انخفاض عدد المعاملات في الثانية. يمكن أن يحدث ذلك عندما يكون هناك أكثر من 50 خادم مستهدف
يُجري معالج الرسائل اتصالات به.
السبب الأساسي:
تحتفظ معالجات الرسائل بذاكرة تخزين مؤقت تربط عنوان URL الخاص بالخادم المستهدَف بكائن HTTPClient
للاتصالات الصادرة إلى الخوادم المستهدَفة. يتم ضبط هذا الإعداد تلقائيًا على 50، وهو ما قد يكون منخفضًا جدًا بالنسبة إلى معظم عمليات النشر. عندما يتضمّن عملية النشر عدة مجموعات من المؤسسات/البيئات في عملية الإعداد،
ويكون هناك عدد كبير من الخوادم المستهدَفة التي تتجاوز 50 خادمًا إجمالاً، يتم إزالة عناوين URL الخاصة بالخوادم المستهدَفة
من ذاكرة التخزين المؤقت باستمرار، ما يؤدي إلى حدوث حالات تأخير.
التحقّق من الصحة:
لتحديد ما إذا كان إخلاء عنوان URL الخاص بالخادم المستهدف يتسبّب في مشكلة وقت الاستجابة، ابحث في
logs.system الخاصة بـ "معالج الرسائل"
عن الكلمة الرئيسية "onEvict" أو "Eviction". ويشير وجودها في السجلات إلى أنّه يتم إزالة عناوين URL الخاصة بالخادم المستهدف من ذاكرة التخزين المؤقت لبرنامج HTTPClient لأنّ حجم ذاكرة التخزين المؤقت صغير جدًا.
الحل البديل:
بالنسبة إلى الإصدارَين 19.01 و19.06 من Edge for Private Cloud، يمكنك تعديل ذاكرة التخزين المؤقت لـ HTTPClient وضبطها، /opt/apigee/customer/application/message-processor.properties:
بعد ذلك، أعِد تشغيل معالج الرسائل. أجرِ التغييرات نفسها على جميع معالِجات الرسائل.
القيمة 500 هي مثال. يجب أن تكون القيمة المثالية لإعدادك أكبر من عدد الخوادم المستهدَفة التي ستتصل بها أداة معالجة الرسائل. ما مِن آثار جانبية لضبط هذه السمة على قيمة أعلى، والتأثير الوحيد سيكون تحسين أوقات معالجة طلبات وكيل معالج الرسائل.
ملاحظة: يحتوي الإصدار 50.00 من Edge for Private Cloud على الإعداد التلقائي 500.
إدخالات متعدّدة لخرائط قيم المفاتيح
157933959: تؤدي عمليات الإدراج والتعديل المتزامنة لخريطة قيم المفاتيح (KVM) نفسها التي تم تحديد نطاقها على مستوى المؤسسة أو البيئة إلى بيانات غير متّسقة وتعديلات مفقودة.
ملاحظة: ينطبق هذا القيد على Edge for Private Cloud فقط. لا تنطبق هذه القيود على Edge for Public Cloud
وHybrid.
لحلّ بديل في Edge for Private Cloud، أنشئ آلة KVM في نطاق apiproxy.
تاريخ التعديل الأخير: 2026-02-03 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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-03 (حسب التوقيت العالمي المتفَّق عليه)"],[],[]]