วิธีแก้ไขปัญหาการใช้งาน CPU สูงใน Collabora Online จาก loolwsd / coolwsd

เมื่อ Collabora Online ใช้ CPU ของเซิร์ฟเวอร์มากเกินไปอย่างกะทันหัน สิ่งสำคัญอันดับแรกคืออย่ารีสตาร์ทเครื่องซ้ำๆ หรือตั้งค่าจำกัด CPU ให้ต่ำมากทันที ให้ตรวจสอบก่อนว่าภาระการใช้งานนั้นมาจากอะไร เช่น การทำงานกับเอกสารตามปกติ เซสชันเอกสารที่ผิดปกติ การทำงานแบบขนานมากเกินไป เซสชันที่ไม่ได้ใช้งานและไม่ได้ถูกล้างข้อมูล หรือข้อผิดพลาดเฉพาะเวอร์ชัน ชื่อกระบวนการอาจปรากฏcoolwsdทั้งในเวอร์ชันปัจจุบันและloolwsdเวอร์ชันเก่า

สถานการณ์จำลอง:ลองนึกภาพเซิร์ฟเวอร์ 8 vCPU ที่ใช้งาน Collabora Online อยู่เบื้องหลัง Nextcloud มีผู้ใช้งานแก้ไขเอกสารเพียงไม่กี่คน แต่คอนเทนเนอร์ Collabora กลับใช้ CPU สูงถึง 250% ถึง 350% เป็นเวลาหลายนาที นี่เป็นเพียงตัวอย่างสมมติที่ใช้ในคู่มือนี้ ไม่ใช่ผลการวัดประสิทธิภาพหรือรายงานจากการใช้งานจริง

ณ เดือนตุลาคม 2026 เวอร์ชันเสถียรปัจจุบันของ Collabora คือ 26.04 และบันทึกการเผยแพร่อย่างเป็นทางการระบุว่า Collabora Online 26.04.3.3 ได้รับการเผยแพร่เมื่อวันที่ 14 กันยายน 2026 เทมเพลตการกำหนดค่าปัจจุบันใช้coolwsdชื่อนี้ เครื่องมือการย้ายข้อมูลของ Collabora ยังคงบันทึกเส้นทางการติดตั้งแบบเก่า/etc/loolwsd/loolwsd.xmlสำหรับเวอร์ชัน 6.4 หรือก่อนหน้านั้น ซึ่งเป็นเหตุผลที่ผู้ดูแลระบบอาจยังคงพบเห็นทั้งสองชื่อนี้

1. ตรวจสอบว่ากระบวนการใดกำลังใช้ CPU อยู่จริง

เริ่มต้นที่ระดับระบบปฏิบัติการหรือคอนเทนเนอร์ ตัวเลขสูงๆ ที่อยู่ข้างๆcoolwsdไม่ได้หมายความว่าดีมอนที่ทำหน้าที่ประสานงานจะเป็นผู้ดำเนินการงานเอกสารที่ใช้ทรัพยากรมากทั้งหมดเสมอไป Collabora ยังรันกระบวนการ kit/forkit สำหรับเซสชันเอกสารด้วย ดังนั้นคุณควรตรวจสอบโครงสร้างกระบวนการและปริมาณการใช้ CPU ต่อกระบวนการก่อนที่จะเปลี่ยนแปลงการกำหนดค่า

ps -eo pid,ppid,pcpu,pmem,etime,cmd --sort=-pcpu | head -n 25
top -H -p $(pgrep -d, -f 'coolwsd|loolwsd|coolkit|loolkit|forkit')

สำหรับ Docker ให้ตรวจสอบคอนเทนเนอร์โดยรวมด้วย:

docker stats --no-stream

ในสถานการณ์ตัวอย่าง สมมติว่าคอนเทนเนอร์ใช้ CPU เกือบ 300% และกระบวนการ kit หนึ่งกระบวนการปรากฏอยู่บนสุดของรายการกระบวนการอย่างต่อเนื่อง นั่นแสดงว่ามีเซสชันเอกสารที่ใช้งานอยู่เฉพาะเจาะจงนั้น มากกว่าที่จะเป็นการสันนิษฐานทั่วไปว่าเซิร์ฟเวอร์ทั้งหมดโอเวอร์โหลด

