ปัญหาที่ทราบเกี่ยวกับ Apigee

เมื่อใช้ตัวแปรโฟลว์ cachehit หลังนโยบาย LookupCache เนื่องจากมีวิธีส่งจุดแก้ไขข้อบกพร่องสำหรับลักษณะการทำงานแบบไม่สอดคล้องกัน LookupPolicy จึงสร้างออบเจ็กต์ DebugInfo ก่อนการเรียกกลับจะดำเนินการ ซึ่งส่งผลให้เกิดข้อผิดพลาด

วิธีแก้ปัญหาเฉพาะหน้า: ทำตามกระบวนการ (โทรครั้งที่ 2) ซ้ำอีกครั้งทันทีหลังจากโทรครั้งแรก

การตั้งค่า PurgeChildEntries ในนโยบาย InvalidateCache ควรล้างค่าองค์ประกอบ KeyFragment เท่านั้น แต่ล้างแคชทั้งหมด

วิธีแก้ปัญหา: ใช้นโยบาย KeyValueMapOperations เพื่อทําซ้ำการกำหนดเวอร์ชันแคชและไม่ต้องทำให้แคชใช้งานไม่ได้

กรณีนี้อาจเกิดขึ้นได้ เช่น เมื่อมีการเรียกใช้ไปป์ไลน์การติดตั้งใช้งาน CI/CD พร้อมกันโดยใช้การแก้ไขที่แตกต่างกัน เพื่อป้องกันปัญหานี้ โปรดหลีกเลี่ยงการติดตั้งใช้งานพร็อกซี API หรือ SharedFlow ก่อนการติดตั้งใช้งานปัจจุบันเสร็จสมบูรณ์

วิธีแก้ปัญหา: หลีกเลี่ยงการติดตั้งใช้งานพร็อกซี API หรือ SharedFlow พร้อมกัน

• Apigee Edge รองรับข้อกำหนดเฉพาะของ OpenAPI 3.0 เมื่อคุณสร้างข้อกำหนดเฉพาะโดยใช้เครื่องมือแก้ไขข้อกำหนด และเผยแพร่ API โดยใช้ SmartDocs ในพอร์ทัล แต่ยังไม่รองรับฟีเจอร์บางส่วน

  เช่น ระบบยังไม่รองรับฟีเจอร์ต่อไปนี้จากข้อกําหนดของ OpenAPI 3.0

  • พร็อพเพอร์ตี้ allOf สำหรับรวมและสคีมาเพิ่มเติม
  • ข้อมูลอ้างอิงระยะไกล

  หากมีการอ้างอิงถึงฟีเจอร์ที่ไม่รองรับในข้อกำหนด OpenAPI ในบางกรณี เครื่องมือจะละเว้นฟีเจอร์นั้นแต่ยังคงแสดงผลเอกสารอ้างอิง API ในกรณีอื่นๆ ฟีเจอร์ที่ไม่รองรับจะทำให้เกิดข้อผิดพลาดซึ่งทำให้แสดงผลเอกสารอ้างอิง API ไม่สำเร็จ ไม่ว่าในกรณีใด คุณจะต้องแก้ไขข้อกำหนด OpenAPI เพื่อหลีกเลี่ยงการใช้ฟีเจอร์ที่ไม่รองรับจนกว่าจะมีการรองรับฟีเจอร์ดังกล่าวในรุ่นถัดไป

  หมายเหตุ: เนื่องจากเครื่องมือแก้ไขข้อกำหนดมีข้อจำกัดน้อยกว่า SmartDocs เมื่อแสดงผลเอกสารอ้างอิง API คุณจึงอาจเห็นผลลัพธ์ที่แตกต่างกันระหว่างเครื่องมือ

• เมื่อใช้ "ลองใช้ API นี้" ในพอร์ทัล ระบบจะตั้งค่าส่วนหัว Accept เป็น application/json ไม่ว่าค่าที่กําหนดไว้สําหรับ consumes ในข้อกําหนดของ OpenAPI จะเป็นอย่างไรก็ตาม
• 138438484: ระบบไม่รองรับเซิร์ฟเวอร์หลายเครื่อง

