Jira Data Center でクラスター キャッシュ レプリケーションのヘルス チェックに失敗する

お困りですか?

アトラシアン コミュニティをご利用ください。

コミュニティに質問

プラットフォームについて: Data Center のみ - この記事は、Data Center プラットフォームのアトラシアン製品にのみ適用されます。

この KB は Data Center バージョンの製品用に作成されています。Data Center 固有ではない機能の Data Center KB は、製品のサーバー バージョンでも動作する可能性はありますが、テストは行われていません。サーバー*製品のサポートは 2024 年 2 月 15 日に終了しました。サーバー製品を利用している場合は、アトラシアンのサーバー製品のサポート終了のお知らせページにて移行オプションをご確認ください。

*Fisheye および Crucible は除く

概要

Jira Data Center のクラスター レプリケーションは、データベースに記録されているノードと、更新の送受信を行っているノードに依存します。ヘルス チェックでは、レプリケーションがクラスター全体で動作していることを確認します。1 つのアクティブ ノードが応答しない場合、他のノードが警告を送信することになり、エラーが発生しているノードではクリティカルな結果が記録されます。


結果の確認

アイコン結果意味
ヘルス チェックは正常に完了しました。クラスター内のノード レプリケーションが動作しています。
ノード <node> がデータベース内にありません

ノードがデータベース内に存在しないがレプリケーション キャッシュ内には存在するか、ノードが応答していません。

ノード <node> がレプリケーションを実行していませんノードで情報がクラスターに複製されていません。データベースに存在するがレプリケーション キャッシュに存在しません。

クラスターを横断する不一致

Jira は一部のデータをノードにローカルなメモリに保存します。特に権限などのよく使われるデータがこれに該当します。キャッシュ同期は非同期ですが (7.9 以降)、ノードを横断して素早く一貫して実行されるのが期待されます。これはネットワークを横断して通信および複製されます。

症状は次のとおりです。

  • ユーザーが一部のノードにのみ存在する。
  • ユーザーが一部のノードでのみ権限を持つ。
  • ユーザー フィールドのドロップダウンの結果が一部のノードでのみ表示される。 
  • 権限の更新後、フィルターやガジェットが 1 つのノードでのみ表示される。

トラブルシューティング

問題提案
ノードがデータベースに存在しない。

影響を受けたノードを再起動します。事前に「スレッド ダンプの生成」に従ってスレッド ダンプを生成しておくことをおすすめします。これらを次のデータとともにサポートに送信できます。

ネットワーク状態の影響により、ノードが複製されない。
  • 各サーバーは自身のホスト名を正確に解決できる必要があります。cluster.properties の ehcache.listener.hostName  パラメーターについて、インストール ガイドの手順を利用してホスト名の値を指定します。
  • ファイアウォールまたはネットワーク状況によってノード間のコミュニケーションがブロックされている可能性があります。各ノードのログで、ネットワーク接続に関連する例外が記録されているかどうかを確認します。
  • Jira Data Center は、ノード間の通信に TCP マルチキャストを利用するように構成できます。cluster.properties ファイルの構成を確認し、インストール ガイドで詳細をご確認ください。
  • マルチキャストを利用している場合に現在利用中のマルチキャスト アドレスを確認するには、各ノードで次のコマンドを実行します。 
    • Linux: netstat -g
    • WINDOWS: netsh interface ip show joins
  • Jira Data Center のノード間でファイアウォールを利用する運用は想定されていません。

これらの構成オプションを文書化するリクエストが起票されています。

ノードがオフラインなために複製されない。他の各ノードのステータスを確認します (特にオンラインで応答している場合)。

ログ ファイルに書き込まれた統計のレビューを行うことで、キャッシュ レプリケーションを監視できます。ログ ファイルでは、ローカル キューのサイズ、キャッシュ変更が正常にレプリケートされたかどうか、またはキュー内に長時間残っているかどうかなどを確認できます。ほとんどの場合、いくつかのパラメーターを監視するだけで、レプリケーションが正常に動作しているかどうかがわかります。詳細については、「キャッシュ レプリケーションの監視」をご確認ください。

サポートに情報を提供する

トラブルシューティングやご自身での問題の解決が難しい場合、support.atlassian.com でサポート チケットを作成し、次の情報を含めてください。

  • ヘルス チェック結果のスクリーンショット
  • 各 Data Center ノードからのサポート zip
  • このドキュメントでの提案事項を受けて収集した任意の情報


説明 Jira Data Center のクラスター レプリケーションは、データベースに記録されているノードと、更新の送受信を行っているノードに依存します。ヘルス チェックでは、レプリケーションがクラスター全体で動作していることを確認します。1 つのアクティブ ノードが応答しない場合、他のノードが警告を送信することになり、エラーが発生しているノードではクリティカルな結果が記録されます。
最終更新日 2022 年 5 月 10 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.