Lucene Search Indexes health check fails in Jira server
プラットフォームについて: 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 uses indexes to provide quick results to search queries that are made by users and internal functions of JIRA, as described in our Search Indexing documentation. A third-party library called Lucene provides these indexes. This health check inspects the state of the search index and confirms that it is consistent with the database. The Health Check is provided by the JIRA Instance Health Add-on.
ソリューション
結果の確認
アイコン | 結果 | 意味 |
---|---|---|
The check of the database and the index is ok. The database had <issue-count> issues with the most recent update at <date > and the index had <issue-count> issues with the most recent update at <date >. | The health check did not discover any problems with your Lucene Index. | |
The issue index is inconsistent with the database state (see below). | This result indicates a problem with the reliability of your JIRA Indexes when the node is in a Disaster Recovery mode. During this mode, the health-check will allow a 30 second discrepancy between the indexes and the database. | |
The issue index is inconsistent with the database state. Database has (<issue-count-1 >) issues but the index has (<issue-count-2 >) issues. | This result indicates a problem with the reliability of your JIRA Indexes. In case of JIRA DataCenter this is expected that index at one of the nodes will be slightly behind another node during active operations (see below). | |
The issue index is inconsistent with the database state. The last issue update recorded in the database was at (<date-1 >) but the last issue update recorded in the index was at (<date-2 >). | This result indicates a problem with the reliability of your JIRA Indexes. In case of JIRA DataCenter this is expected that index at one of the nodes will be slightly behind another node during active operations (see below). | |
Lucene search is not available. <error-message> | There was a problem testing the Lucene index. | |
Lucene search terminated abnormally: <error-message> | There was a problem running the search. This could mean the index was unavailable, or a more serious problem occurred. If you experience this issue frequently, please check the logs for errors |
トラブルシューティング
For general JIRA Lucene Indexing related issues, please review the Troubleshoot index problems in Jira server article.
問題 | 提案 |
---|---|
| Attempt to reindex the node as per Search Indexing and monitor the logs for any errors.
|
The issue index is inconsistent with the database state for JIRA DataCenter:
| Check status at each node to see if there is an actual problem. Monitor instance status over period of time to see if difference will grow. Attempt to copy index from healthy node if required. If no other nodes available, attempt to reindex the node as per Search Indexing and monitor the logs for any errors. Improvement ticket: |
Lucene Search is not available. | Contact Atlassian Support with the collected information below and the reported error message seen. |
Lucene search terminated abnormally | Please have this issue assessed by Atlassian. Heavy load in the JIRA instance may instigate this problem Contact Atlassian Support with the collected information below and the reported error message seen. |
Lucene Health Check failure notification is displayed in JIRA Data Center as a false positive (it fails in the notification, on the instance health screen it passes) | Update to the latest version of the JIRA Instance Health Add-on, as it was disabled for JIRA Data Center in version 2.1.21 as it was generating false positives. |
サポートに情報を提供する
トラブルシューティングやご自身での問題の解決が難しい場合、support.atlassian.com でサポート チケットを作成し、次の情報を含めてください。
- ヘルス チェック結果のスクリーンショット
- 各 Data Center ノードからのサポート zip
- このドキュメントでの提案事項を受けて収集した任意の情報
- The results of the Testing Disk Access Speed test as detailed in that KB.