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

คุณกําลังดูเอกสารประกอบของ Apigee Edge
ไปที่เอกสารประกอบของ Apigee X info

ส่วนต่อไปนี้จะอธิบายปัญหาที่ทราบเกี่ยวกับ Apigee ในกรณีส่วนใหญ่ ปัญหาที่ระบุไว้จะได้รับการแก้ไขในรุ่นที่จะเปิดตัวในอนาคต

ปัญหาที่ทราบเกี่ยวกับ Edge อื่นๆ

ส่วนต่อไปนี้จะอธิบายปัญหาอื่นๆ ที่ทราบเกี่ยวกับ Edge

พื้นที่/สรุป ปัญหาที่ทราบ
การหมดอายุของแคชส่งผลให้ค่า cachehit ไม่ถูกต้อง

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

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

การตั้งค่านโยบาย InvalidateCache PurgeChildEntries เป็น "จริง" ไม่ทํางานอย่างถูกต้อง

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

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

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

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

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

จํานวนการเรียก API ที่แสดงในข้อมูลวิเคราะห์ Edge API อาจมีข้อมูลที่ซ้ำกัน

บางครั้ง Analytics ของ Edge API อาจมีข้อมูลที่ซ้ำกันสำหรับการเรียก API ในกรณีนี้ จํานวนการเรียก API ที่แสดงใน Analytics ของ Edge API จะสูงกว่าค่าที่เปรียบเทียบได้ซึ่งแสดงในเครื่องมือวิเคราะห์ของบุคคลที่สาม

วิธีแก้ปัญหา: ส่งออกข้อมูลวิเคราะห์และใช้ช่อง gateway_flow_id เพื่อกรองข้อมูลซ้ำออก

ปัญหาที่ทราบเกี่ยวกับ UI ของ Edge

ส่วนต่อไปนี้จะอธิบายปัญหาที่ทราบเกี่ยวกับ UI ของ Edge

พื้นที่ ปัญหาที่ทราบ
เข้าถึงหน้าการดูแลระบบโซน SSO ของ Edge จากแถบนำทางไม่ได้หลังจากที่แมปองค์กรกับโซนข้อมูลประจำตัวแล้ว เมื่อเชื่อมต่อองค์กรกับโซนข้อมูลประจำตัว คุณจะเข้าถึงหน้าการดูแลระบบโซน SSO ของ Edge จาก แถบนำทางด้านซ้ายโดยเลือกผู้ดูแลระบบ > SSO ไม่ได้อีกต่อไป วิธีแก้ปัญหาชั่วคราวคือไปที่หน้าเว็บโดยตรงโดยใช้ URL ต่อไปนี้ https://apigee.com/sso
การกำหนดค่า TLS ของ UI ของ Edge

ตัวเลือก TLS_DISABLED_ALGO และ TLS_ENABLED_CIPHERS ทำงานไม่ถูกต้อง ทำตามวิธีแก้ปัญหาด้านล่างเพื่อเปิดใช้การเข้ารหัสที่เฉพาะเจาะจงสำหรับ UI ของ Edge

  1. เปิด/opt/apigee/etc/edge-ui.d/SSL.shไฟล์การกำหนดค่า
  2. เพิ่มพร็อพเพอร์ตี้ -Djdk.tls.server.cipherSuites พร้อมรายการชุดการเข้ารหัสที่คั่นด้วยคอมมาในรูปแบบ IANA ภายใน UI_OPTIONS เช่น 
    UI_OPTIONS=" -Dhttp.port=disabled -Dhttps.port=9433 -Dhttps.keyStoreType=JKS -Dhttps.keyStore=/opt/apigee/customer/conf/keystore.jks -Dplay.http.sslengineprovider=services.CustomSSLEngineProvider -Dhttps.keyStorePasswordEncrypted=mypass -Djdk.tls.server.cipherSuites=TLS_RSA_WITH_AES_256_CBC_SHA256,TLS_RSA_WITH_AES_256_GCM_SHA384"
  3. บันทึกการเปลี่ยนแปลงลงในไฟล์การกำหนดค่า
  4. รีสตาร์ท UI ของ Edge โดยทำดังนี้ 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

