คู่มือการดำเนินการ QPID

Edge สำหรับ Private Cloud เวอร์ชัน 4.52.02 มาพร้อมกับ Qpid Broker-J 8.0.6 หน้านี้อธิบายถึง ข้อควรพิจารณาเกี่ยวกับหน่วยความจำและดิสก์สำหรับ คอมโพเนนต์ apigee-qpidd ของ Edge สำหรับ Private Cloud (ที่มีโบรกเกอร์ที่ใช้ Java) ส่วนด้านล่างมีผลกับ Apigee กรณีการใช้งาน Qpid และอธิบายวิธีปรับแต่ง Qpid โดยใช้กลไกการกำหนดค่าของ Apigee

Qpid ใน Apigee

ใน Apigee นั้น Qpid จะใช้ในเวิร์กโฟลว์หลัก 2 เวิร์กโฟลว์ดังนี้

  • Analytics
  • การสร้างรายได้

ในเวิร์กโฟลว์ทั้งสองนี้ Message Processor จะสร้างข้อความซึ่ง รวบรวมออกเป็นชุดๆ และส่งไปยัง Qpid สำหรับ Analytics ข้อความจะถูกอ่านโดย Qpid-server สำหรับการสร้างรายได้ ข้อมูลเหล่านั้นจะได้รับการอ่านโดยเซิร์ฟเวอร์การให้คะแนน (ส่วนหนึ่งของเซิร์ฟเวอร์การจัดการ) เมื่ออ่านแล้ว ระบบจะเลิกรวมกลุ่มและนำเข้าข้อความเป็นกลุ่ม

ส่วนต่อไปนี้จะอธิบายการกำหนดค่าที่แนะนำสำหรับหน่วยความจำและดิสก์ที่มี Qpid การกำหนดค่าเหล่านี้อิงตามข้อความขนาดเดียวขนาด 2 KB สำหรับ Analytics หรือ การสร้างรายได้ พร้อม ขนาดกลุ่มเริ่มต้นคือ 50 แต่ละข้อความใน Qpid จะมีขนาดประมาณ 100 KB Apigee อนุญาตให้พร็อกซีแก้ไขและเพิ่มข้อมูลเพิ่มเติมในข้อความ (Analytics หรือการสร้างรายได้) ซึ่งจะทำให้เกิดการเปลี่ยนแปลงอย่างมากขนาดของไฟล์ ข้อความเดียวและข้อความแบบกลุ่มโดยรวมใน Qpid ขณะที่ผู้ใช้ทั่วไป คำแนะนำเกี่ยวกับหน่วยความจำและดิสก์ในส่วนด้านล่างนี้ยังคงใช้ได้จริงแม้ในกรณีเช่นนี้ คุณอาจจำเป็นต้องปรับแต่ง Qpid เพิ่มเติมเพื่อให้การทำงานเป็นไปอย่างราบรื่น

หน่วยความจำ

Qpid Broker ใช้หน่วยความจำ 2 ประเภท ได้แก่ หน่วยความจำที่ไม่มีฮีปและหน่วยความจำฮีป Qpid เก็บข้อความใน หน่วยความจำนอกฮีป และใช้หน่วยความจำฮีปสำหรับงานภายในของตัวเองโดยตรง ข้อความไปยังคิวและการแลกเปลี่ยนเป็นต้น ในสถานการณ์ส่วนใหญ่ Apigee จะแนะนำให้คุณเก็บ อัตราส่วน 3:1 ระหว่างหน่วยความจำนอกฮีปและฮีปสำหรับ Qpid Broker

ข้อความในหน่วยความจำนอกฮีปจะยังคงอยู่ในดิสก์ นอกจากนี้ หากการใช้งานทั้งหมด หน่วยความจำนอกฮีปเป็นการละเมิดเกณฑ์บางอย่าง Qpid มีการกำหนดค่าให้ข้อความล้นไปยังดิสก์