• ปัจจุบันระบบยังไม่รองรับการอัปเดตพอร์ทัลพร้อมกัน (เช่น การแก้ไขหน้าเว็บ ธีม CSS หรือสคริปต์) โดยผู้ใช้หลายคน
• หากคุณลบหน้าเอกสารประกอบอ้างอิง API ออกจากพอร์ทัล คุณจะสร้างหน้าดังกล่าวอีกครั้งไม่ได้ โดยจะต้องลบและเพิ่มผลิตภัณฑ์ API อีกครั้ง รวมถึงสร้างเอกสารประกอบอ้างอิง API อีกครั้ง
• เมื่อกำหนดค่านโยบายความปลอดภัยของเนื้อหา ระบบอาจใช้เวลาถึง 15 นาทีเพื่อให้การเปลี่ยนแปลงมีผล
• เมื่อปรับแต่งธีมพอร์ทัล ระบบอาจใช้เวลาถึง 5 นาทีจึงจะเปลี่ยนธีมให้เสร็จสมบูรณ์

• เราจะผสานรวม Search เข้ากับพอร์ทัลแบบรวมในรุ่นต่อๆ ไป

เมื่อคุณอัปเดต Edge สำหรับ Private Cloud จากเวอร์ชัน 4.51.00, 4.52.00 หรือ 4.52.01 เป็น 4.52.02 โปรดทราบว่าจะส่งผลต่อรันไทม์และ Management API เพิ่มเติม

ผลกระทบนี้จะเกิดขึ้นหลังจากอัปเดตโหนด Cassandra และคงอยู่จนกว่าระบบจะอัปเดตโหนดเซิร์ฟเวอร์การจัดการและโหนดโปรแกรมประมวลผลข้อความทั้งหมด

เมื่อเกิดกรณีนี้ขึ้น โปรดทราบว่าคุณอาจได้รับผลกระทบในด้านใดด้านหนึ่งต่อไปนี้

• API รันไทม์ที่รีเฟรชโทเค็น OAuth
• API การจัดการที่แสดงแอปของนักพัฒนาแอป
• API การจัดการที่แสดงผลิตภัณฑ์

Apigee จะเผยแพร่เอกสารประกอบการอัปเดตที่แก้ไขแล้วสำหรับ Edge for Private Cloud 4.52.02 ที่แก้ไขปัญหานี้

ปัญหานี้ส่งผลกระทบต่อผู้ที่ใช้ MINT หรือเปิดใช้ MINT ในการติดตั้ง Edge สำหรับ Private Cloud เท่านั้น

คอมโพเนนต์ที่ได้รับผลกระทบ: edge-message-processor

ปัญหา: หากเปิดใช้การสร้างรายได้และกำลังติดตั้ง 4.52.01 เป็นการติดตั้งใหม่หรืออัปเกรดจากเวอร์ชัน Private Cloud ก่อนหน้า คุณอาจพบปัญหาเกี่ยวกับโปรแกรมประมวลผลข้อความ จำนวนชุดข้อความที่เปิดอยู่จะค่อยๆ เพิ่มขึ้นจนทำให้ทรัพยากรหมด พบข้อยกเว้นต่อไปนี้ใน system.log ของ edge-message-processor

Error injecting constructor, java.lang.OutOfMemoryError: unable to create new native thread

เมื่อเร็วๆ นี้มีการค้นพบช่องโหว่การปฏิเสธการให้บริการ (DoS) ในการใช้งานโปรโตคอล HTTP/2 หลายครั้ง (CVE-2023-44487) ซึ่งรวมถึงใน Apigee Edge สําหรับระบบคลาวด์ส่วนตัว ช่องโหว่นี้อาจทําให้ฟังก์ชันการจัดการ Apigee API เกิดการโจมตีแบบ DoS โปรดดูรายละเอียดเพิ่มเติมที่กระดานข่าวสารด้านความปลอดภัยของ Apigee GCP-2023-032

คอมโพเนนต์เราเตอร์และเซิร์ฟเวอร์การจัดการของ Edge for Private Cloud แสดงอยู่ในอินเทอร์เน็ตและอาจมีช่องโหว่ แม้ว่าจะมีการเปิดใช้ HTTP/2 ในพอร์ตการจัดการของคอมโพเนนต์อื่นๆ สำหรับ Edge โดยเฉพาะของ Edge สำหรับ Private Cloud แต่ไม่มีคอมโพเนนต์ใดที่เปิดเผยต่ออินเทอร์เน็ต ในคอมโพเนนต์ที่ไม่ใช่ Edge เช่น Cassandra, Zookeeper และอื่นๆ ระบบจะไม่เปิดใช้ HTTP/2 เราขอแนะนําให้คุณทําตามขั้นตอนต่อไปนี้เพื่อจัดการช่องโหว่ของ Edge for Private Cloud