ปัญหาที่ทราบเกี่ยวกับพอร์ทัลที่ผสานรวม

ส่วนต่อไปนี้จะอธิบายปัญหาที่ทราบเกี่ยวกับพอร์ทัลที่ผสานรวม

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

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

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

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

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

  • เมื่อใช้ "ลองใช้ API นี้" ในพอร์ทัล ระบบจะตั้งค่าส่วนหัว Accept เป็น application/json ไม่ว่าค่าที่กําหนดไว้สําหรับ consumes ในข้อกําหนดของ OpenAPI จะเป็นอย่างไรก็ตาม
  • 138438484: ระบบไม่รองรับเซิร์ฟเวอร์หลายเครื่อง
ผู้ให้บริการข้อมูลประจำตัว SAML โดเมนที่กำหนดเองไม่รองรับการออกจากระบบครั้งเดียว (SLO) ด้วยผู้ให้บริการข้อมูลประจำตัว SAML หากต้องการเปิดใช้โดเมนที่กำหนดเองด้วยผู้ให้บริการข้อมูลประจำตัว SAML ให้ปล่อยช่อง URL การลงชื่อออกว่างไว้เมื่อกำหนดการตั้งค่า SAML
ผู้ดูแลระบบพอร์ทัล
  • ปัจจุบันระบบยังไม่รองรับการอัปเดตพอร์ทัลพร้อมกัน (เช่น การแก้ไขหน้าเว็บ ธีม CSS หรือสคริปต์) โดยผู้ใช้หลายคน
  • หากคุณลบหน้าเอกสารประกอบอ้างอิง API ออกจากพอร์ทัล คุณจะสร้างหน้าดังกล่าวอีกครั้งไม่ได้ โดยจะต้องลบและเพิ่มผลิตภัณฑ์ API อีกครั้ง รวมถึงสร้างเอกสารประกอบอ้างอิง API อีกครั้ง
  • เมื่อกำหนดค่านโยบายความปลอดภัยของเนื้อหา ระบบอาจใช้เวลาถึง 15 นาทีเพื่อให้การเปลี่ยนแปลงมีผล
  • เมื่อปรับแต่งธีมพอร์ทัล ระบบอาจใช้เวลาถึง 5 นาทีจึงจะเปลี่ยนธีมให้เสร็จสมบูรณ์
ฟีเจอร์ของพอร์ทัล
  • เราจะผสานรวม Search เข้ากับพอร์ทัลแบบรวมในรุ่นต่อๆ ไป

ปัญหาที่ทราบเกี่ยวกับ Edge for Private Cloud

ส่วนต่อไปนี้อธิบายปัญหาที่ทราบเกี่ยวกับ Edge for Private Cloud

พื้นที่ ปัญหาที่ทราบ
Edge for Private Cloud 4.53.01 การประเมินช่องโหว่ของ NGINX (CVE-2026-42945)

มีการเปิดเผยช่องโหว่ (CVE-2026-42945) ที่ส่งผลต่อ ngx_http_rewrite_module ใน NGINX เครื่องมือสแกนความปลอดภัยอาจแจ้งว่าไบนารีของ NGINX ที่รวมอยู่ใน Apigee Edge for Private Cloud มีปัญหา เนื่องจากโมดูลนี้ได้รับการคอมไพล์แบบคงที่ลงใน NGINX

ผลกระทบต่อ Apigee Edge for Private Cloud:

Apigee Edge for Private Cloud ไม่ได้รับผลกระทบ จากช่องโหว่นี้ในการกำหนดค่าเริ่มต้นที่จัดส่ง ความสามารถในการใช้ประโยชน์จาก CVE-2026-42945 ขึ้นอยู่กับรูปแบบการกำหนดค่า NGINX ที่เฉพาะเจาะจง โดยเฉพาะอย่างยิ่งการใช้คำสั่ง rewrite ในลำดับที่เฉพาะเจาะจง รูปแบบเหล่านี้ไม่มีอยู่ในการกำหนดค่า NGINX มาตรฐานของ Apigee Edge for Private Cloud

ขอให้ดำเนินการดังนี้

  • สำหรับการกำหนดค่าเริ่มต้นของ Apigee Edge for Private Cloud: ไม่จำเป็นต้องใช้แพตช์ อัปเกรด หรือเปลี่ยนแปลงการทำงาน ผลการสแกนเกี่ยวกับ CVE-2026-42945 ถือเป็นผลบวกลวงสำหรับการติดตั้งเริ่มต้นได้ คุณสามารถใช้ข้อความต่อไปนี้เพื่อบันทึกข้อยกเว้นนี้ในระบบการจัดการช่องโหว่

    CVE-2026-42945 — Accepted exception (false positive for Apigee Edge for Private Cloud). Apigee Edge for Private Cloud does not use the rewrite directive in any shipped NGINX configuration. The vulnerable code path in ngx_http_rewrite_module is configuration-gated and is not reachable in the default Apigee Edge for Private Cloud deployment.

  • สำหรับการกำหนดค่า NGINX ที่กำหนดเอง: หากคุณแก้ไขไฟล์การกำหนดค่า NGINX ด้วยตนเองในการติดตั้ง Apigee Edge for Private Cloud (เช่น ใน /opt/nginx) คุณควรทำการตรวจสอบด้วยตนเองต่อไปนี้เพื่อให้แน่ใจว่าการปรับแต่งไม่ได้ทำให้เกิดรูปแบบที่มีช่องโหว่โดยไม่ได้ตั้งใจ
    1. ตรวจสอบคำสั่ง rewrite: เรียกใช้คำสั่งต่อไปนี้ในโหนด NGINX แต่ละโหนด 
      sudo grep -rnI '^\s*rewrite\b' /opt/nginx
    2. วิเคราะห์ผลลัพธ์
      • หากคำสั่งไม่แสดงผลลัพธ์ แสดงว่าระบบของคุณไม่ได้รับผลกระทบ
      • หากพบรายการที่ตรงกัน ให้ตรวจสอบแต่ละอินสแตนซ์ ช่องโหว่จะปรากฏเฉพาะ ในกรณีที่ตรงตามเงื่อนไขต่อไปนี้ทั้งหมด สำหรับบล็อกที่กำหนด
        • มีการใช้คำสั่ง rewrite
        • ตามด้วยคำสั่ง rewrite, if หรือ set อื่นทันทีภายในบล็อกการกำหนดค่าเดียวกัน
        • มีการใช้กลุ่มการจับภาพ PCRE ที่ไม่มีชื่อ (เช่น $1, $2 ฯลฯ) ในคำสั่ง
        • สตริงการแทนที่ในคำสั่งมีเครื่องหมายคำถาม (?)
    3. การบรรเทาผลกระทบ (หากมีช่องโหว่): หากเงื่อนไขทั้งหมดข้างต้นเป็นจริงสำหรับส่วนใดส่วนหนึ่งของการกำหนดค่าที่กำหนดเอง ให้บรรเทาผลกระทบโดยทำดังนี้
      • นำเครื่องหมายคำถาม (?) ออกจากสตริงการแทนที่
      • ใช้กลุ่มการจับภาพ PCRE ที่มีชื่อแทนกลุ่มที่ไม่มีชื่อ
      • ประเมินความจำเป็นของคำสั่งที่เชื่อมต่อกันอีกครั้ง
Edge for Private Cloud 4.53.00 440148595: การแสดงประกาศเตือนป๊อปอัปการสิ้นสุดอายุการใช้งานมากเกินไป

