Hohe CPU-Auslastung mit Collaboras coolwsd oder loolwsd diagnostizieren

Eine hohe CPU-Auslastung durch coolwsdältere loolwsdProzesse ist nicht automatisch ein Fehler: Collabora erstellt Dokumentenverarbeitungsprozesse, und das Öffnen oder Bearbeiten komplexer Dateien kann CPU-Leistung beanspruchen. Ermitteln Sie zunächst den Prozess, der die CPU-Leistung verbraucht, und korrelieren Sie ihn anschließend mit geöffneten Dokumenten und Benutzern in der Administrationskonsole. Wenn ein Dokument einen Prozess im Leerlauf blockiert, überprüfen Sie die Protokolle und die Bereinigungseinstellungen, bevor Sie Prozesse neu starten; das Beenden von Prozessen kann die laufende Bearbeitung unterbrechen.

Den Dienstnamen erkennen und die Auslastung messen

Neuere Installationen verwenden den coolwsdNamen; ältere Installationen zeigen möglicherweise noch den alten Namen an loolwsd. Die Upgrade-Hinweise zu Collabora 21.11 beschreiben die einmalige Migration von /etc/loolwsd/loolwsd.xmlzu /etc/coolwsd/coolwsd.xml. Vergleichen Sie die Dienst- und Konfigurationsnamen, die auf Ihrem Host installiert sind, anstatt anzunehmen, dass jede Bereitstellung identisch ist.

Auf einem systemd-Host überprüfen Sie den Dienst und listen dann die Prozesse nach CPU-Auslastung auf:

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

Wenn der Dienst einen Namen hat loolwsd, ersetzen Sie diesen Namen im systemctl-Befehl. Überprüfen Sie mehrere Messwerte im Zeitverlauf, topanstatt einen kurzen Ausreißer als dauerhaftes Problem zu betrachten. Untersuchen Sie die Prozessstruktur: Die CPU kann von den Worker-Prozessen unterhalb des Daemons und nicht vom übergeordneten Prozess selbst belegt sein. Prüfen Sie unter Docker die Container-Gesamtlast mit docker stats --no-stream CONTAINER_NAME; ​​verwenden Sie unter Kubernetes die entsprechenden Pod-Ressourcenmetriken. Diese Messwerte beschreiben unterschiedliche Bereiche, vergleichen Sie daher die Werte für Host, Container und Worker sorgfältig.

Ermitteln Sie das Dokument oder die Arbeitslast, die hinter dem Spitzenwert steckt.

Melden Sie sich in der Collabora-Administrationskonsole an und überprüfen Sie verbundene Benutzer, geöffnete Dokumente, Ressourcennutzung und aktuelle Diagramme. Die offiziellen FAQs von Collabora beschreiben diese Überwachungsfunktionen. Steigt die Last beim Öffnen oder Konvertieren einer großen Tabellenkalkulation, Präsentation, PDF-Datei oder eines Dokuments an, beobachten Sie, ob sie nach Abschluss dieser Aktivität wieder sinkt. Ein vorübergehender Lastanstieg im Zusammenhang mit einer realen Arbeitslast erfordert eine Kapazitätsplanung oder eine Reduzierung der Arbeitslast; er beweist jedoch nicht automatisch einen unkontrollierten Prozess.

Wenn ein Dokument nach dem Schließen weiterhin hohe CPU-Auslastung verursacht, überprüfen Sie, ob es von keiner Browsersitzung oder Integration mehr geöffnet gehalten wird. Notieren Sie die in der Konsole angezeigte Dokument-ID, die Prozess-ID, die Dauer, den Speicherverbrauch und ob die Datei aktiv oder inaktiv war. Vermeiden Sie es, persönliche oder vertrauliche Dokumentnamen in öffentlichen Supportanfragen anzugeben.

Vergleiche den Daemon mit seinen Kindprozessen; der am stärksten ausgelastete Worker ist möglicherweise nicht der übergeordnete Prozess coolwsd.

Korrelieren Sie die CPU-Historie mit den aktiven Benutzern und Dokumenten, bevor Sie die Servereinstellungen ändern.

Anhand von Protokollen lässt sich ein Ausreißer von einem blockierten Worker unterscheiden.

Bei einer paketbasierten systemd-Installation sollten Sie die letzten Dienstmeldungen überprüfen:

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

Verwenden Sie loolwsddiesen Befehl, falls es sich um den Dienstnamen auf Ihrem System handelt. Achten Sie auf wiederholte Fehler beim Laden oder Konvertieren von Dokumenten, Neustarts von Workern und Meldungen, die mit einem Anstieg der CPU-Auslastung einhergehen. Wenn Ihre Bereitstellung in eine Datei anstatt in das Systemjournal schreibt, verwenden Sie das konfigurierte Protokollziel. Überprüfen Sie bei Containern die Collabora-Containerprotokolle mit dem Befehl `log` Ihrer Laufzeitumgebung. Der relevante Speicherort und die verfügbaren Meldungen variieren je nach Installationsmethode und Version.

