スレッド ダンプの生成
Confluence のパフォーマンスが低い場合や、予期せぬ動作をしたり、応答が停止する場合は、問題の原因を診断するのに役立つスレッド ダンプを生成することができます。スレッド ダンプを含めると、アトラシアン サポートが問題を調査するのに非常に役立ちます。
スレッド ダンプは、スタック トレースを含む JVM の各スレッドの現在の情報を示すため、アプリケーションで問題が発生したときに取得する必要があります。
保持されスレッドによって待たされているロックについての情報は、Confluence 内部から作成することができるスレッド ダンプには含まれません。この追加情報が必要な場合は、外部でスレッド ダンプを生成する必要があります。
On this page:
Security considerations
問題のデバッグに役立つよう、Confluence はエラーが発生すると Web インターフェイスを介してスタック トレースを提供します。これらのスタックトレースには、Confluence がエラー発生時に実行していた内容に関する情報と、ご使用のデプロイメントサーバーに関する一部の情報が含まれます。
これには、オペレーティングシステム、バージョン、Java のバージョンなどの情報が含まれます。適切なネットワークセキュリティでは、これは危険と見なされるのに十分な情報ではありません。現在のユーザーのユーザー名を含めることができます。
スレッドダンプには、デフォルトでユーザー名と URL が含まれます。この追加の診断情報を含めない場合は、スレッド診断を無効にすることができます。
Java Flight Recorder (JFR) を使用して、Confluence 内でスレッド ダンプのセットを生成する
スレッド ダンプを生成するには、次の手順に従います。
- [管理] > [一般設定] > [トラブルシューティングとサポート ツール] に移動します。
- [サポート zip を作成] を選択します。
- [ランタイム診断データを含める] が選択されていることを確認します (含めたくないその他のオプションを選択解除できます。サポート zip を作成してアトラシアン サポートに提供する場合は、できるだけ多くの情報を含めることをお勧めします)。
- [作成] を選択します。
サポート zip を作成すると、新しい .jfr バイナリ ファイルが <Confluence-Home-Directory>/log/jfr
フォルダーに作成されます。
この最新の .jfr バイナリ ファイルとそこから抽出されたスレッド ダンプが (jfr-bundle
フォルダーの下にある) サポート zip ファイルに含まれます。この抽出されたスレッド ダンプのセットは、すでに人間が読み取れる形式になっており、TDA、IBM TMDA (JCA)、Samurai などの一般的なスレッド分析ツールで解析できます。
JFR は Confluence Data Center と Server 7.20 以降に (Troubleshooting and Support Tools アプリを通じて) バンドルされており、インスタンスを起動するとすぐに継続的な診断データの記録が開始されます。
詳細については、「Java Flight Recorder によってランタイムの問題を診断する」をご確認ください。
外部スレッド ダンプの生成
Confluence が応答しなくなった、またはスレッドによって保持および待機されているロックの情報が必要な場合、「外部からスレッド ダンプを生成する」に記載されている方法のいずれかを使用します。
Confluence 内で生成された単純なスレッド ダンプに問題の診断に十分な情報が含まれていない場合、当社のサポート チームがこの方法を使用することをお願いすることがあります。
Performance Data Collector を使用したスレッド ダンプの生成
詳細は、「Performance Data Collector の使用方法」を参照してください。