• ขั้นตอนสำหรับ Edge for Private Cloud เวอร์ชัน 4.51.00.11 ขึ้นไป
• ขั้นตอนสำหรับ Edge สำหรับ Private Cloud เวอร์ชันเก่ากว่า 4.51.00.11

ทําตามขั้นตอนต่อไปนี้หากคุณใช้ Edge Private Cloud เวอร์ชัน 4.51.00.11 ขึ้นไป

1. อัปเดตเซิร์ฟเวอร์การจัดการ

   1. ในโหนดเซิร์ฟเวอร์การจัดการแต่ละโหนด ให้เปิด /opt/apigee/customer/application/management-server.properties
   2. เพิ่มบรรทัดนี้ลงในไฟล์พร็อพเพอร์ตี้

      conf_webserver_http2.enabled=false

   3. รีสตาร์ทคอมโพเนนต์เซิร์ฟเวอร์การจัดการโดยทำดังนี้

      apigee-service edge-management-server restart

2. อัปเดตโปรแกรมประมวลผลข้อความ

   1. ในโหนดโปรแกรมประมวลผลข้อความแต่ละโหนด ให้เปิด /opt/apigee/customer/application/message-processor.properties
   2. เพิ่มบรรทัดนี้ลงในไฟล์พร็อพเพอร์ตี้

      conf_webserver_http2.enabled=false

   3. รีสตาร์ทคอมโพเนนต์โปรแกรมประมวลผลข้อความโดยทำดังนี้

      apigee-service edge-message-processor restart

3. อัปเดตเราเตอร์

   1. เปิด /opt/apigee/customer/application/router.properties ในโหนดเราเตอร์แต่ละโหนด
   2. เพิ่มบรรทัดนี้ลงในไฟล์พร็อพเพอร์ตี้

      conf_webserver_http2.enabled=false

   3. รีสตาร์ทคอมโพเนนต์โปรแกรมประมวลผลข้อความโดยทำดังนี้

      apigee-service edge-router restart

4. อัปเดต QPID:

   1. เปิด /opt/apigee/customer/application/qpid-server.properties ในโหนด QPID แต่ละโหนด
   2. เพิ่มบรรทัดนี้ลงในไฟล์พร็อพเพอร์ตี้

      conf_webserver_http2.enabled=false

   3. รีสตาร์ทคอมโพเนนต์โปรแกรมประมวลผลข้อความโดยทำดังนี้

      apigee-service edge-qpid-server restart

5. อัปเดต Postgres:

   1. เปิด /opt/apigee/customer/application/postgres-server.properties ในโหนด Postgres แต่ละโหนด
   2. เพิ่มบรรทัดนี้ลงในไฟล์พร็อพเพอร์ตี้

      conf_webserver_http2.enabled=false

   3. รีสตาร์ทคอมโพเนนต์โปรแกรมประมวลผลข้อความโดยทำดังนี้

      apigee-service edge-postgres-server restart

ทําตามขั้นตอนต่อไปนี้หากคุณใช้ Edge for Private Cloud เวอร์ชันเก่ากว่า 4.51.00.11

1. อัปเดตเซิร์ฟเวอร์การจัดการ

   1. ในโหนดเซิร์ฟเวอร์การจัดการแต่ละโหนด ให้เปิด /opt/apigee/customer/application/management-server.properties
   2. เพิ่ม 2 บรรทัดต่อไปนี้ลงในไฟล์พร็อพเพอร์ตี้

      conf_webserver_http2.enabled=false
      conf/webserver.properties+http2.enabled=false

   3. รีสตาร์ทคอมโพเนนต์เซิร์ฟเวอร์การจัดการโดยทำดังนี้

      apigee-service edge-management-server restart

2. อัปเดตโปรแกรมประมวลผลข้อความ

   1. ในโหนดโปรแกรมประมวลผลข้อความแต่ละโหนด ให้เปิด /opt/apigee/customer/application/message-processor.properties
   2. เพิ่ม 2 บรรทัดต่อไปนี้ลงในไฟล์พร็อพเพอร์ตี้

      conf_webserver_http2.enabled=false
      conf/webserver.properties+http2.enabled=false

   3. รีสตาร์ทคอมโพเนนต์โปรแกรมประมวลผลข้อความโดยทำดังนี้

      apigee-service edge-message-processor restart

