Diagnosticar alto uso da CPU usando o coolwsd ou loolwsd da Collabora.

O alto uso da CPU por coolwsdum processo antigo ou secundário loolwsdnão é necessariamente uma falha: o Collabora cria processos de processamento de documentos, e abrir ou editar arquivos complexos pode consumir CPU. Primeiro, identifique qual processo está consumindo CPU e, em seguida, correlacione-o com os documentos abertos e os usuários no Console de Administração. Se um documento mantiver um processo ocupado enquanto ocioso, verifique os registros e as configurações de limpeza antes de reiniciar qualquer processo; encerrar processos pode interromper a edição em andamento.

Reconheça o nome do serviço e meça a carga.

Instalações mais recentes usam o coolwsdnome; instalações mais antigas ainda podem exibir . As notas de atualizaçãoloolwsd da Collabora para a versão 21.11 descrevem a migração única de para . Certifique-se de que os nomes de serviço e configuração instalados em seu host correspondam aos originais, em vez de presumir que todas as implantações sejam idênticas./etc/loolwsd/loolwsd.xml/etc/coolwsd/coolwsd.xml

Em um host systemd, verifique o serviço e, em seguida, liste os processos por uso de CPU:

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

Se o serviço se chamar `<nome_do_serviço>` loolwsd, substitua esse nome no comando `systemctl`. Analise várias leituras ao longo do tempo com `systemctl status`, topem vez de tratar um pico isolado como um problema persistente. Inspecione a árvore de processos: a CPU pode estar sendo usada por processos de trabalho de documentação abaixo do daemon, e não pelo próprio processo pai. No Docker, verifique o total de contêineres com `systemctl docker stats --no-stream CONTAINER_NAMEstatus`; no Kubernetes, use as métricas de recursos relevantes do pod. Essas leituras descrevem escopos diferentes, portanto, compare os valores do host, do contêiner e do processo de trabalho com atenção.

Identifique o documento ou a carga de trabalho responsável pelo pico.

Faça login no Console de Administração do Collabora e revise os usuários conectados, os documentos abertos, o uso de recursos e os gráficos recentes. As perguntas frequentes oficiais do Collabora descrevem esses recursos de monitoramento. Se a carga aumentar enquanto uma planilha, apresentação, PDF ou documento grande estiver aberto ou convertido, observe se ela diminui após a conclusão dessa atividade. Um pico temporário associado a uma carga de trabalho real exige planejamento de capacidade ou uma carga de trabalho menor; por si só, não comprova um processo descontrolado.

Se um documento continuar consumindo muita CPU mesmo depois de ser fechado pelos usuários, verifique se nenhuma sessão do navegador ou integração ainda o mantém aberto. Registre o identificador do documento exibido no console, o ID do processo, a duração, o uso de memória e se o arquivo estava ativo ou ocioso. Evite incluir nomes de documentos pessoais ou confidenciais em solicitações de suporte público.

Compare o daemon com seus processos filhos; o processo mais ocupado pode não ser o processo pai coolwsd.

Antes de alterar as configurações do servidor, correlacione o histórico de CPU com os usuários ativos e os documentos.

Use os registros para distinguir um pico de atividade de um processo travado.

Para uma instalação do systemd baseada em pacotes, verifique as mensagens de serviço recentes:

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

Use loolwsdesse nome se for o nome do serviço no seu sistema. Procure por erros repetidos de carregamento ou conversão de documentos, reinicializações de workers e mensagens próximas ao momento em que o uso da CPU aumenta. Se a sua implantação grava em um arquivo em vez do journal do sistema, use o destino de log configurado. Para contêineres, inspecione os logs do contêiner do Collabora com o comando de log do seu ambiente de execução. O local relevante e as mensagens disponíveis variam de acordo com o método de instalação e a versão.

Um erro recorrente associado a um único arquivo sugere isolar uma cópia desse arquivo e testar se o mesmo padrão se repete. Um aumento generalizado em vários documentos sugere problemas de concorrência ou capacidade do servidor. Atualize o Collabora pelo canal de suporte da sua instalação se os registros apontarem para um defeito conhecido; verifique as notas de versão da sua edição em vez de aplicar uma solução alternativa não relacionada.

Ajuste a simultaneidade somente quando houver evidências que a justifiquem.

O esquema de configuração do Collabora define per_document.max_concurrencyo número máximo de threads usadas durante o processamento de um documento. O modelo de configuração oficial atual do coolwsd também documenta verificações de limpeza para documentos que permanecem ociosos e excedem os limites de recursos configurados. Os valores padrão exatos e os campos disponíveis podem variar de acordo com a versão, portanto, verifique a coolwsd.xmlconfiguração padrão ou legada fornecida com a sua versão instalada antes de fazer alterações.

Reduzir esse max_concurrencylimite pode limitar o uso da CPU por um único documento, mas pode tornar a edição, o carregamento ou a conversão mais lentos. Não se trata de um limite para o número de usuários ou documentos. Altere esse limite somente após correlacionar a carga com o trabalho realizado em cada documento, faça um ajuste por vez e compare o tempo de resposta e o uso da CPU sob uma carga de trabalho representativa. Não copie e cole um trecho de outra versão diretamente em produção sem validar sua estrutura e as configurações suportadas.

A configuração de limpeza destina-se a identificar documentos que consomem muitos recursos e que permaneceram ociosos por um período configurado e, quando as condições forem atendidas, encerrar o processo do documento associado. Não se trata de um limitador geral de CPU e não resolve o uso de CPU causado por edição ativa ou conversões repetidas. Verifique se a ativação e os limites estão de acordo com a sua configuração instalada; uma política agressiva pode encerrar uma sessão que os usuários ainda precisam. Faça backup da configuração e planeje uma reinicialização controlada do serviço caso a alteração exija isso.

Compare o status do serviço com as mensagens de log recentes para verificar se o aumento do uso da CPU coincide com erros ou reinicializações de processos.

Verifique o esquema da versão instalada antes de alterar os limites de simultaneidade ou de limpeza.

Verifique a alteração com segurança.

• Capture as leituras de CPU e memória antes de alterar a configuração.
• Confirme se a carga pertence ao próprio coolwsd/loolwsd ou a um processo de trabalho de documentos.
• Utilize o Console de Administração e os registros para identificar documentos ativos e correlacionar o horário do pico.
• Após uma única alteração controlada, repita a mesma carga de trabalho e compare o uso da CPU, o tempo de abertura do documento, a capacidade de resposta à edição e o comportamento do processo.
• Confirme se os usuários ativos ainda conseguem editar e salvar antes de considerar o problema resolvido.

Se o uso da CPU permanecer alto mesmo sem documentos ativos, persistir após uma reinicialização controlada ou coincidir com travamentos repetidos, colete a versão do Collabora, o método de instalação, os logs de serviço/container, a árvore de processos e os detalhes anonimizados dos documentos para o responsável pela manutenção ou o fornecedor. Evite encerrar repetidamente os processos filhos: o Collabora gerencia esses processos e o encerramento manual pode interromper o funcionamento do usuário sem corrigir a causa raiz.