共同編集のトラブルシューティング
共同編集は、リアルタイムでデータを同期する Synchrony によって動作しています。通常の状態では、管理者によって手動で管理する必要はありません。
このページは、お客様のインスタンスにおける Synchrony での問題のトラブルシューティングに役立ちます。
共同編集に関する問題のトラブルシューティング
最初のステップ
Synchrony が実行中かどうかを確認する
To check if Synchrony is running, go to Administration menu 
, then General Configuration > Collaborative editing .
注: Confluence Data Center を実行中の場合は、このページで、現在の Confluence ノードがお使いの Synchrony クラスタに接続されているかどうかがわかります。Synchrony クラスタの監視をサポートするためにサードパーティ製監視ツールを使用することもできます。詳細は「Confluence Data Center での Synchrony の状況の確認方法」を参照してください。
ページを編集できることを確認する
ページの編集中にエラーが表示されるけれど Synchrony が実行中である場合、何らかの原因でブラウザーを Synchrony に接続できない可能性があります。
最も一般的な問題は、リバース プロキシの設定ミスです。このページで後述されているプロキシのトラブルシューティングのヒントを参照するか、「共同編集の管理」へ移動して、使用可能なプロキシと SSL の構成についての詳細をご覧ください。
ログの確認
Confluence のアプリケーション ログは <home-directory>/logs/atlassian-confluence.log に、Synchrony 固有のログは <home-directory>/logs/atlassian-synchrony.log にあります。
Synchrony の再起動
If Synchrony is managed by Confluence, go to Administration menu , then General Configuration > Collaborative editing and choose Restart Synchrony.
スタンドアロンの Synchrony クラスタを実行する場合、各ノードで Synchrony を手動で再起動します。
ポート 8091 が利用可能か確認する
Synchrony は、既定でポート 8091 で実行されます。このポートがサーバー上の別のアプリケーションによってすでに使用されている場合は、synchrony.port システム プロパティを使用して、利用可能なポートを変更します。
(Confluence 6.0.3 以前を使用している場合、synchrony.port の代わりに reza.port を使用する必要があります)
これの変更方法の詳細は、「システム プロパティの設定」を参照してください。
Confluence Data Center の場合、Synchrony の実行方法は異なります。詳しくは「Synchrony を設定する」を参照してください。
リバース プロキシの問題
リバース プロキシを既に設定しているにも関わらず、ページが編集できない場合は、設定で以下を確認してください:
installation-directory>/conf/server.xmlに移動し、Connectorディレクティブを確認します。<protocol>および<proxyName>の値が正しいことを確認します。詳細については、以下のガイドの例を参照してください。- SSL を設定していたり AJP コネクタを使用していたりする場合も、
httpコネクタは常に<installation-directory>/conf/server.xmlファイル内に存在する必要があります。Synchrony ヘルス チェックは HTTP を使用し、このコネクタが存在しない場合は失敗します。http コネクタを含めたくない場合は、synchrony.proxy.healthcheck.disabledシステム プロパティを使用してヘルス チェックを無効化することができます。 - Apache を使用している場合、Apache 2.4 (WebSockets 対応) を使用しており、すべての必要なモジュールが有効化されている (
mod-proxy、mod_rewrite、proxy_wstunnel) ことを確認します。 - Apache を使用していて Synchrony に直接接続したい場合は、プロキシ構成ファイルで、
/synchronyが含まれており、Confluence および Synchrony ディレクティブと location ブロックの順序が適切であることを確認します。詳細については、上記のガイドの例を参照してください。
共同編集の管理を参照し、使用可能なプロキシや SSL 構成についての詳細を確認します。その後、Synchrony に直接接続する場合は、次のガイドで、お使いのリバース プロキシ設定に Synchrony を含める方法の詳細を確認してください。
- Apache で mod_proxy を使用する
- SSL を使用して NGINX のバックグラウンドで Confluence を実行する
- Apache HTTP Server (mod_proxy_http) でアトラシアンのサーバー アプリケーションをプロキシする
- Microsoft Internet Information Services (IIS) を使用したアトラシアン サーバー アプリケーションのプロキシ
- Confluence で Amazon Web Service Application Load Balancer を構成する方法
フォワード プロキシの問題
フォワード またはアウトバウンド プロキシを使用している場合は、Synchrony がリスンする IP を config に追加し、バイパスされるようにする必要があります。詳細は、「Confluence 用に Web プロキシサポートを設定する」を参照してください。
既定では、IP は 127.0.0.1 または synchrony.host システム プロパティの値になります (Confluence が Synchrony への接続に使用するホスト名または IP をカスタマイズした場合)。
Websocket の問題
共同編集は、 Websocket 接続で最適に動作します。 タイムアウトや、Websocket 接続を許可しないプロキシ サーバーまたはファイアウォールによって接続が確立できない場合、エディタは XML HTTP リクエスト (XHR) 経由での接続を試みます。
また、http://websocket.org/echo.html を使用して、エコー サーバーに対する簡易的な HTML 5 WebSocket テストを実行することもできます。
ブラウザーの開発ツールを使用すると、Websocket 接続を検証できます。次の例では、Chrome を使って Websocket 接続を確認します。
- Chrome 開発ツール (Shift + CTRL + J) を開きます
- [ネットワーク] タブを選択します。
- [WS] フィルターを選択し、WebSocket のトラフィックのみを表示します
- Confluence ページを編集します
- 次の Websocket 接続を選択します:
ws://<confluence-url>/synchrony-proxy/v1/bayeux-sync1 - [Frames/Messages (フレーム / メッセージ)] タブを選択して、ブラウザーと WebSocket の間のトラフィックを確認します。
SSL の課題
Synchrony では、ダイレクト HTTPS 接続を使用できません。そのため、リバース プロキシまたはロード バランサ (リバース プロキシを使用していない場合は Tomcat) で SSL を終了する必要があります。
メモリの問題
Synchrony に関連してメモリ不足エラーが発生した場合は、synchrony.memory.max システム プロパティを使用して、Synchrony に割り当てられているヒープ サイズを変更できます。
Confluence 6.0.3 以前を使用している場合は、synchrony.memory.max の代わりに reza.memory.max を使用する必要があります。
これの変更方法の詳細は、「システム プロパティの設定」を参照してください。
Confluence Data Center の場合、Synchrony の実行方法は異なります。詳しくは「Synchrony を設定する」を参照してください。
複数の Synchrony プロセス
エディターに直ちにエラーが表示されないのに、Confluence reports that Synchrony が実行中であることを報告する場合は、実行中の Synchrony プロセスが 1 つのみであることを確認してください。
複数の Synchrony プロセスを実行中の場合は、Confluence を停止し、追加 Synchrony プロセスを終了してから、Confluence を再起動してください。
Confluence の終了時に Tomcat ウィンドウを使用するのではなく stop-confluence.sh / stop-confluence.bat を使用することで、この問題を回避できます。
クラスタ内での Synchrony モードの混在
Confluence をクラスタで実行している場合、すべての Confluence ノードが同じ方法で Synchrony に接続されている必要があります。
If users are able to use collaborative editing on one Confluence node, but not on another Confluence node, go to Administration menu , then General Configuration > Clustering, then on each node choose Collaborative editing.
すべての Confluence ノードで同じ Synchrony モード (Confluence での管理、またはスタンドアロンの Synchrony クラスタ) が報告されていることを確認します。
この方法ですべてのノードにアクセスできます。ブラウザで特定のノードをクリックする必要はありません。
互換性がないブラウザ拡張機能
エディターと相互作用する一部のサードパーティ製ブラウザー拡張子 (Grammarly など) は、共同編集が正常に機能しない場合があります。Confluence サイトでのみ Grammarly を無効にする方法については「(アーカイブ済み) Confluence 共同編集により Grammarly 拡張子がブロックされる」をご参照ください。
ファイアウォールまたはウイルス対策の干渉
ファイアウォールまたはウイルス対策ソフトウェアによって、サーバーへの一部のリクエストがブロックされ、エディターで予期せぬ動作が発生するという報告をいくつか受けています。問題が発生した場合は、Confluence をホワイトリスト/信頼済み URL に追加する必要が出る場合があります。詳細は、Kaspersky インターネット セキュリティでの異常なページまたはエディターの動作を参照してください。
エディタを使用中のユーザーが多すぎる
最大 12 人のユーザーが同時にページを編集することができます。つまり、すでに 12 人のユーザーがページを編集している場合、新しいユーザーはエディタを開くことができず、それらのユーザーがエディタを離れるまで待つ必要があります。
管理者は confluence.collab.edit.user.limit システム プロパティを使用して、上限値を増減できます。
コンテンツの問題をトラブルシューティングするためのフィードバック レポートの作成
データの重複などの問題が発生した場合は、アトラシアンのサポート チームから、問題のトラブルシューティングに役立つフィードバック レポートの作成を依頼されることがあります。
誰かがフィードバック レポートを作成すると、履歴、ページ イベント、編集者の Synchrony データ (過去 72 時間分) など、そのページやブログ投稿に加えられたすべての変更が収集されます。これは、そのページのライフサイクルの完全なスナップショットを作成するのに役立ちます。
注: Synchrony は、ページの編集時にエディターで行われたすべてのキー ストロークをキャプチャします。たとえば、"The best ice cream is Vanilla" と入力したあと、バックスペースを押して "Chocolate" に変更したとします。この場合は "Vanilla" と "Chocolate" の両方が Synchrony のデータに含まれます。
また、問題を報告したユーザーは、自分の言葉で問題を説明するように求められます。
このデータは zip ファイルとしてエクスポートされ、次のディレクトリに保存されます。
Confluence をクラスタで実行している場合:
<shared-home>/collab-data/クラスタ化されていない Confluence を使用している場合:
<local-home>/shared-home/collab-data/
収集されたデータにはユーザーが作成したコンテンツが含まれているため、生成されたレポートは 5 日間しか保存されません。その後、予定されていた共同編集フィードバック レポートのクリーンアップによって自動的に削除されます。一度に最大 200 件のレポートが保管されます。システム プロパティでこの件数を変更できます。「認識対象のシステム プロパティ」をご参照ください。
ユーザーによる問題の自己報告を許可する
初期設定では、システム管理者権限または Confluence 管理者グローバル権限を持つユーザーのみが、管理インターフェイスから問題を報告するフィードバック レポートを作成できます。[ページを追加] スペース権限を持つすべてのユーザーに対して、レポートの作成を許可することを選択できます。
ユーザーによる問題の自己報告を許可するには、次の手順に従います。
- Go to Administration menu , then General Configuration > Collaborative editing feedback.
- [フィードバック レポートを作成できるのは誰ですか] で、[Anyone with edit permissions (編集権限を持つすべてのユーザー)] というラジオ ボタンを選択します。
これによって、ページを表示または編集する際に、ヘッダーのヘルプ メニューに [編集の問題を報告] 項目が追加されます。
編集の問題を報告する
ページやブログ投稿から編集の問題を報告するには、次の手順に従います。
- 問題のあるページまたはブログ投稿に移動します。
- ヘッダーから [
ヘルプ] > [編集の問題を報告] を選択します。 - 何をしているときに問題が発生したのかなど、関連情報を入力します。
- [フィードバックを送信] を選択します。
レポートは共有ホーム ディレクトリに保存され、利用可能なレポートのリストに表示されます (システム管理者のみがアクセスできます)。
ページ ID で編集の問題を報告する
システム管理者は、ページ ID で問題のあるページのレポートを生成することもできます。これは、ユーザーによる問題の自己報告を許可したくない場合に便利です。
特定のページやブログ投稿のレポートを作成するには、次の手順に従います。
- Go to Administration menu , then General Configuration> Collaborative editing feedback.
- ページ ID またはブログ投稿 ID を
- [レポートを作成] ボタンを選択します。
レポート ファイルは、利用可能なレポートのリストに表示されます。
アトラシアン サポートにレポートを送る
このデータを分析のためにアトラシアンのサポート チームと共有することを選択した場合は、サポート チケットを通じてファイルを転送できます。
フィードバック レポートは、サポート チーム メンバーから要求された場合に限り、提供してください。このデータは、アトラシアン バグ レポートなど、公開されている場所では共有しないでください。