3. อัปเดตเราเตอร์

   1. เปิด /opt/apigee/customer/application/router.properties ในโหนดเราเตอร์แต่ละโหนด
   2. เพิ่ม 2 บรรทัดต่อไปนี้ลงในไฟล์พร็อพเพอร์ตี้

      conf_webserver_http2.enabled=false
      conf/webserver.properties+http2.enabled=false

   3. รีสตาร์ทคอมโพเนนต์โปรแกรมประมวลผลข้อความโดยทำดังนี้

      apigee-service edge-router restart

4. อัปเดต QPID:

   1. เปิด /opt/apigee/customer/application/qpid-server.properties ในโหนด QPID แต่ละโหนด
   2. เพิ่ม 2 บรรทัดต่อไปนี้ลงในไฟล์พร็อพเพอร์ตี้

      conf_webserver_http2.enabled=false
      conf/webserver.properties+http2.enabled=false

   3. รีสตาร์ทคอมโพเนนต์โปรแกรมประมวลผลข้อความโดยทำดังนี้

      apigee-service edge-qpid-server restart

5. อัปเดต Postgres:

   1. เปิด /opt/apigee/customer/application/postgres-server.properties ในโหนด Postgres แต่ละโหนด
   2. เพิ่ม 2 บรรทัดต่อไปนี้ลงในไฟล์พร็อพเพอร์ตี้

      conf_webserver_http2.enabled=false
      conf/webserver.properties+http2.enabled=false

   3. รีสตาร์ทคอมโพเนนต์โปรแกรมประมวลผลข้อความโดยทำดังนี้

      apigee-service edge-postgres-server restart

Apigee-postgresql พบปัญหาในการอัปเกรดจาก Edge สำหรับ Private Cloud เวอร์ชัน 4.50 หรือ 4.51 เป็นเวอร์ชัน 4.52 ปัญหานี้ส่วนใหญ่เกิดขึ้นเมื่อจํานวนตารางมากกว่า 500 ตาราง

คุณสามารถตรวจสอบจํานวนตารางทั้งหมดใน Postgres ได้โดยเรียกใช้การค้นหา SQL ด้านล่าง

select count(*) from information_schema.tables

วิธีแก้ปัญหา: เมื่อ อัปเดต Apigee Edge 4.50.00 หรือ 4.51.00 เป็น 4.52.00 โปรดตรวจสอบว่าได้ดำเนินการ ขั้นตอนเบื้องต้นก่อนอัปเกรด Apigee-postgresql

149245401: การตั้งค่าพูลการเชื่อมต่อ LDAP สําหรับ JNDI ที่กําหนดค่าผ่านทรัพยากร LDAP จะไม่แสดง และค่าเริ่มต้นของ JNDI จะทําให้การเชื่อมต่อเป็นแบบใช้ครั้งเดียวทุกครั้ง ด้วยเหตุนี้ ระบบจึงเปิดและปิดการเชื่อมต่อทุกครั้งเพื่อการใช้งานครั้งเดียว ซึ่งจะสร้างการเชื่อมต่อกับเซิร์ฟเวอร์ LDAP เป็นจำนวนมากต่อชั่วโมง

วิธีแก้ปัญหา:

หากต้องการเปลี่ยนพร็อพเพอร์ตี้พูลการเชื่อมต่อ LDAP ให้ทําตามขั้นตอนต่อไปนี้เพื่อตั้งค่าการเปลี่ยนแปลงแบบรวมในนโยบาย LDAP ทั้งหมด

1. สร้างไฟล์พร็อพเพอร์ตี้การกําหนดค่า หากยังไม่มี

   /opt/apigee/customer/application/message-processor.properties

2. เพิ่มข้อมูลต่อไปนี้ลงในไฟล์ (แทนที่ค่าของพร็อพเพอร์ตี้ Java Naming and Directory Interface (JNDI) ตามข้อกำหนดในการกําหนดค่าทรัพยากร LDAP)

   bin_setenv_ext_jvm_opts="-Dcom.sun.jndi.ldap.connect.pool.maxsize=20
   -Dcom.sun.jndi.ldap.connect.pool.prefsize=2
   -Dcom.sun.jndi.ldap.connect.pool.initsize=2
   -Dcom.sun.jndi.ldap.connect.pool.timeout=120000
   -Dcom.sun.jndi.ldap.connect.pool.protocol=ssl"

3. ตรวจสอบว่าไฟล์ /opt/apigee/customer/application/message-processor.properties เป็นของ apigee:apigee
4. รีสตาร์ทโปรแกรมประมวลผลข้อความแต่ละรายการ

หากต้องการยืนยันว่าพร็อพเพอร์ตี้ JNDI ของพูลการเชื่อมต่อมีผล ให้ใช้ tcpdump เพื่อสังเกตลักษณะการทํางานของพูลการเชื่อมต่อ LDAP เมื่อเวลาผ่านไป

