Diagnoseer een hoog CPU-gebruik met Collabora's coolwsd of loolwsd.

Een hoog CPU-gebruik door coolwsdeen ouder loolwsdproces is niet automatisch een fout: Collabora maakt documentverwerkende processen aan en het openen of bewerken van complexe bestanden kan CPU-kracht verbruiken. Identificeer eerst welk proces de CPU-kracht verbruikt en koppel dit vervolgens aan geopende documenten en gebruikers in de beheerdersconsole. Als een document een worker bezig houdt terwijl deze niet actief is, controleer dan de logboeken en de opschooninstellingen voordat u iets opnieuw opstart; het beëindigen van workers kan actieve bewerkingen onderbreken.

De naam van de dienst herkennen en de belasting meten.

Nieuwere installaties gebruiken de coolwsdnaam; oudere installaties kunnen nog steeds de naam weergeven loolwsd. De upgrade-instructies voor Collabora 21.11 beschrijven de eenmalige migratie van /etc/loolwsd/loolwsd.xmlnaar /etc/coolwsd/coolwsd.xml. Zorg ervoor dat de service- en configuratienamen die op uw host zijn geïnstalleerd overeenkomen, in plaats van ervan uit te gaan dat elke implementatie identiek is.

Controleer op een systemd-host de service en toon vervolgens de processen op basis van CPU-gebruik:

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

Als de service een andere naam heeft loolwsd, vervang deze dan door die naam in de systemctl-opdracht. Bekijk meerdere metingen over een bepaalde periode in topplaats van één korte piek als een aanhoudend probleem te beschouwen. Inspecteer de processtructuur: de CPU kan worden gebruikt door documentworkerprocessen onder de daemon, en niet door het hoofdproces zelf. Controleer in Docker het totale containergebruik met docker stats --no-stream CONTAINER_NAME; gebruik in Kubernetes de relevante pod-resource-metrics. Deze metingen beschrijven verschillende bereiken, dus vergelijk de waarden voor host, container en worker zorgvuldig.

Zoek het document of de werklast die de piek veroorzaakt.

Meld u aan bij de beheerdersconsole van Collabora en bekijk verbonden gebruikers, geopende documenten, resourcegebruik en recente grafieken. De officiële FAQ van Collabora beschrijft deze monitoringmogelijkheden. Als de belasting toeneemt tijdens het openen of converteren van een grote spreadsheet, presentatie, PDF of document, observeer dan of deze afneemt nadat die activiteit is voltooid. Een tijdelijke piek in de belasting, gekoppeld aan een daadwerkelijke werkbelasting, vereist capaciteitsplanning of een kleinere werkbelasting; het is op zichzelf geen bewijs van een onbeheersbaar proces.

Als een document na het sluiten door gebruikers nog steeds een hoog CPU-gebruik vertoont, controleer dan of er geen browsersessie of integratie meer actief is die het document openhoudt. Noteer de document-ID die in de console wordt weergegeven, de proces-ID, de duur, het geheugengebruik en of het bestand actief of inactief was. Vermijd het vermelden van persoonlijke of vertrouwelijke documentnamen in openbare ondersteuningsverzoeken.

Vergelijk de daemon met zijn childprocessen; de drukste worker is mogelijk niet het coolwsd-parentproces.

Koppel de CPU-geschiedenis aan actieve gebruikers en documenten voordat u de serverinstellingen wijzigt.

Gebruik logbestanden om een ​​piek te onderscheiden van een vastgelopen worker.

Bij een systemd-installatie via pakketten kunt u de recente serviceberichten controleren:

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

Gebruik deze optie loolwsdals dat de servicenaam op uw systeem is. Let op herhaalde fouten bij het laden of converteren van documenten, herstarts van workers en berichten rond het moment dat het CPU-gebruik toeneemt. Als uw implementatie naar een bestand schrijft in plaats van naar het systeemlogboek, gebruik dan de geconfigureerde logbestemming. Voor containers kunt u de Collabora-containerlogboeken inspecteren met het logcommando van uw runtime. De relevante locatie en beschikbare berichten variëren afhankelijk van de installatiemethode en -versie.

