Diagnostica l'elevato utilizzo della CPU da coolwsd o loolwsd di Collabora.

Un elevato utilizzo della CPU da parte di coolwsdun processo obsoleto loolwsdnon è automaticamente indice di un errore: Collabora crea processi di elaborazione documenti e l'apertura o la modifica di file complessi può consumare CPU. Innanzitutto, identifica quale processo sta consumando CPU, quindi correlalo ai documenti aperti e agli utenti nella Console di amministrazione. Se un documento tiene occupato un processo di elaborazione anche quando è inattivo, controlla i log e le impostazioni di pulizia prima di riavviare qualsiasi operazione; la terminazione dei processi di elaborazione può interrompere la modifica in corso.

Riconosci il nome del servizio e misura il carico

Le installazioni più recenti utilizzano il coolwsdnome; le installazioni più vecchie potrebbero ancora mostrare loolwsd. Le note di aggiornamento di Collabora 21.11 descrivono la migrazione una tantum da /etc/loolwsd/loolwsd.xmla /etc/coolwsd/coolwsd.xml. Fai corrispondere i nomi del servizio e della configurazione installati sul tuo host invece di presumere che ogni implementazione sia identica.

Su un host systemd, controlla il servizio e poi elenca i processi in base all'utilizzo della CPU:

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

Se il servizio ha un nome loolwsd, sostituisci quel nome nel comando systemctl. Esamina più letture nel tempo con toppiuttosto che considerare un picco breve come un problema persistente. Ispeziona l'albero dei processi: la CPU potrebbe essere utilizzata dai processi di lavoro dei documenti sottostanti al demone, non dal processo padre stesso. Su Docker, controlla il totale del container con docker stats --no-stream CONTAINER_NAME; in Kubernetes, usa le metriche delle risorse del pod pertinenti. Queste letture descrivono ambiti diversi, quindi confronta attentamente i valori di host, container e worker.

Individua il documento o il carico di lavoro alla base del picco

Accedi alla console di amministrazione di Collabora e controlla gli utenti connessi, i documenti aperti, l'utilizzo delle risorse e i grafici recenti. Le FAQ ufficiali di Collabora descrivono queste funzionalità di monitoraggio. Se il carico aumenta durante l'apertura o la conversione di un foglio di calcolo, una presentazione, un PDF o un documento di grandi dimensioni, verifica se diminuisce al termine dell'attività. Un picco temporaneo legato a un carico di lavoro reale richiede una pianificazione della capacità o una riduzione del carico di lavoro; di per sé non indica un processo fuori controllo.

Se un documento continua a consumare molta CPU anche dopo essere stato chiuso dagli utenti, verificare che nessuna sessione del browser o integrazione lo mantenga aperto. Annotare l'identificativo del documento visualizzato nella console, l'ID del processo, la durata, la memoria utilizzata e se il file era attivo o inattivo. Evitare di inserire nomi di documenti personali o riservati nelle richieste di supporto pubbliche.

Confronta il demone con i suoi processi figli; il processo più occupato potrebbe non essere il processo padre coolwsd.

Prima di modificare le impostazioni del server, correla la cronologia dell'utilizzo della CPU con gli utenti attivi e i documenti.

Utilizzare i log per distinguere un picco da un lavoratore bloccato

Per un'installazione di systemd basata su pacchetti, esaminare i messaggi di servizio recenti:

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

Utilizzare questo comando loolwsdse corrisponde al nome del servizio sul sistema. Cercare errori ripetuti di caricamento o conversione dei documenti, riavvii dei processi worker e messaggi in prossimità dell'aumento dell'utilizzo della CPU. Se la distribuzione scrive su un file anziché sul journal di sistema, utilizzare la destinazione di log configurata. Per i container, esaminare i log del container Collabora con il comando di log del runtime. La posizione e i messaggi disponibili variano a seconda del metodo di installazione e della versione.

Un errore ripetuto legato a un singolo file suggerisce di isolare una copia di quel file e verificare se lo stesso schema si ripresenta. Un aumento generalizzato su molti documenti suggerisce invece un problema di concorrenza o di capacità del server. Aggiorna Collabora tramite il canale supportato per la tua installazione se i log indicano un difetto noto; verifica le note di rilascio per la tua edizione e versione anziché applicare una soluzione alternativa non correlata.

Modificare la concorrenza solo quando le prove lo supportano

Lo schema di configurazione di Collabora definisce per_document.max_concurrencyil numero massimo di thread utilizzati durante l'elaborazione di un documento. L'attuale modello di configurazione ufficiale di coolwsd documenta anche i controlli di pulizia per i documenti che rimangono inattivi e superano le soglie di risorse configurate. I valori predefiniti esatti e i campi disponibili possono variare a seconda della versione, quindi è consigliabile esaminare la coolwsd.xmlconfigurazione predefinita o quella precedente fornita con la versione installata prima di apportare modifiche.

Ridurre il valore max_concurrencypuò limitare l'utilizzo della CPU da parte di un singolo documento, ma può rallentare le operazioni di modifica, caricamento o conversione. Non rappresenta un limite al numero di utenti o documenti. Modificalo solo dopo aver correlato il carico con il lavoro per documento, effettua una modifica alla volta e confronta i tempi di risposta e l'utilizzo della CPU in condizioni di carico di lavoro rappresentative. Non incollare direttamente un frammento di codice da un'altra versione nell'ambiente di produzione senza averne prima verificato la struttura e le impostazioni supportate.

La configurazione di pulizia ha lo scopo di identificare i documenti che consumano risorse e che sono rimasti inattivi per un periodo di tempo configurato e, se le condizioni rimangono soddisfatte, di terminare il processo del documento associato. Non si tratta di un limitatore generale della CPU e non risolve il problema dell'utilizzo della CPU dovuto a modifiche attive o conversioni ripetute. Verificate l'attivazione e le soglie di questa funzionalità rispetto alla configurazione installata; una policy troppo restrittiva potrebbe chiudere una sessione ancora necessaria agli utenti. Eseguite un backup della configurazione e pianificate un riavvio controllato del servizio se la modifica lo richiede.

Confronta lo stato del servizio con i messaggi di log recenti per verificare se l'aumento dell'utilizzo della CPU coincide con errori o riavvii dei processi worker.

Prima di modificare le soglie di concorrenza o di pulizia, verifica lo schema della versione installata.

Verificare la modifica in modo sicuro

• Acquisisci i valori di CPU e memoria prima di modificare la configurazione.
• Verificare se il caricamento appartiene a coolwsd/loolwsd stesso o a un documento worker.
• Utilizza la Console di amministrazione e i log per identificare i documenti attivi e correlare l'orario del picco.
• Dopo una singola modifica controllata, ripetere lo stesso carico di lavoro e confrontare l'utilizzo della CPU, il tempo di apertura del documento, la reattività della modifica e il comportamento dei lavoratori.
• Prima di considerare il problema risolto, verifica che gli utenti attivi possano ancora modificare e salvare le modifiche.

Se l'utilizzo della CPU rimane elevato anche in assenza di documenti attivi, persiste dopo un riavvio controllato o coincide con arresti anomali ripetuti, raccogliere la versione di Collabora, il metodo di installazione, i log del servizio/container, l'albero dei processi e i dettagli dei documenti (opportunamente anonimizzati) per il responsabile della manutenzione o il fornitore. Evitare di terminare ripetutamente i processi figlio: Collabora gestisce questi processi di lavoro e la terminazione manuale può interrompere l'attività degli utenti senza risolvere la causa sottostante.