[]
        
(Showing Draft Content)

パフォーマンス

目的

SpreadJS コラボレーションアドオンは、複数ユーザーによるリアルタイム編集のシナリオを想定して設計されており、大規模な同時実行のコラボレーションを効率的に支えつつ、スムーズなユーザー体験を維持します。

本レポートでは、標準的なテスト手法に基づき、さまざまな高同時実行シナリオにおけるコラボレーションサーバーの性能を包括的に評価し、実データを用いて製品の技術的な処理能力を示します。

免責事項

  1. 本性能テストレポートは、特定の構成におけるコラボレーションアドオンの性能をユーザーが理解することのみを目的としています。提示するデータは参考指標にすぎず、サードパーティ環境での実際の性能を示すものではありません。

  2. すべてのテストデータは、特定のテスト環境における手動操作によって収集しており、当該シナリオにおける性能特性のみを反映しています。

  3. 本レポートに記載した推奨構成は参考情報です。その適合性は、個別の業務シナリオ、技術アーキテクチャ、導入要件に基づいて評価する必要があります。

用語集

用語

定義

スナップショット

特定時点における共有データの保存済み状態です。復元や、コラボレーション中に行われた変更の比較に使用します。

ドキュメント (Doc)

共同作業において、ドキュメントは共有データモデルを表します。ユーザー間のリアルタイム変更を同期し、参加者全員の整合性を維持します。

レイテンシ指標 (pXX)

XX パーセンタイルのレイテンシです。リクエストの XX% が、この値以下のレイテンシで完了することを意味します。たとえば p99 は、リクエストの 99% がこの時間内に完了することを意味します。

ランダム遅延起動

クライアントは [0-6] 秒の範囲でランダムな遅延を付けて起動します。ユーザーが段階的に参加する現実的なシナリオを模擬します。

オペレーション (OP)

データモデルに対する最小単位の操作です。セルの編集や値の書き換えなどが該当し、参加者全員に同期する必要があります。

submitSnapshotBatchSize

サーバーがデータベースにスナップショットを書き込むまでのオペレーション(OP)数です。

スループット

1 秒あたりに処理されるオペレーション数(op/s)です。

テスト環境とサーバー構成

コンポーネント

仕様

オペレーティングシステム

Ubuntu 20.04/22.04/24.04 LTS

データベース

PostgreSQL v16.9

Node.js

v22.18.0

サーバー A

2 コア CPU、4 GB RAM

サーバー B/C/D

4 コア CPU、8 GB RAM

配置モード :

  • コラボレーションサービスとデータベースを同一マシンに配置/別マシンに分離して配置

  • 負荷分散シナリオにおける Nginx のコンシステントハッシュ法

テスト計画

ユーザー行動定義

テストでは、次のユーザー操作を模擬します。

  • 接続確立: サーバーに接続します

  • ドキュメント読み込み: 共有ドキュメントを読み込みます

  • ドキュメント編集: セルを編集してドキュメントの内容を変更します

  • 切断: 編集を終了し、サーバーから切断します

模擬ユーザー種別

ロール

説明

書き込みユーザー(Writer)

共有ドキュメント内の指定セルに特定の文字列を書き込みます

読み取りユーザー(Reader)

Writer が書き込んだ特定の文字列を読み取ります

ダミー書き込みユーザー(DummyWriter)

同時実行ユーザーを模擬するため、共有ドキュメントにランダム文字列を書き込みます

パフォーマンス指標

  • レイテンシ: 書き込みオペレーションと読み取りオペレーションの時間差(ミリ秒)

    • p50: 中央値レイテンシ(リクエストの 50% がこの時間内に完了)

    • p95: 95 パーセンタイルのレイテンシ(多くのユーザーにおける代表的な性能)

    • p99: 99 パーセンタイルのレイテンシ(最悪ケースの性能)

  • スループット: 1 秒あたりに処理されるオペレーション数(op/s)

テスト手法

  • Node.js から sharedDoc API を呼び出してユーザー行動を模擬

  • シナリオごとのテスト時間: 3 分

  • クライアント起動モード: ランダム遅延起動

既定パラメータ

パラメータ

値

操作頻度

6 秒ごとに 1 オペレーション(0.16 op/s)

シートスナップショット

空白のシート

submitSnapshotBatchSize

1

パフォーマンスしきい値

指標

良好

警告

重大

p99 レイテンシ

< 500ms

500-1000ms

> 1000ms

スループット

線形にスケール

頭打ち

低下

CPU 使用率

< 70%

70-90%

> 90%

主なパフォーマンス結果

1. 単一ドキュメントでの複数ユーザー同時実行