Een terugkerende fout die aan één enkel bestand is gekoppeld, suggereert dat u een kopie van dat bestand moet maken en moet controleren of hetzelfde patroon zich opnieuw voordoet. Een algemene toename over meerdere documenten wijst eerder op gelijktijdigheidsproblemen of een probleem met de servercapaciteit. Update Collabora via het ondersteunde kanaal voor uw installatie als de logboeken wijzen op een bekend defect; raadpleeg de release-opmerkingen voor uw editie en versie in plaats van een niet-gerelateerde tijdelijke oplossing toe te passen.

Pas de gelijktijdigheid alleen aan als er bewijs voor is.

Het configuratieschema van Collabora definieert per_document.max_concurrencyhet maximale aantal threads dat wordt gebruikt tijdens de verwerking van een document. De huidige officiële coolwsd-configuratiesjabloon beschrijft ook opschooncontroles voor documenten die inactief blijven en de geconfigureerde resourcelimieten overschrijden. De exacte standaardwaarden en beschikbare velden kunnen per release verschillen, dus controleer de coolwsd.xmloude configuratie die bij uw geïnstalleerde versie is meegeleverd voordat u wijzigingen aanbrengt.

Het verlagen van de limiet max_concurrencykan het CPU-gebruik per document beperken, maar kan het bewerken, laden of converteren vertragen. Het is geen limiet voor het aantal gebruikers of documenten. Wijzig de limiet alleen nadat u de belasting hebt gecorreleerd met de werkzaamheden per document, voer één aanpassing tegelijk door en vergelijk de reactietijd en het CPU-gebruik onder een representatieve werkbelasting. Plak geen codefragment uit een andere versie rechtstreeks in de productieomgeving zonder de structuur en ondersteunde instellingen te controleren.

De opschoonconfiguratie is bedoeld om resourceverslindende documenten te identificeren die gedurende een ingestelde periode inactief zijn geweest en, wanneer aan de voorwaarden nog steeds wordt voldaan, het bijbehorende documentproces te beëindigen. Het is geen algemene CPU-limiet en lost het CPU-gebruik door actief bewerken of herhaalde conversies niet op. Controleer de inschakeling en drempelwaarden ten opzichte van uw geïnstalleerde configuratie; een te agressief beleid kan een sessie beëindigen die gebruikers nog nodig hebben. Maak een back-up van de configuratie en plan een gecontroleerde herstart van de service als uw wijziging dit vereist.

Vergelijk de servicestatus met recente logberichten om te zien of de stijging van het CPU-gebruik samenvalt met fouten of herstarts van workers.

Controleer het schema van de geïnstalleerde versie voordat u de gelijktijdigheids- of opschoondrempels wijzigt.

Controleer de wijziging veilig.

• Leg de CPU- en geheugenwaarden vast voordat u de configuratie wijzigt.
• Controleer of de belasting toebehoort aan coolwsd/loolwsd zelf of aan een documentworker.
• Gebruik de beheerdersconsole en logboeken om actieve documenten te identificeren en het tijdstip van de piek te bepalen.
• Na een eenmalige, gecontroleerde wijziging, herhaalt u dezelfde werklast en vergelijkt u het CPU-gebruik, de tijd die nodig is om een ​​document te openen, de reactiesnelheid bij het bewerken en het gedrag van de medewerkers.
• Controleer of actieve gebruikers nog steeds kunnen bewerken en opslaan voordat u het probleem als opgelost beschouwt.

Als het CPU-gebruik hoog blijft zonder actieve documenten, aanhoudt na een gecontroleerde herstart of samenvalt met herhaalde crashes, verzamel dan de Collabora-versie, de installatiemethode, service-/containerlogboeken, de processtructuur en de details van de geanonimiseerde documenten voor de beheerder of leverancier. Vermijd het herhaaldelijk beëindigen van onderliggende processen: Collabora beheert deze processen en handmatige beëindiging kan gebruikers hinderen zonder de onderliggende oorzaak op te lossen.