2. ตรวจสอบตัวชี้วัดของ Collabora เองแทนที่จะพึ่งพาเฉพาะตัวชี้วัดอันดับต้นๆ เท่านั้น

Collabora Online แสดงเมตริกที่เข้ากันได้กับ Prometheus ที่/cool/getMetrics. คู่มือ SDK ปัจจุบันระบุว่าเอนด์พอยต์นี้สามารถรายงานการใช้งาน CPU และหน่วยความจำ กระบวนการของชุดเครื่องมือที่กำลังทำงาน จำนวนมุมมอง และข้อมูลการใช้งานเซิร์ฟเวอร์อื่นๆ โดยใช้การตรวจสอบสิทธิ์แบบเดียวกับคอนโซลผู้ดูแลระบบ เว้นแต่จะมีการกำหนดค่าเมตริกไว้อย่างชัดเจนสำหรับการเข้าถึงโดยไม่ต้องตรวจสอบสิทธิ์

อย่าเปิดเผยปลายทางสำหรับการวัดเมตริกส์สู่สาธารณะเพียงเพื่อลดความยุ่งยากในการแก้ไขปัญหา การกำหนดค่า Helm อย่างเป็นทางการยังมีตัวอย่างสำหรับการบล็อก/cool/getMetricsและ URL สำหรับผู้ดูแลระบบที่จุดเข้าถึง (ingress) ควรใช้เส้นทางภายในที่ต้องมีการตรวจสอบสิทธิ์ทุกครั้งที่เป็นไปได้

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

3. อ่านบันทึกการทำงานในช่วงเวลาที่ CPU มีการใช้งานสูงขึ้นอย่างแม่นยำ

สำหรับการติดตั้งแพ็กเกจที่จัดการโดย systemd:

journalctl -u coolwsd --since "15 minutes ago" --no-pager
journalctl -u coolwsd -f

สำหรับ Docker:

docker logs collabora --since 15m
docker logs -f collabora

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

4. ทำซ้ำขั้นตอนดังกล่าวโดยใช้เอกสารทีละฉบับ

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

การเปรียบเทียบนี้มีประโยชน์มากกว่าการเริ่มบริการใหม่ทั้งหมดในทันที:

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

5. ลดจำนวนการทำงานพร้อมกันต่อเอกสารเมื่อเอกสารหนึ่งสามารถใช้ทรัพยากรซีพียูได้อย่างเต็มที่

เทมเพลตการกำหนดค่า Collabora ปัจจุบันper_document.max_concurrencyระบุจำนวนเธรดสูงสุดที่ใช้ในการประมวลผลเอกสาร โดยค่าเริ่มต้นคือ 4 ในเครื่องที่มีทรัพยากรน้อย หรือเมื่อเอกสารที่ซับซ้อนเพียงฉบับเดียวสามารถใช้ทรัพยากรของเครื่องได้มาก การลดค่านี้จะช่วยให้การใช้งาน CPU คาดการณ์ได้ง่ายขึ้น

ตัวอย่างเช่น คุณสามารถทดสอบค่า 2 ได้:

<per_document>
    <max_concurrency>2</max_concurrency>
</per_document>

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

6. ตรวจสอบการตั้งค่าการล้างข้อมูลและเซสชันที่ไม่ได้ใช้งานก่อนที่จะปรับการตั้งค่าให้เข้มงวดขึ้น

เทมเพลต ปัจจุบันcoolwsd.xmlมีตรรกะการล้างข้อมูลสำหรับเอกสารที่ไม่ได้ใช้งานซึ่งใช้ทรัพยากรมาก ณ เวลาที่เขียนบทความนี้ เทมเพลตแสดงช่วงเวลาตรวจสอบการล้างข้อมูลที่ 10,000 มิลลิวินาที ระยะเวลาการทำงานผิดปกติ 60 วินาที เกณฑ์การไม่ได้ใช้งาน 300 วินาที และเกณฑ์การใช้งาน CPU 85% สำหรับเอกสารที่จะกลายเป็นเอกสารที่ต้องล้างข้อมูล นอกจากนี้ยังรวมถึงการหมดเวลาการไม่ได้ใช้งานต่อเอกสารที่ 3,600 วินาทีด้วย