Ein wiederholter Fehler, der auf eine einzelne Datei zurückzuführen ist, legt nahe, eine Kopie dieser Datei zu erstellen und zu prüfen, ob das gleiche Muster erneut auftritt. Ein allgemeiner Anstieg bei vielen Dokumenten deutet hingegen auf Probleme mit der Serverauslastung oder der gleichzeitigen Nutzung hin. Aktualisieren Sie Collabora über den für Ihre Installation unterstützten Kanal, falls die Protokolle auf einen bekannten Fehler hinweisen. Überprüfen Sie die Versionshinweise für Ihre Edition und Version, anstatt eine nicht damit zusammenhängende Problemumgehung anzuwenden.

Die Parallelität sollte nur dann angepasst werden, wenn dies durch Beweise gerechtfertigt ist.

Das Konfigurationsschema von Collabora definiert per_document.max_concurrencydie maximale Anzahl an Threads, die während der Verarbeitung eines Dokuments verwendet werden. Die aktuelle offizielle CoolWSD-Konfigurationsvorlage dokumentiert außerdem Bereinigungsprüfungen für Dokumente, die inaktiv bleiben und die konfigurierten Ressourcenschwellenwerte überschreiten. Die genauen Standardwerte und verfügbaren Felder können je nach Version variieren. Prüfen Sie daher die coolwsd.xmlmit Ihrer installierten Version ausgelieferte Konfiguration (z. B. die Legacy-Konfiguration) vor Änderungen.

Eine Reduzierung max_concurrencykann zwar die CPU-Auslastung einzelner Dokumente begrenzen, aber die Bearbeitung, das Laden oder die Konvertierung verlangsamen. Sie begrenzt weder die Anzahl der Benutzer noch die Anzahl der Dokumente. Ändern Sie die Einstellung erst, nachdem Sie die Auslastung mit dem jeweiligen Dokumentaufwand korreliert haben. Nehmen Sie jeweils nur eine Anpassung vor und vergleichen Sie Antwortzeit und CPU-Auslastung unter einer repräsentativen Arbeitslast. Kopieren Sie keine Code-Ausschnitte aus anderen Versionen direkt in die Produktionsumgebung, ohne deren Struktur und unterstützte Einstellungen zu überprüfen.

Die Bereinigungskonfiguration dient dazu, ressourcenintensive Dokumente zu identifizieren, die über einen festgelegten Zeitraum inaktiv waren, und den zugehörigen Dokumentprozess zu beenden, sobald die entsprechenden Bedingungen erfüllt sind. Sie ist keine allgemeine CPU-Begrenzung und behebt nicht die CPU-Auslastung durch aktive Bearbeitung oder wiederholte Konvertierungen. Überprüfen Sie die Aktivierung und die Schwellenwerte anhand Ihrer installierten Konfiguration; eine zu restriktive Richtlinie könnte eine Sitzung beenden, die Benutzer noch benötigen. Sichern Sie die Konfiguration und planen Sie einen kontrollierten Neustart des Dienstes, falls Ihre Änderung dies erfordert.

Vergleichen Sie den Dienststatus mit den aktuellen Protokollmeldungen, um festzustellen, ob der Anstieg der CPU-Auslastung mit Fehlern oder Neustarts der Worker zusammenfällt.

Prüfen Sie das Schema der installierten Version, bevor Sie die Schwellenwerte für Parallelität oder Bereinigung ändern.

Überprüfen Sie die Änderung sicher.

• Erfassen Sie die CPU- und Speicherauslastung, bevor Sie die Konfiguration ändern.
• Prüfen Sie, ob die Last zu coolwsd/loolwsd selbst oder zu einem Dokumenten-Worker gehört.
• Nutzen Sie die Admin-Konsole und die Protokolle, um aktive Dokumente zu identifizieren und den Zeitpunkt des Spitzenwerts zu ermitteln.
• Nach einer einzigen kontrollierten Änderung wiederholen Sie die gleiche Arbeitslast und vergleichen die CPU-Auslastung, die Dokumentenöffnungszeit, die Reaktionsfähigkeit bei der Bearbeitung und das Verhalten der Worker.
• Bevor Sie das Problem als gelöst betrachten, vergewissern Sie sich, dass aktive Benutzer weiterhin bearbeiten und speichern können.

Wenn die CPU-Auslastung ohne aktive Dokumente hoch bleibt, auch nach einem kontrollierten Neustart fortbesteht oder wiederholte Abstürze auftreten, erfassen Sie bitte die Collabora-Version, die Installationsmethode, die Dienst-/Containerprotokolle, den Prozessbaum und die anonymisierten Dokumentdetails für den Entwickler oder Anbieter. Vermeiden Sie es, untergeordnete Prozesse wiederholt zu beenden: Collabora verwaltet diese Prozesse, und ein manuelles Beenden kann die Benutzer beeinträchtigen, ohne die Ursache zu beheben.