インデックスの自動修復によってインデックス化の問題を修正する
インデックスの自動修復は、システムを定期的にスキャンしてインデックス作成に関する問題を検出することで、インスタンスの最適な検索パフォーマンスを維持できるように設計されています。つまり、作業に影響を与えずに検出した問題が自動的に修正されるため、Jira アプリのインデックスの完全再作成を計画する必要がなくなります。
インデックスの自動修復の仕組みをご確認ください
インデックスの自動修復を設定するには、Jira システム管理者のグローバル権限を持つユーザーとしてログインする必要があります。Jira のグローバル権限の概要
インデックスの自動修復は、次のタイプの課題を特定して解決します。
インデックス孤立データ: Jira 課題がインデックスにのみ存在し、データベースに存在しない場合に発生します。
データベース孤立データ: Jira 課題がデータベースにのみ存在し、インデックスに存在しない場合に発生します。
古くなった課題: インデックス化されたデータとデータベース内のデータが一致しない場合に発生します。
インデックスの自動修復プロセスは、スケジュールされた cron ジョブによって自動化されます。このプロセスは、データベースにない課題のインデックスを解除し、インデックスにない問題や古くなった課題のインデックスを再作成することで機能します。すべてのノードで同時にインデックスの自動修復プロセスが開始され、システム全体ですべての不整合に対処できるように、このプロセスはノード単位で行われます。
インデックスの自動修復を設定する
既定では、インデックスの自動修復は毎日午前 1 時のローカル インスタンス時間に実行されるようにスケジュールされています。cron スケジュールを変更したり、Jira のインスタンス最適化ツールの設定でこの機能を無効にしたりできます。
インデックスの自動修復の設定を変更するには、次の手順に従います。
Jira アプリケーションの右上隅で [Jira 管理] > [システム] の順に選択します。
サイドバーで、[インスタンス最適化ツール] に移動し、[インデックスの自動修復] を選択します。
インデックスの自動修復スケジュールを更新する
インデックスの自動修復スケジュールは、minute hour day_of_month month day_of_week
という形式の cron 式として作成します。各値はスペースで区切ります。cron 構文の詳細な概要については、「cron 式を作成する」を参照してください。
cron 構文を使用すると、ジョブを実行するタイミングを分単位で正確に指定できるため、日付と時刻をより柔軟に設定できます。
たとえば、2 月、4 月、6 月、8 月、10 月、12 月の初日の午後 2 時 15 分にインデックスの自動修復を実行するものとします。cron 式は 15 14 1 2,4,6,8,10,12 *
のようになります。
ログでインデックスの自動修復の詳細を確認する
インデックスの自動修復のステータスと結果に関する詳細情報は、高度な監査ログに記録されます。画面の右上隅にある [ログの表示] ボタンを選択すると、[インデックスの自動修復] ページから直接ログにアクセスできます。
[高度な監査ログ] ページでは、すべての情報がインデックスの自動修復カテゴリに表示されます。監査ログ エントリの例を次に示します。
インデックスの自動修復カテゴリ。インデックスの自動修復ジョブで記録されたすべてのイベントが含まれます。
監査ログ エントリの詳細。
各監査ログ エントリには、完了した自動修復ジョブに関する次のような詳細が含まれています。
ノード ID: インデックスの自動修復が実行されたノードの一意の ID。
バッチ サイズ: 各バッチで分析される不健全なアイテムの最大数。
このノードのインデックス ステータス: ジョブ実行後のインデックスの健全性。ステータスは、[健康] (ジョブは正常に完了) または [Unhealthy (不健康)] (ジョブはエラーで終了) のいずれかです。このような場合は、手動でインデックスを再作成することをお勧めします。Jira のインデックスを再作成する方法については、こちらをご確認ください。
ジョブの結果: インデックスの自動修復ジョブの結果。
失敗したアイテムの総数: エラーが発生して終了したアイテムの数。一部の問題は再試行時に正常に修正される可能性があるため、[失敗したアイテムの総数] は未修復のアイテムの数と一致しない場合があります。
修復されたアイテムの総数: インデックスの自動修復ジョブで修復されたアイテムの数。
未修復アイテムの総数: 修復できなかったアイテムの数。この場合は、手動でインデックスを再作成することをお勧めします。
合計処理時間 (ミリ秒): インデックスの自動修復の実行にかかった合計時間。