ใน Edge for Private Cloud 4.53.00 ขึ้นไป UI จะแสดง "การสิ้นสุดอายุการใช้งาน" (EOL) ป๊อปอัปคำเตือน คำเตือนนี้ จะปรากฏ
ซ้ำๆ และไม่สามารถป้องกันหรือลดความถี่ได้

ปัจจุบันยังไม่มีวิธีให้ผู้ใช้ปิดใช้หรือลดความถี่ของคำเตือน EOL นี้

Edge for Private Cloud 4.53.01 Java Callouts

Java Callouts ของลูกค้าที่พยายามโหลดผู้ให้บริการด้านวิทยาการเข้ารหัส Bouncy Castle โดยใช้ชื่อ "BC" อาจล้มเหลวเนื่องจากผู้ให้บริการเริ่มต้นเปลี่ยนเป็น Bouncy Castle FIPS เพื่อรองรับ FIPS ชื่อผู้ให้บริการใหม่ที่จะใช้คือ "BCFIPS"
Edge for Private Cloud 4.53.00 Java Callouts

Java Callouts ของลูกค้าที่พยายามโหลดผู้ให้บริการด้านวิทยาการเข้ารหัส Bouncy Castle โดยใช้ชื่อ "BC" อาจล้มเหลวเนื่องจากผู้ให้บริการเริ่มต้นเปลี่ยนเป็น Bouncy Castle FIPS เพื่อรองรับ FIPS ชื่อผู้ให้บริการใหม่ที่จะใช้คือ "BCFIPS"
การอัปเดต Mint ของ Edge for Private Cloud 4.52.01

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

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

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

Error injecting constructor, java.lang.OutOfMemoryError: unable to create new native thread
ช่องโหว่ของ Apigee HTTP/2

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

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

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

  1. อัปเดต Management Server

    1. ในโหนด Management Server แต่ละโหนด ให้เปิด /opt/apigee/customer/application/management-server.properties
    2. เพิ่มบรรทัดนี้ลงในไฟล์พร็อพเพอร์ตี้ 
      conf_webserver_http2.enabled=false
    3. รีสตาร์ทคอมโพเนนต์ Management Server 
      apigee-service edge-management-server restart

  2. อัปเดต Message Processor

    1. ในโหนด Message Processor แต่ละโหนด ให้เปิด /opt/apigee/customer/application/message-processor.properties
    2. เพิ่มบรรทัดนี้ลงในไฟล์พร็อพเพอร์ตี้ 
      conf_webserver_http2.enabled=false
    3. รีสตาร์ทคอมโพเนนต์ Message Processor 
      apigee-service edge-message-processor restart

  3. อัปเดต Router

    1. ในโหนด Router แต่ละโหนด ให้เปิด /opt/apigee/customer/application/router.properties
    2. เพิ่มบรรทัดนี้ลงในไฟล์พร็อพเพอร์ตี้ 
      conf_webserver_http2.enabled=false
    3. รีสตาร์ทคอมโพเนนต์ Message Processor 
      apigee-service edge-router restart

  4. อัปเดต QPID

    1. ในโหนด QPID แต่ละโหนด ให้เปิด /opt/apigee/customer/application/qpid-server.properties
    2. เพิ่มบรรทัดนี้ลงในไฟล์พร็อพเพอร์ตี้ 
      conf_webserver_http2.enabled=false
    3. รีสตาร์ทคอมโพเนนต์ Message Processor 
      apigee-service edge-qpid-server restart

  5. อัปเดต Postgres

    1. ในโหนด Postgres แต่ละโหนด ให้เปิด /opt/apigee/customer/application/postgres-server.properties
    2. เพิ่มบรรทัดนี้ลงในไฟล์พร็อพเพอร์ตี้ 
      conf_webserver_http2.enabled=false
    3. รีสตาร์ทคอมโพเนนต์ Message Processor 
      apigee-service edge-postgres-server restart

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

  1. อัปเดต Management Server

    1. ในโหนด Management Server แต่ละโหนด ให้เปิด /opt/apigee/customer/application/management-server.properties
    2. เพิ่ม 2 บรรทัดต่อไปนี้ลงในไฟล์พร็อพเพอร์ตี้ 
      conf_webserver_http2.enabled=false
