Collaboraのcoolwsdまたはloolwsdを使用してCPU使用率が高い場合の診断を行う

coolwsd古いプロセスによるCPU使用率の高さはloolwsd、必ずしも障害を意味するわけではありません。Collaboraはドキュメント処理ワーカーを作成し、複雑なファイルのオープンや編集にはCPUが消費されることがあります。まず、どのプロセスがCPUを消費しているかを特定し、次に管理コンソールで開いているドキュメントやユーザーと関連付けてください。1つのドキュメントがアイドル状態のワーカーを占有している場合は、再起動する前にログを確認し、設定をクリーンアップしてください。ワーカーを終了すると、アクティブな編集が中断される可能性があります。

サービス名を認識し、負荷を測定する

新しいインストールでは というcoolwsd名前が使用されますが、古いインストールでは が表示される場合がありますloolwsd。 Collabora の21.11 アップグレードノートで/etc/loolwsd/loolwsd.xmlは、 からへの の 1 回限りの移行について説明しています/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 では、 でコンテナの合計を確認してくださいdocker stats --no-stream CONTAINER_NAME。Kubernetes では、関連するポッド リソース メトリックを使用してください。これらの測定値は異なる範囲を記述しているため、ホスト、コンテナ、ワーカーの値を注意深く比較してください。

急増の原因となっている文書またはワークロードを特定する

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変更を加える前に、インストールされているバージョンに同梱されている設定または従来の設定を確認してください。

値を下げると、max_concurrency単一ドキュメントで使用される CPU の制限はできますが、編集、読み込み、変換が遅くなる可能性があります。これは、ユーザー数やドキュメント数の上限ではありません。負荷とドキュメントごとの作業量を関連付けた後でのみ変更し、一度に 1 つの調整を行い、代表的なワークロードの下で応答時間と CPU を比較してください。構造とサポートされている設定を検証せずに、別のバージョンのスニペットを本番環境に直接貼り付けないでください。

クリーンアップ設定は、設定された期間アイドル状態が続いているリソースを大量に消費するドキュメントを特定し、その条件が満たされ続ける場合は、関連するドキュメントプロセスを終了させることを目的としています。これは一般的なCPU制限機能ではなく、アクティブな編集や繰り返し行われる変換によるCPU使用率の問題を解決するものではありません。インストール済みの設定と照らし合わせて、有効化としきい値を確認してください。厳しすぎるポリシーを設定すると、ユーザーがまだ必要としているセッションが閉じられてしまう可能性があります。変更によって再起動が必要な場合は、設定をバックアップし、制御されたサービス再起動を計画してください。

サービスの状態を最近のログメッセージと比較し、CPU使用率の上昇がエラーやワーカーの再起動と一致するかどうかを確認してください。

同時実行数やクリーンアップのしきい値を変更する前に、インストールされているバージョンのスキーマを確認してください。

変更内容を安全に検証する

• 設定を変更する前に、CPUとメモリの測定値を取得してください。
• 負荷がcoolwsd/loolwsd自体によるものか、ドキュメントワーカーによるものかを確認してください。
• 管理コンソールとログを使用して、アクティブなドキュメントを特定し、急増した時間帯を関連付けます。
• 一度制御された変更を加えた後、同じワークロードを繰り返し、CPU使用率、ドキュメントを開く時間、編集の応答性、および作業者の動作を比較します。
• 問題が解決したと判断する前に、アクティブユーザーが引き続き編集および保存できることを確認してください。

アクティブなドキュメントがないにもかかわらずCPU使用率が高い状態が続く場合、制御された再起動後もその状態が続く場合、または繰り返しクラッシュが発生する場合は、Collaboraのバージョン、インストール方法、サービス/コンテナのログ、プロセスツリー、および個人情報が削除されたドキュメントの詳細を収集し、保守担当者またはベンダーに提供してください。子プロセスを繰り返し強制終了することは避けてください。Collaboraはこれらのワーカーを管理しており、手動で終了すると、根本的な原因を解決せずにユーザーに支障をきたす可能性があります。