Collabora의 coolwsd 또는 loolwsd를 사용하여 CPU 사용량이 높은 문제를 진단하세요.

CPU 사용량이 높 coolwsd거나 오래된 loolwsd프로세스가 문제인 것은 아닙니다. Collabora는 문서 처리 워커를 생성하며, 복잡한 파일을 열거나 편집할 때 CPU 사용량이 증가할 수 있습니다. 먼저 어떤 프로세스가 CPU를 많이 사용하는지 파악한 다음, 관리 콘솔에서 열려 있는 문서 및 사용자와 연관시켜 확인하십시오. 특정 문서가 유휴 상태임에도 불구하고 워커를 계속 사용하는 경우, 로그를 확인하고 설정을 정리한 후 다시 시작하십시오. 워커를 종료하면 활성 편집 작업이 중단될 수 있습니다.

서비스 이름을 확인하고 부하를 측정합니다.

최신 설치에서는 해당 coolwsd이름을 사용하고, 이전 설치에서는 여전히 다른 이름이 표시될 수 있습니다 loolwsd. Collabora 21.11 업그레이드 노트에는/etc/loolwsd/loolwsd.xml 에서 로의 일회성 마이그레이션에 대한 설명이 있습니다 /etc/coolwsd/coolwsd.xml. 모든 배포가 동일하다고 가정하지 말고 호스트에 설치된 서비스 및 구성 이름을 일치시키세요.

systemd 호스트에서 서비스를 확인한 다음 CPU 사용량별로 프로세스 목록을 표시합니다.

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

서비스 이름이 인 경우 loolwsd, systemctl 명령에서 해당 이름을 사용하십시오. top단기적인 급증을 지속적인 문제로 간주하기보다는 시간 경과에 따른 여러 측정값을 검토하십시오. 프로세스 트리를 검사하십시오. CPU는 부모 프로세스 자체가 아닌 데몬 아래의 문서 작업자 프로세스에서 사용될 수 있습니다. Docker에서는 `container total` 명령으로 컨테이너 총 CPU 사용량을 확인하고 docker stats --no-stream CONTAINER_NAME, Kubernetes에서는 관련 Pod 리소스 메트릭을 사용하십시오. 이러한 측정값은 서로 다른 범위를 나타내므로 호스트, 컨테이너 및 작업자 값을 신중하게 비교하십시오.

업무량 급증의 원인이 되는 문서 또는 작업량을 찾아보세요.

Collabora 관리 콘솔에 로그인하여 연결된 사용자, 열려 있는 문서, 리소스 사용량 및 최근 그래프를 확인하세요. Collabora 공식 FAQ 에서 이러한 모니터링 기능에 대해 자세히 설명합니다. 대용량 스프레드시트, 프레젠테이션, PDF 또는 문서를 열거나 변환하는 동안 부하가 증가하는 경우, 해당 작업이 완료된 후 부하가 감소하는지 확인하세요. 실제 작업 부하와 관련된 일시적인 부하 급증은 용량 조정 계획을 세우거나 작업 부하를 줄여야 함을 의미하며, 그 자체로 프로세스가 폭주하고 있음을 나타내는 것은 아닙니다.

사용자가 문서를 닫은 후에도 해당 문서가 높은 CPU 사용량을 계속 나타내는 경우, 브라우저 세션이나 통합 기능이 해당 문서를 계속 열어두고 있지 않은지 확인하십시오. 콘솔에 표시되는 문서 식별자, 프로세스 ID, 지속 시간, 메모리 사용량, 그리고 파일이 활성 상태인지 유휴 상태인지 여부를 기록해 두십시오. 공개적인 지원 요청에 개인 정보나 기밀 문서 이름을 언급하지 마십시오.

데몬과 자식 프로세스를 비교해 보세요. 가장 바쁜 작업자가 coolwsd 부모 프로세스가 아닐 수도 있습니다.

서버 설정을 변경하기 전에 CPU 사용 기록과 활성 사용자 및 문서 간의 상관관계를 분석하십시오.

로그를 사용하여 급증하는 트래픽과 정체된 작업자를 구분하세요.

패키지 기반 systemd 설치의 경우 최근 서비스 메시지를 확인하십시오.

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

시스템에서 서비스 이름이 동일한 경우 해당 이름 을 사용하십시오 loolwsd. 반복적인 문서 로드 또는 변환 오류, 워커 재시작, CPU 사용률 상승 시점 주변의 메시지를 확인하십시오. 배포 환경에서 시스템 저널 대신 파일에 로그를 기록하는 경우 구성된 로그 대상을 사용하십시오. 컨테이너의 경우 런타임의 로그 명령을 사용하여 Collabora 컨테이너 로그를 검사하십시오. 관련 위치와 사용 가능한 메시지는 설치 방법 및 버전에 따라 다릅니다.

