Health check: Missing OpenSearch Mappings in Jira Data Center

プラットフォームについて: Data Center のみ。 - This article only applies to Atlassian apps on the Data Center プラットフォーム

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

*Fisheye および Crucible は除く

要約

In OpenSearch, mappings define how documents and their fields are stored and indexed. Each field in Jira, like a system field or custom field, needs to be mapped as index fields to enable search functionality. Jira creates these mappings when it starts, or when you create or update a custom field. If a mapping fails to be created, the affected field won’t be indexed, which disrupts its search functionality.

This health check verifies that all fields in your Jira instance are included in the OpenSearch index mappings.

ソリューション

Understand the Health Check results

アイコン

結果

意味

The OpenSearch index has all required mappings.

No issues have been detected.

<count> mappings are missing on the OpenSearch index: <field-names>.

Some fields are missing in the OpenSearch index mappings. Those fields aren’t currently indexed and therefore aren’t searchable.

⚠️

Unable to check the OpenSearch index mappings.

There was a problem checking the OpenSearch index mappings.

トラブルシューティング

問題

提案

Some fields are missing in the mappings

You can find the reason these fields failed to create index mappings in the Jira application logs.

To retry creating the mappings, restart one of your Jira nodes or update the specific custom field that is affected.

Some possible reasons for the failure include:

OpenSearch wasn't available at the time.

Jira doesn’t have permission to create mappings on your OpenSearch index.

The index.mapping.total_fields.limit setting on your OpenSearch index has been reached. Check the OpenSearch Mappings Limit Health Check if this is the case.

After you identify and resolve the problem, the affected fields might have missing data in the index. We recommend rebuilding your index to ensure its integrity. For more information, see Re-indexing Jira.

更新日時: November 5, 2025

さらにヘルプが必要ですか?

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