2 コア CPU、4 GB RAM サーバー

同時実行ユーザー数

p50 (ms)

p95 (ms)

p99 (ms)

スループット (op/s)

50

8

18

25

9

100

13

31

39

17

200

52

415

613

34

300

82

624

820

48

380

208

1045

1564

59

image

4 コア CPU、8 GB RAM サーバー

同時実行ユーザー数

p50 (ms)

p95 (ms)

p99 (ms)

スループット (op/s)

50

8

15

21

9

100

12

29

38

19

200

49

390

587

37

300

74

486

692

51

380

157

833

1248

62

image

まとめ

  • テスト条件下では、単体の 4 コア CPU、8 GB RAM サーバーで、p99 レイテンシが 700ms 未満の状態で 約 300 同時接続ユーザーを安定してサポートできます

  • テストデータでは、単一ルームのシナリオにおいて、2-Core 4GB から 4-Core 8GB への増強による性能改善は限定的であることを示しています

2. 複数ドキュメントの同時実行


構成: 4 コア CPU、8GB サーバー、コラボレーションサービスとデータベースを分離してデプロイ

ドキュメント数

p50 (ms)

p95 (ms)

p99 (ms)

スループット (op/s)

500

8

25

35

159

1000

9

36

46

318

2000

16

155

209

647

3000

21

313

416

974

3500

105

1329

1874

1090

image

まとめ

  • 単体の 4 コア CPU、8 GB RAM サーバーで 3,000 件の同時ドキュメントをサポートできます

  • 3,500 ドキュメントを超えるとレイテンシが大きく増加します

3. 負荷分散シナリオ

構成: 2 台の 4 コア CPU、8 GB RAM コラボレーションサーバー コラボレーションサーバー + 1x 4-Core 8GB データベース + 1x 4-Core 8GB Nginx

image

ルーム数

p50 (ms)

p95 (ms)

p99 (ms)

スループット (op/s)

500

8

18

24

157

1000

9

26

36

316

2000

10

35

48

644

3000

13

47

61

968

4000

16

62

84

1289

5000

31

157

208

1587

6000

107

1033

1437

1790

image

まとめ

  • 負荷分散を使用すると、コラボレーションシステムは 約 4,000~5,000 件のドキュメントを同時にサポートできます

  • スループットは 5,000 ドキュメントまでほぼ線形に増加します

4. スナップショットサイズの影響

構成: 4 コア CPU、8 GB RAM サーバー

注記: スナップショットが大きいほど、サポートできる最大同時実行ユーザー数は減少します。

スナップショット種別

最大同時実行ユーザー数

p99 レイテンシ (ms)

スループット (op/s)

空白のシート

400

372

67.6

4k セル

300

157

50.9

10k セル

225

114

38.5

まとめ

  • 空白のシート: 最大 400 同時接続ユーザーをサポート

  • 4k セル: 対応可能な同時実行ユーザー数が 25% 減少します。

  • 10k セル: 対応可能な同時実行ユーザー数が 44% 減少します。

5. submitSnapshotBatchSize の影響

構成: 4 コア CPU、8 GB RAM サーバー、10k セルのスナップショット

注記: submitSnapshotBatchSize を適切に構成すると、システムのスループットおよび同時実行容量の改善に寄与します。

バッチサイズ

最大同時実行ユーザー数

p99 レイテンシ (ms)

スループット (op/s)

1

225

114

38.5

100

300

138

51.0

まとめ

  • submitSnapshotBatchSize を 1 から 100 に増やすと:

    • 同時実行ユーザー数 +33%(225 → 300)

    • スループット +32%(38.5 → 51 op/s)

推奨サーバー構成

高同時実行シナリオにおいてコラボレーションサーバーの安定性と性能を維持するため、次のデプロイ構成を推奨します。

コンポーネント

推奨構成

コラボレーションサービス

4+ コア、8+ GB RAM のサーバーにデプロイします。メッセージ圧縮、競合解決、スナップショットキャッシュの処理に備え、高クロック CPU と十分なメモリを優先します。

データベース

高頻度の読み書きオペレーションとデータの永続化を効率的に行うため、高 I/O 性能のデバイス(例: SSD/RAID)に分離してデプロイします。コラボレーションサービスとのリソース競合を避けます。

負荷分散

コンシステントハッシュを使用した Nginx を使用し、水平スケーリング能力を高めて、エンタープライズ規模の大規模コラボレーション要件に対応します。

水平スケーリング

より高い同時実行が必要な場合は、コラボレーションサービスノードを追加して線形にスケールできます。注: スケーリングは、データベース、ネットワーク、および Node.js 環境の制約を受けます。

アーキテクチャ図

image