conf/webserver.properties+http2.enabled=false
    3. รีสตาร์ทคอมโพเนนต์ Management Server 
      apigee-service edge-management-server restart

  2. อัปเดต Message Processor

    1. ในโหนด Message Processor แต่ละโหนด ให้เปิด /opt/apigee/customer/application/message-processor.properties
    2. เพิ่ม 2 บรรทัดต่อไปนี้ลงในไฟล์พร็อพเพอร์ตี้ 
      conf_webserver_http2.enabled=false
conf/webserver.properties+http2.enabled=false
    3. รีสตาร์ทคอมโพเนนต์ Message Processor 
      apigee-service edge-message-processor restart

  3. อัปเดต Router

    1. ในโหนด Router แต่ละโหนด ให้เปิด /opt/apigee/customer/application/router.properties
    2. เพิ่ม 2 บรรทัดต่อไปนี้ลงในไฟล์พร็อพเพอร์ตี้ 
      conf_webserver_http2.enabled=false
conf/webserver.properties+http2.enabled=false
    3. รีสตาร์ทคอมโพเนนต์ Message Processor 
      apigee-service edge-router restart

  4. อัปเดต QPID

    1. ในโหนด QPID แต่ละโหนด ให้เปิด /opt/apigee/customer/application/qpid-server.properties
    2. เพิ่ม 2 บรรทัดต่อไปนี้ลงในไฟล์พร็อพเพอร์ตี้ 
      conf_webserver_http2.enabled=false
conf/webserver.properties+http2.enabled=false
    3. รีสตาร์ทคอมโพเนนต์ Message Processor 
      apigee-service edge-qpid-server restart

  5. อัปเดต Postgres

    1. ในโหนด Postgres แต่ละโหนด ให้เปิด /opt/apigee/customer/application/postgres-server.properties
    2. เพิ่ม 2 บรรทัดต่อไปนี้ลงในไฟล์พร็อพเพอร์ตี้ 
      conf_webserver_http2.enabled=false
conf/webserver.properties+http2.enabled=false
    3. รีสตาร์ทคอมโพเนนต์ Message Processor 
      apigee-service edge-postgres-server restart
การอัปเกรด Postgresql เมื่ออัปเดตเป็นเวอร์ชัน 4.52

Apigee-postgresql พบปัญหาในการอัปเกรดจาก Edge for 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
นโยบาย LDAP

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. รีสตาร์ท Message Processor แต่ละรายการ

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

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

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

การตรวจสอบ: หากต้องการดูว่าการนำ URL ของเซิร์ฟเวอร์เป้าหมายออกจากแคชทำให้เกิดปัญหาเวลาในการตอบสนองหรือไม่ ให้ค้นหา คีย์เวิร์ด "onEvict" หรือ "Eviction" ใน system.logs ของ Message Processor การปรากฏคีย์เวิร์ดเหล่านี้ในบันทึกบ่งชี้ว่า 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

จากนั้นรีสตาร์ท Message Processor ทำการเปลี่ยนแปลงเดียวกันกับ Message Processor ทั้งหมด

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

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

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

หมายเหตุ: ข้อจำกัดนี้ใช้ได้กับ Edge for Private Cloud เท่านั้น Edge for Public Cloud และ Hybrid ไม่มีข้อจำกัดนี้

หากต้องการแก้ปัญหาเฉพาะหน้าใน Edge for Private Cloud ให้สร้าง KVM ที่ขอบเขต apiproxy