เทมเพลตเดียวกันนี้รวมถึงการตั้งค่าหมดเวลาต่อการแสดงผลด้วย ค่าปัจจุบันแสดงค่า 300 วินาที ก่อนที่การแสดงผลในเบราว์เซอร์ที่ไม่อยู่ในโฟกัสจะถูกหรี่แสงและหยุดการอัปเดต และ 900 วินาที ก่อนที่การแสดงผลที่ไม่ได้ใช้งานจะถูกจัดการในลักษณะเดียวกัน การตั้งค่าหมดเวลาการแสดงผลเหล่านี้ไม่เหมือนกับการยกเลิกการโหลดเซสชันเอกสารทั้งหมดทันที

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

7. เริ่มการทำงานใหม่หลังจากบันทึกการเปลี่ยนแปลงการตั้งค่าที่ควบคุมแล้วเท่านั้น

สำรองข้อมูลการตั้งค่าที่ใช้งานอยู่ก่อน การติดตั้งแพ็กเกจโดยทั่วไปจะใช้ไฟล์/etc/coolwsd/coolwsd.xml.document.txt ในขณะที่การใช้งาน Docker อาจส่งตัวเลือกเป็นตัวแปรสภาพแวดล้อมหรือการกำหนดค่าผ่านบรรทัดคำสั่ง หรืออาจติดตั้งไฟล์การตั้งค่าลงในคอนเทนเนอร์ ตรวจสอบให้แน่ใจว่าแหล่งที่มาใดใช้งานอยู่จริงก่อนที่จะแก้ไขอะไรก็ตาม

สำหรับการติดตั้งแพ็กเกจ:

sudo cp /etc/coolwsd/coolwsd.xml /etc/coolwsd/coolwsd.xml.before-cpu-tuning
sudo systemctl restart coolwsd
systemctl status coolwsd --no-pager

สำหรับคอนเทนเนอร์ Docker:

docker restart collabora
docker ps --filter name=collabora

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

8. เปรียบเทียบผลก่อนและหลังภายใต้ภาระงานเดียวกัน

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

เมื่อไหร่ควรทำการอัปเดตแทนการปรับแต่ง?

หากพฤติกรรมดังกล่าวเริ่มเกิดขึ้นกับ Collabora เวอร์ชันใดเวอร์ชันหนึ่ง และคุณสามารถจำลองพฤติกรรมนั้นได้ด้วยไฟล์หรือการดำเนินการเฉพาะ การปรับแต่งการตั้งค่าอาจเป็นการปกปิดข้อบกพร่องของซอฟต์แวร์เท่านั้น Collabora แนะนำให้ใช้เวอร์ชันล่าสุดจากสาขาเสถียรปัจจุบัน ณ วันที่ 7 ตุลาคม 2569 หน้าบันทึกการเผยแพร่เวอร์ชัน 26.04 อย่างเป็นทางการระบุว่า 26.04.3.3 เป็นเวอร์ชัน Collabora Online ล่าสุดที่แสดงอยู่

สำหรับผู้ใช้งาน CODE โปรดจำไว้ว่า Collabora ระบุว่า Development Edition เหมาะสำหรับทีมขนาดเล็ก การใช้งานที่บ้าน การพัฒนา และการทดลองใช้ฟังก์ชันใหม่ๆ ในขณะที่ระบุว่าไม่ได้มีไว้สำหรับสภาพแวดล้อมการใช้งานจริง ดังนั้น หากเกิดปัญหาขึ้นในสภาพแวดล้อมการใช้งานจริงบน CODE อาจเป็นเหตุผลที่ควรเปลี่ยนไปใช้ผลิตภัณฑ์ Collabora Online ที่ได้รับการสนับสนุนแทนที่จะเสียเวลาปรับแต่งการทำงานของ Development Edition อย่างไม่รู้จบ

สิ่งที่ไม่ควรทำ

