使用 Collabora 的 coolwsd 或 loolwsd 診斷 CPU 使用率過高問題

CPU 使用率過高coolwsd，尤其是來自較舊loolwsd進程的進程，並不一定意味著故障：Collabora 會建立文件處理工作進程，而開啟或編輯複雜文件會佔用 CPU 資源。首先要確定哪個進程正在消耗 CPU，然後將其與管理控制台中開啟的文件和使用者關聯起來。如果某個文件在空閒時仍然佔用一個工作進程，請在重啟任何進程之前檢查日誌和清理設定；終止工作進程可能會中斷正在進行的編輯操作。

識別服務名稱並測量負載

新安裝版本使用此coolwsd名稱；舊安裝版本可能仍顯示舊名稱loolwsd。 Collabora 21.11 升級說明/etc/loolwsd/loolwsd.xml描述了從舊名稱到新名稱的一次性遷移/etc/coolwsd/coolwsd.xml。請核對主機上安裝的服務和設定名稱，不要假設每個部署都相同。

在 systemd 主機上，檢查服務，然後按 CPU 使用率列出進程：

systemctl status coolwsd
ps -eo pid,ppid,%cpu,%mem,etime,cmd --sort=-%cpu | head -n 20

如果服務名稱為 `<service_name>` loolwsd，請在 `systemctl` 指令中取代該名稱。使用 `systemctl` 指令查看一段時間內的多個讀數，top而不是將一次短暫的峰值視為持續性問題。檢查程序樹：CPU 可能被守護程序下的文件工作程序佔用，而不是被父程序本身佔用。在 Docker 中，使用 `systemctl` 指令檢查容器總資源docker stats --no-stream CONTAINER_NAME；在 Kubernetes 中，使用相關的 Pod 資源指標。這些讀數描述的是不同的範圍，因此請仔細比較主機、容器和工作進程的值。

找出導致峰值出現的文件或工作量。

登入 Collabora 管理控制台，查看已連線使用者、開啟的文件、資源使用情況和最近查看的圖表。 Collabora 的官方常見問題中介紹了這些監控功能。如果在開啟或轉換大型電子表格、簡報、PDF 或文件時負載上升，請觀察活動結束後負載是否下降。與實際工作負載相關的臨時負載激增需要進行容量規劃或減少工作負載；它本身並不能證明進程失控。

如果使用者關閉某個文件後，該文件仍佔用大量 CPU 資源，請確認沒有瀏覽器工作階段或整合程式仍在開啟該文件。記錄控制台中顯示的文件識別碼、進程 ID、持續時間、記憶體佔用以及文件處於活動狀態還是空閒狀態。請勿在公開的支援請求中提及個人或機密文件的名稱。

將守護程序與其子程序進行比較；最繁忙的工作進程可能不是 coolwsd 父進程。

在變更伺服器設定之前，請將 CPU 歷史記錄與活躍使用者和文件進行關聯。

使用日誌來區分峰值異常和卡住的進程

對於基於軟體包的 systemd 安裝，請檢查最近的服務訊息：

journalctl -u coolwsd --since "15 minutes ago"

如果這是您系統上的服務名稱，請使用它loolwsd。尋找重複的文件載入或轉換錯誤、工作進程重新啟動以及 CPU 使用率上升前後出現的訊息。如果您的部署將日誌寫入檔案而不是系統日誌，請使用配置的日誌目標位置。對於容器，請使用運行時環境的日誌命令檢查 Collabora 容器日誌。相關位置和可用訊息因安裝方法和版本而異。

如果某個文件重複出現錯誤，則應隔離該文件的副本，並測試是否出現相同的錯誤模式。如果多個文件都出現類似錯誤，則可能表示並發或伺服器容量不足。如果日誌指向已知缺陷，請透過您安裝的官方管道更新 Collabora；請查閱您版本對應的發行說明，而不是使用不相關的變通方法。

僅當有證據支持時才調整並發性

Collabora 的設定方案per_document.max_concurrency將處理文件時使用的最大執行緒數定義為 np。目前官方的 coolwsd 配置範本也記錄了對閒置文件進行清理檢查，這些文件會超出配置的資源閾值。特定的預設值和可用欄位可能因版本而異，因此coolwsd.xml在進行任何變更之前，請檢查已安裝版本附帶的舊版配置。

降低此設定max_concurrency可能會限制單一文件的 CPU 使用量，但會降低編輯、載入或轉換速度。它並非限制使用者或文件數量。只有在將負載與單一文件的工作量關聯起來後才能更改此設置，每次只進行一項調整，並在具有代表性的工作負載下比較響應時間和 CPU 使用率。切勿在未驗證其結構和支援的設定的情況下，直接將其他版本的程式碼片段貼到生產環境中。

清理配置旨在識別已閒置一段時間的資源消耗型文檔，並在滿足相應條件時終止相關文檔程序。它並非通用的 CPU 限制器，也無法解決因活躍編輯或重複轉換而導致的 CPU 使用率過高的問題。請根據您已安裝的配置檢查其啟用狀態和閾值；過於激進的策略可能會關閉使用者仍在使用的會話。如果您的變更需要重新啟動服務，請備份配置並規劃一次受控的服務重新啟動。

將服務狀態與最近的日誌訊息進行比較，以查看 CPU 上升是否與錯誤或工作進程重新啟動同時發生。

在變更並發或清除閾值之前，請檢查已安裝版本的架構。

安全地驗證更改。

• 更改配置前，請擷取 CPU 和記憶體讀數。
• 確認負載是屬於 coolwsd/loolwsd 本身還是屬於文件工作進程。
• 使用管理控制台和日誌來識別活動文件並關聯峰值時間。
• 在進行一次受控變更後，重複相同的工作負載，並比較 CPU、文件開啟時間、編輯回應速度和工作者行為。
• 在確認活躍用戶仍可編輯和儲存之前，請勿認為問題已解決。

如果 CPU 使用率在沒有活動文件的情況下仍然很高，或者在受控重啟後仍然存在，或者伴隨反复崩潰，請收集 Collabora 版本、安裝方法、服務/容器日誌、進程樹以及經過脫敏處理的文檔詳細信息，以便提供給維護者或供應商。避免重複終止子進程：Collabora 會管理這些工作進程，手動終止可能會中斷使用者體驗，無法解決根本原因。