특정 파일과 관련된 반복적인 오류가 발생하는 경우, 해당 파일의 복사본을 만들어 동일한 패턴이 다시 발생하는지 테스트해 보세요. 여러 문서에서 오류가 광범위하게 증가하는 경우에는 동시 접속 문제 또는 서버 용량 문제일 가능성이 높습니다. 로그에 알려진 결함이 지적되는 경우, 해당 설치 환경에 맞는 공식 업데이트 채널을 통해 Collabora를 업데이트하세요. 관련 없는 해결 방법을 적용하기보다는 사용 중인 에디션 및 버전의 릴리스 노트를 확인하십시오.

증거가 뒷받침될 때만 동시 실행 비율을 조정하십시오.

Collabora의 구성 스키마는 per_document.max_concurrency문서 처리 시 사용되는 최대 스레드 수를 정의합니다. 현재 공식 coolwsd 구성 템플릿에는 유휴 상태로 남아 있거나 구성된 리소스 임계값을 초과하는 문서를 정리하는 검사 기능도 포함되어 있습니다. 정확한 기본값 및 사용 가능한 필드는 릴리스에 따라 다를 수 있으므로 coolwsd.xml변경하기 전에 설치된 버전에 포함된 구성 파일이나 기존 구성 파일을 확인하십시오.

CPU 사용량 을 줄이면 max_concurrency단일 문서의 CPU 사용량을 제한할 수 있지만 편집, 로드 또는 변환 속도가 느려질 수 있습니다. 이는 사용자 수나 문서 수에 대한 제한이 아닙니다. 문서별 작업량과 부하를 연관시켜 확인한 후, 한 번에 하나씩만 조정하고 대표적인 작업 부하에서 응답 시간과 CPU 사용량을 비교하십시오. 다른 버전의 코드 조각을 구조 및 지원되는 설정을 검증하지 않고 프로덕션 환경에 직접 붙여넣지 마십시오.

정리 구성은 설정된 기간 동안 유휴 상태인 리소스 소모가 심한 문서를 식별하고, 해당 조건이 계속 충족될 경우 관련 문서 프로세스를 종료하도록 설계되었습니다. 이는 일반적인 CPU 사용량 제한 기능이 아니며, 활성 편집이나 반복적인 변환으로 인한 CPU 사용량 문제를 해결하지는 않습니다. 설치된 구성에 맞춰 이 기능의 활성화 및 임계값을 검토하십시오. 너무 강력한 정책을 적용하면 사용자가 여전히 필요로 하는 세션이 종료될 수 있습니다. 변경 사항으로 인해 서비스가 재시작되어야 하는 경우 구성을 백업하고 안전한 재시작 계획을 세우십시오.

서비스 상태를 최근 로그 메시지와 비교하여 CPU 사용량 증가가 오류 또는 작업자 재시작과 일치하는지 확인하십시오.

동시 실행 또는 정리 임계값을 변경하기 전에 설치된 버전의 스키마를 확인하십시오.

변경 사항을 안전하게 확인하세요

• 설정을 변경하기 전에 CPU 및 메모리 사용량을 기록하십시오.
• 해당 부하가 coolwsd/loolwsd 자체에 속하는지 아니면 문서 작업자에 속하는지 확인하십시오.
• 관리 콘솔과 로그를 사용하여 활성 문서를 식별하고 사용량 급증 시점을 연관시켜 분석하십시오.
• 한 번의 제어된 변경 후 동일한 작업 부하를 반복하고 CPU 사용량, 문서 열기 시간, 편집 응답성 및 작업자 행동을 비교합니다.
• 문제가 해결된 것으로 간주하기 전에 활성 사용자가 여전히 편집 및 저장을 할 수 있는지 확인하십시오.

활성화된 문서가 없는데도 CPU 사용률이 높게 유지되거나, 재시작 후에도 문제가 지속되거나, 반복적인 시스템 충돌이 발생하는 경우, 관리자 또는 공급업체에 Collabora 버전, 설치 방법, 서비스/컨테이너 로그, 프로세스 트리 및 개인 정보가 삭제된 문서 정보를 수집하여 제공하십시오. 자식 프로세스를 반복적으로 종료하지 마십시오. Collabora는 이러한 워커 프로세스를 관리하며, 수동으로 종료하면 근본적인 원인을 해결하지 못하고 사용자에게 불편을 초래할 수 있습니다.