• อย่าคิดว่าcoolwsdตัวเลขสูงๆ จะบ่งชี้ถึงการรั่วไหลของหน่วยความจำหรือลูปไม่สิ้นสุดเสมอไป
• อย่าตั้งค่าการบันทึกข้อมูลการดีบักหรือการติดตามแบบถาวรในระหว่างที่เกิดปัญหาเกี่ยวกับ CPU เว้นแต่คุณจำเป็นต้องใช้จริงๆ เพราะการบันทึกข้อมูลแบบละเอียดจะเพิ่มภาระและภาระในการจัดเก็บข้อมูล
• อย่าเปิดเผยคอนโซลผู้ดูแลระบบหรือจุดเชื่อมต่อเมตริกส์สู่สาธารณะทางอินเทอร์เน็ตเพียงเพื่อความสะดวกในการตรวจสอบ
• อย่าลดเกณฑ์การล้างข้อมูลจนกว่าเซสชันที่ใช้งานอยู่ตามปกติจะถูกปิดลง
• อย่าใช้การกำหนดโควต้า CPU เป็นขั้นตอนแรกในการวินิจฉัยปัญหา การกำหนดขีดจำกัดที่เข้มงวดอาจช่วยปกป้องเครื่องคอมพิวเตอร์เครื่องอื่นบนโฮสต์ที่ใช้ร่วมกันได้ แต่ก็อาจแปลงปัญหา CPU ให้กลายเป็นปัญหาการแสดงผลเอกสารช้าและเกิดการหมดเวลาโดยไม่เปิดเผยสาเหตุที่แท้จริง

ลำดับการแก้ไขปัญหาที่แนะนำ

1. ตรวจสอบว่ากระบวนการที่ยุ่งยากนั้นเป็น กระบวนการชุดอุปกรณ์/ชุดอุปกรณ์สำหรับเด็ก coolwsdแบบเก่าloolwsdหรือแบบใหม่
2. บันทึกการใช้งาน CPU, หน่วยความจำ, เอกสารที่ใช้งานอยู่ และจำนวนการดูของ Docker หรือโฮสต์
3. เชื่อมโยงบันทึกข้อมูลกับช่วงเวลาที่เกิดการพุ่งขึ้นอย่างแม่นยำ
4. จำลองสถานการณ์โดยใช้เอกสารต้องสงสัยหนึ่งฉบับ จากนั้นตามด้วยเอกสารควบคุมอย่างง่ายอีกหนึ่งฉบับ
5. ทดสอบper_document.max_concurrencyเฉพาะในกรณีที่เอกสารฉบับใดฉบับหนึ่งใช้ CPU แบบขนานมากเกินไปเท่านั้น
6. ตรวจสอบการตั้งค่าการล้างข้อมูลและการทำงานในโหมดไม่ได้ใช้งาน โดยไม่ต้องปรับให้เข้มงวดเกินความจำเป็น
7. หลังจากเปลี่ยนแปลงการตั้งค่าทุกครั้ง ให้รีสตาร์ทระบบ และตรวจสอบสถานะการทำงานของบริการ
8. เปรียบเทียบปริมาณงานเดียวกันก่อนและหลังการเปลี่ยนแปลง จากนั้นตรวจสอบเวอร์ชันเสถียรปัจจุบันว่าพฤติกรรมดังกล่าวดูเหมือนจะจำเพาะเจาะจงกับเวอร์ชันหรือไม่

เอกสารอ้างอิงอย่างเป็นทางการ

รายละเอียดการกำหนดค่าในคู่มือนี้อ้างอิงจากเทมเพลตซอร์สโค้ด Collabora Online ปัจจุบัน: เทมเพลตการกำหนดค่า coolwsd.xml ของ Collabora Online คู่มือ SDK อย่างเป็นทางการจะอธิบายเกี่ยวกับการบันทึกข้อมูล การควบคุมประสิทธิภาพ และจุดเชื่อมต่อเมตริกที่เข้ากันได้กับ Prometheus: คู่มือ SDK ของ Collabora Online สำหรับการตรวจสอบเวอร์ชัน ให้ใช้ บันทึกการเผยแพร่ Collabora Online 26.04ของผู้ผลิตสำหรับการใช้งานตามวัตถุประสงค์ของ Development Edition โปรดดูประกาศการเผยแพร่ CODE 26.04 อย่างเป็นทางการ

เป้าหมายในทางปฏิบัติไม่ใช่การบังคับให้ Collabora Online ใช้ CPU น้อยที่สุดเท่าที่จะเป็นไปได้ แต่เป็นการทำให้การใช้ CPU สามารถอธิบายได้และเป็นสัดส่วนกับงานที่มีประโยชน์ ในขณะที่ยังคงรักษาประสิทธิภาพการแก้ไขและการทำงานร่วมกันที่ยอมรับได้