โดยค่าเริ่มต้น Apigee จะคำนวณฮีปและหน่วยความจำนอกฮีปของ Qpid Broker โดยอิงตามหน่วยความจำที่มีอยู่ บนโหนด สคริปต์ของ Apigee มีขีดจำกัด Soft อยู่ที่ 4 GB สำหรับฮีปของ Qpid Broker และ หน่วยความจำฟุ่มเฟือย หากคุณต้องการลบล้างขีดจำกัดเหล่านี้ คุณสามารถใช้การกำหนดค่าทั้ง 2 แบบ ด้านล่างเพื่อกำหนดค่าของคุณเองสำหรับหน่วยความจำฮีปและหน่วยความจำนอกฮีปของ Qpid

  • การกำหนดค่าสำหรับหน่วยความจำฮีป: bin_run-qpidd_qpid.run.jvm.max_vm_heap=1024m
  • การกำหนดค่าสำหรับหน่วยความจำนอกฮีป: bin_run-qpidd_qpid.run.jvm.max_direct_memory_size=3072m

โปรดดู วิธีเปลี่ยนการกำหนดค่า Qpid สำหรับ ข้อมูลเกี่ยวกับวิธีลบล้างการกำหนดค่า

สำหรับข้อมูลเพิ่มเติม โปรดดู การอ้างอิง Apache Qpid สำหรับหน่วยความจำ

ดิสก์

ไดเรกทอรีข้อมูลของ Qpid Broker คือ $APIGEE_ROOT/data/apigee-qpidd บันทึก Qpid Broker อยู่ใน $APIGEE_ROOT/var/log/apigee-qpidd

ประสิทธิภาพของระบบไฟล์ที่โฮสต์ไดเรกทอรีข้อมูลคือกุญแจสำคัญในการปฏิบัติงาน นายหน้าโดยรวม เพื่อประสิทธิภาพที่ดีที่สุด ให้เลือกอุปกรณ์ที่มีเวลาในการตอบสนองต่ำและ ที่แอปพลิเคชันอื่นไม่ได้ใช้

Qpid Broker จะเก็บข้อความไว้ในไดเรกทอรีข้อมูล โดยค่าเริ่มต้น นายหน้าจะยอมรับ จนกว่าระบบไฟล์ที่โฮสต์ไดเรกทอรีข้อมูลจะเต็ม 80% คุณสามารถแก้ไข โดยลบล้างการกำหนดค่าที่แสดงในตัวอย่างด้านล่างสำหรับโหนด Qpid แต่ละโหนด

bin_run-qpidd_qpid.store.filesystem.maxUsagePercent=60

ในตัวอย่างนี้ โบรกเกอร์จะปฏิเสธข้อความใหม่เมื่อระบบไฟล์ที่สำคัญคือ 60% เต็มรูปแบบ

วิธีเปลี่ยนการกำหนดค่า Qpid

วิธีเปลี่ยนการกำหนดค่า Qpid

  1. สร้างหรือแก้ไขไฟล์ต่อไปนี้ 
    $APIGEE_ROOT/customer/application/qpidd.properties
  2. เพิ่มหรือนำออก หรือแก้ไขการกำหนดค่าตามที่จำเป็น ตัวอย่างเช่น หากต้องการเปลี่ยนหน่วยความจำฮีปสูงสุดของ Qpid Broker เป็น 6 GB ให้เพิ่มการกำหนดค่าต่อไปนี้ ลบล้างในไฟล์ 
    bin_run-qpidd_qpid.run.jvm.max_vm_heap=6144M
  3. บันทึกการเปลี่ยนแปลงและตรวจสอบว่าผู้ใช้ apigee เป็นเจ้าของและอ่านไฟล์ได้โดยทำดังนี้ 
    chown apigee:apigee $APIGEE_ROOT/customer/application/qpidd.properties
  4. รีสตาร์ทกระบวนการ qpidd: 
    รีสตาร์ท apigee-qpidd ของ apigee-service