139051927: เวลาในการตอบสนองของการประมวลผลพร็อกซีสูงที่พบในโปรแกรมประมวลผลข้อความส่งผลต่อพร็อกซี API ทั้งหมด อาการที่พบได้ ได้แก่ เวลาในการประมวลผลที่ล่าช้า 200-300 มิลลิวินาทีกว่าเวลาในการตอบกลับ API ปกติ และอาจเกิดขึ้นแบบสุ่มแม้ว่า TPS จะต่ำก็ตาม กรณีนี้อาจเกิดขึ้นเมื่อเซิร์ฟเวอร์เป้าหมายที่โปรแกรมประมวลผลข้อความเชื่อมต่อมีมากกว่า 50 เซิร์ฟเวอร์

สาเหตุที่แท้จริง: โปรแกรมประมวลผลข้อความจะเก็บแคชที่แมป URL ของเซิร์ฟเวอร์เป้าหมายกับออบเจ็กต์ HTTPClient สำหรับการเชื่อมต่อขาออกไปยังเซิร์ฟเวอร์เป้าหมาย โดยค่าเริ่มต้น การตั้งค่านี้จะมีค่าเป็น 50 ซึ่งอาจต่ำเกินไปสําหรับการใช้งานส่วนใหญ่ เมื่อการทําให้การเผยแพร่มีชุดค่าผสม org/env หลายชุดในการตั้งค่า และเซิร์ฟเวอร์เป้าหมายจํานวนมากเกิน 50 รายการ ระบบจะนํา URL ของเซิร์ฟเวอร์เป้าหมายออกจากแคชอยู่เรื่อยๆ ซึ่งทําให้เกิดความล่าช้า

การตรวจสอบ: หากต้องการตรวจสอบว่าการลบ URL ของเซิร์ฟเวอร์เป้าหมายเป็นสาเหตุของปัญหาเวลาในการตอบสนองหรือไม่ ให้ค้นหาคีย์เวิร์ด "onEvict" หรือ "Eviction" ใน system.logs ของ Message Processor การที่ URL เหล่านี้อยู่ในบันทึกบ่งชี้ว่า URL ของเซิร์ฟเวอร์เป้าหมายถูกนำออกจากแคช HTTPClient เนื่องจากแคชมีขนาดเล็กเกินไป

วิธีแก้ปัญหา: สำหรับ Edge for Private Cloud เวอร์ชัน 19.01 และ 19.06 คุณสามารถแก้ไขและกำหนดค่าแคช HTTPClient /opt/apigee/customer/application/message-processor.properties ได้โดยทำดังนี้

conf/http.properties+HTTPClient.dynamic.cache.elements.size=500

จากนั้นรีสตาร์ทโปรแกรมประมวลผลข้อความ ทำการเปลี่ยนแปลงเดียวกันกับตัวประมวลผลข้อความทั้งหมด

ค่า 500 คือตัวอย่าง ค่าที่เหมาะสมที่สุดสำหรับการตั้งค่าควรมากกว่าจำนวนเซิร์ฟเวอร์เป้าหมายที่โปรแกรมประมวลผลข้อความจะเชื่อมต่อ การตั้งค่าพร็อพเพอร์ตี้นี้ให้สูงขึ้นจะไม่มีผลข้างเคียงใดๆ และผลลัพธ์เพียงอย่างเดียวคือเวลาในการประมวลผลคำขอพร็อกซีของผู้ประมวลผลข้อความจะดีขึ้น

หมายเหตุ: Edge for Private Cloud เวอร์ชัน 50.00 มีการตั้งค่าเริ่มต้นเป็น 500

157933959: การแทรกและการอัปเดตแมปค่าคีย์ (KVM) เดียวกันพร้อมกันซึ่งกำหนดขอบเขตไว้ที่ระดับองค์กรหรือสภาพแวดล้อมทำให้ข้อมูลไม่สอดคล้องกันและการอัปเดตสูญหาย

หมายเหตุ: ข้อจำกัดนี้ใช้กับ Edge สำหรับระบบคลาวด์ส่วนตัวเท่านั้น Edge สำหรับระบบคลาวด์สาธารณะและระบบไฮบริดไม่มีข้อจำกัดนี้

หากต้องการวิธีแก้ปัญหาใน Edge สำหรับ Private Cloud ให้สร้าง KVM ที่ขอบเขต apiproxy