Jira のインデックス スナップショットの考慮事項
The information in this page relates to customizations in Jira. Consequently, Atlassian Support cannot guarantee to provide any support for the steps described on this page as customizations are not covered under Atlassian Support Offerings. Please be aware that this material is provided for your information only and that you use it at your own risk.
また、ファイルの直接変更によって行われるカスタマイズは、アップグレード プロセスには含まれない点にご注意ください。このような変更は、アップグレード後のインスタンスで手動で再適用する必要があります。
プラットフォームについて: Server および Data Center のみ。この記事は、Server および Data Center プラットフォームのアトラシアン製品にのみ適用されます。
Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.
*Fisheye および Crucible は除く
パフォーマンスについての質問は、ハードウェアと、スナップショットを並行し作成している際のサーバーの負荷の量に大きく依存します。
JIRAは、インデックスを使用して、ユーザーや Jira 内部機能が実行する検索クエリに迅速な結果を提供します。インデックスのスナップショットは、インデックスの最近の状態のコピーを提供します。フェイルオーバーの際に、オフラインのノードが迅速に復旧できるようにするためのものです。Jira 9.1 以降、スナップショットの使用は、クラスターに参加する新しいノードのインデックスを取得するのに望ましい方法でもあり、Jira の起動の一部として実行されます。
[設定] 配下のインデックスの復元ページで、インデックスの復元を有効化したとします。次のオプションの場合、スナップショット作成はどのタイミングでトリガーされますか?
a. 一時間に一度
b. 一日に一度
c. 一週間に一度
間隔を指定した 1 ~ 2 分後にトリガーされます。すべての Jira サービスがこのように動作しますが、Jira 6.4 以降では、特定の時間を含むような柔軟なスケジューリングを行えるような変更が行われています。6.4 は、すべてのサービスが適切なスケジュールをサポートし、管理者が日時を完全に指定できるように変更しました。
インデックスの復元のデフォルト設定は?
Jira 8.19 以前のバージョンでは、インデックスの復元は無効化されています。Jira 8.19 以降、インデックスの復元は既定で有効になっており、毎日午前 2 時にインデックス スナップショットを作成するように設定されています。
任意のタイミングでスナップショットを作成することはできますか?
Jira 9.7 より前には、これに対する特定のオプションはありません。
Jira 9.7 以降、任意のタイミングでのワンクリックによるインデックス スナップショットの作成が可能です。
インデックス スナップショットを手動で取得するには、次の手順に従います。
[管理] > [システム] に移動します。
左側のパネルで [インデックス化] を選択します。
[インデックス作成] ページで、[新しいインデックス スナップショットを作成する] に進み、[インデックス スナップショットを作成] を選択します。
インデックス サイズが 18 G のとき、1 つのスナップショットのサイズはどの程度になりますか?
正確な予測値を提供することは簡単ではありませんが、プロセスではインデックスの最適化されたコピーが作成されます。これは一般にはオリジナルのものよりも少し小さいものになりますが、ハードウェアやその時点でのサーバー負荷などのたくさんの要因の影響を受けます。その後、コピーが zip アーカイブに圧縮されます。圧縮率は一般に 4 または 5 から 1 程度です。このため、18 G の場合、予測値は 4 G 程度になります。実際の値は状況に応じて変わります。
インデックス サイズが 18 G の場合、インデックス スナップショットのためにどの程度の空きディスク容量が必要ですか?
スナップショットの作成時には、インデックスの最適化されたコピーが作成されるため、このサイズは最大 18 Gb になります。その後、圧縮されたコピーは zip アーカイブに圧縮されます。これを 4 Gb とします。Jira は 3 個のアーカイブを保持します。合計で 36 Gb の追加の空き容量 (インデックス サイズ x 2) が必要です。
インデックスのコピーは java.io.tmpdir ロケーションにコピーされる点にご注意ください。これは既定では -Djava.io.tmpdir="$CATALINA_TMPDIR"
に設定されており、これは、JIRA_INSTALL の一部である CATALINA_TMPDIR="$CATALINA_BASE"/temp
に設定されています。JIRA_INSTALL を JIRA_HOME から分割した場合、そこに十分な空き容量があることをご確認ください。
保持されるインデックス スナップショットの数はどのように変更できますか?
以下の手順で、Jira インデックス スナップショット サービス に対して保持するバックアップ数を編集できます。
- [システム] > [インデックス] ([詳細設定]内) に移動します。
- [インデックス復元を有効にする] が ON になっていることを確認します。
- [システム] > [サービス] (こちらも [詳細設定] 内) に移動します。
- Jira インデックス スナップショット サービスを探し、[編集] をクリックします。
- 最初のフィールドが [保持するバックアップの数] となます。このフィールドを編集して [更新] をクリックします。
The steps above can be achieved by changing the backupCount parameter. Starting from Jira 9, a new parameter (jira.index.snapshot.count) applies to change the number of index snapshots retained. You can alter this parameter by navigating Administration > System > Global configuration > Advanced Settings.
圧縮方法を .tar.sz から zip または tar に変更できますか?
はい、Jira 7.12.0 以降では、Jira がインデックスのスナップショット ファイルの圧縮に使用する圧縮アルゴリズムを選択できます。「Jira Data Center でインデックスのスナップショット ファイルの圧縮方法を変更する方法」をご確認ください。
スナップショットの作成時に (サイズ = 18 G)、スナップショットの生成にはどの程度の時間がかかりますか?また、これはシステム パフォーマンスの悪化や高負荷状態を引き起こすことはありますか?
このサイズの場合、スナップショットの作成には最大で 1 時間程度かかる可能性があります。システムの全体的なスループットへの影響は、環境に応じて異なるようです。弊社のテストでは小規模な影響のみを確認していますが、パフォーマンスの大幅な悪化を報告しているお客様もいらっしゃいます。これは I/O を消費する処理であり、圧縮は CPU とメモリの両方を必要とします。このため、パフォーマンスへの影響はハードウェアのキャパシティに応じる部分が大きいようです。また、同じマシン上でスナップショット作成と同時に再インデックスを行うと、インデックスファイルの書き込みロックにより失敗するという影響もあります。
スナップショットのディレクトリを別のパスに変更することはできますか?
いいえ。.nix 環境の場合はシンボリック リンクを作成できます。これをネットワーク ドライブにマップした場合、それがパフォーマンスの問題を引き起こさないことをご確認ください。
復元スナップショット中に、システムが利用できなくなることが示されていますが、システムの一部にアクセスできることがテスト中に判明しました。スナップショットの復元中にユーザーは課題を操作できますか?
復元するインデックスのために古いインデックスがスワップ アウトされる非常に短い期間の間、インデックスは利用できなくなり、アクセスはできません。処理の主要な部分はスナップショットの展開であり、この間はシステムは引き続き利用できます。同様に、最終調整が行われるタイミングで、スナップショットの作成後に変更された課題の再インデックスが行われます。
18 G のインデックス サイズのインスタンスの場合、スナップショットの復元にはどの程度の時間が必要ですか?
これは 3 ステップのプロセスです。
- スナップショットが展開されます。これはご利用のハードウェアに応じます。
- 現在のインデックスがスワップ アウトされ、スナップショットで置き換えられます。これはディレクトリのリネーム (移動) で、ほとんど一瞬で行われます。
- スナップショットの作成以降に更新された課題は、手動で再インデックスされる必要があります。これは一般に、インデックス全体の復元よりも短い時間で完了します。たとえば、一週間分のスナップショットがあり、システムには 3 年間分の課題があるとき、3 年分のインデックスを再インデックスする時間の 2 % で再インデックスが完了します。