Diagnóstico de alto consumo de CPU desde coolwsd o loolwsd de Collabora.

Un alto consumo de CPU, ya sea por un proceso coolwsdantiguo o por otro, loolwsdno implica automáticamente un fallo: Collabora crea procesos de procesamiento de documentos, y abrir o editar archivos complejos puede consumir CPU. Primero, identifique qué proceso está consumiendo CPU y, a continuación, compárelo con los documentos abiertos y los usuarios en la consola de administración. Si un documento mantiene un proceso ocupado mientras está inactivo, revise los registros y la configuración de limpieza antes de reiniciar cualquier cosa; finalizar procesos puede interrumpir la edición activa.

Reconocer el nombre del servicio y medir la carga.

Las instalaciones más recientes usan el coolwsdnombre; las instalaciones más antiguas aún pueden mostrar loolwsd. Las notas de actualización de Collabora 21.11 describen la migración única de /etc/loolwsd/loolwsd.xmla /etc/coolwsd/coolwsd.xml. Haga coincidir los nombres de servicio y configuración instalados en su host en lugar de asumir que cada implementación es idéntica.

En un host systemd, compruebe el servicio y, a continuación, enumere los procesos según su uso de CPU:

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

Si el servicio se llama loolwsd, sustitúyalo en el comando systemctl. Revise varias lecturas a lo largo del tiempo con topen lugar de tratar un pico corto como un problema persistente. Inspeccione el árbol de procesos: la CPU puede ser utilizada por los procesos de trabajo de documentos debajo del demonio, no por el proceso padre en sí. En Docker, verifique el total del contenedor con docker stats --no-stream CONTAINER_NAME; en Kubernetes, use las métricas de recursos de pod relevantes. Estas lecturas describen diferentes ámbitos, así que compare cuidadosamente los valores del host, el contenedor y el trabajador.

Encuentre el documento o la carga de trabajo que causó el pico

Inicie sesión en la consola de administración de Collabora y revise los usuarios conectados, los documentos abiertos, el uso de recursos y los gráficos recientes. Las preguntas frecuentes oficiales de Collabora describen estas funciones de monitorización. Si la carga aumenta al abrir o convertir una hoja de cálculo, presentación, PDF o documento de gran tamaño, observe si disminuye una vez finalizada dicha actividad. Un pico temporal vinculado a una carga de trabajo real requiere planificación de capacidad o una menor carga de trabajo; por sí solo, no demuestra un proceso descontrolado.

Si un documento sigue consumiendo mucha CPU después de que los usuarios lo cierren, verifique que ninguna sesión del navegador o integración lo mantenga abierto. Registre el identificador del documento que aparece en la consola, el ID del proceso, la duración, la memoria y si el archivo estaba activo o inactivo. Evite incluir nombres de documentos personales o confidenciales en las solicitudes de soporte público.

Compara el demonio con sus procesos hijos; el trabajador más ocupado puede no ser el padre coolwsd.

Antes de cambiar la configuración del servidor, correlacione el historial de uso de la CPU con los usuarios activos y los documentos.

Utilice los registros para distinguir un pico de un trabajador atascado.

Para una instalación de systemd basada en paquetes, inspeccione los mensajes de servicio recientes:

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

Utilice loolwsdeste nombre de servicio en su sistema. Busque errores repetidos de carga o conversión de documentos, reinicios de procesos y mensajes que aparezcan cuando aumente el uso de la CPU. Si su implementación escribe en un archivo en lugar del registro del sistema, utilice el destino de registro configurado. Para contenedores, inspeccione los registros del contenedor de Collabora con el comando `log` de su entorno de ejecución. La ubicación relevante y los mensajes disponibles varían según el método de instalación y la versión.

Un error recurrente vinculado a un solo archivo sugiere aislar una copia de dicho archivo y comprobar si se repite el mismo patrón. Un aumento generalizado en varios documentos sugiere problemas de concurrencia o de capacidad del servidor. Actualice Collabora a través del canal compatible con su instalación si los registros indican un defecto conocido; verifique las notas de la versión correspondiente a su edición y versión en lugar de aplicar una solución alternativa no relacionada.

Ajustar la concurrencia solo cuando la evidencia lo justifique.

El esquema de configuración de Collabora define per_document.max_concurrencyel número máximo de subprocesos que se utilizan al procesar un documento. La plantilla de configuración oficial actual de coolwsd también documenta las comprobaciones de limpieza para los documentos que permanecen inactivos y superan los umbrales de recursos configurados. Los valores predeterminados exactos y los campos disponibles pueden variar según la versión, por lo que conviene revisar la coolwsd.xmlconfiguración predeterminada o heredada incluida con la versión instalada antes de realizar cambios.

Reducir este valor max_concurrencypuede limitar el uso de CPU por documento, pero puede ralentizar la edición, la carga o la conversión. No supone un límite en el número de usuarios ni de documentos. Modifíquelo solo después de correlacionar la carga con el trabajo por documento, realice un ajuste a la vez y compare el tiempo de respuesta y el uso de CPU con una carga de trabajo representativa. No copie un fragmento de otra versión directamente en producción sin validar su estructura y la configuración compatible.

La configuración de limpieza tiene como objetivo identificar los documentos que consumen muchos recursos y que han permanecido inactivos durante un período configurado. Si se cumplen las condiciones, se debe finalizar el proceso del documento asociado. No se trata de un limitador general de CPU ni resuelve el problema del uso excesivo de CPU derivado de la edición activa o las conversiones repetidas. Revise su activación y umbrales en función de su configuración instalada; una política demasiado estricta podría cerrar una sesión que los usuarios aún necesiten. Realice una copia de seguridad de la configuración y planifique un reinicio controlado del servicio si el cambio lo requiere.

Compare el estado del servicio con los mensajes de registro recientes para ver si el aumento del uso de la CPU coincide con errores o reinicios de los procesos.

Verifique el esquema de la versión instalada antes de cambiar los umbrales de concurrencia o limpieza.

Verifique el cambio de forma segura.

• Registre las lecturas de CPU y memoria antes de cambiar la configuración.
• Confirme si la carga pertenece a coolwsd/loolwsd o a un proceso de trabajo de documentos.
• Utilice la consola de administración y los registros para identificar los documentos activos y correlacionar el momento en que se produjo el pico de actividad.
• Tras un único cambio controlado, repita la misma carga de trabajo y compare el uso de la CPU, el tiempo de apertura del documento, la capacidad de respuesta de la edición y el comportamiento de los trabajadores.
• Confirme que los usuarios activos aún pueden editar y guardar antes de considerar que el problema está resuelto.

Si el uso de la CPU se mantiene alto sin documentos activos, persiste tras un reinicio controlado o coincide con fallos repetidos, recopile la versión de Collabora, el método de instalación, los registros del servicio/contenedor, el árbol de procesos y los detalles de los documentos anonimizados para el responsable del mantenimiento o el proveedor. Evite finalizar repetidamente los procesos secundarios: Collabora gestiona estos procesos y su finalización manual puede interrumpir el servicio a los usuarios sin solucionar la causa subyacente.