Confluence は、Lucene エンジンの機能を利用した検索インデックスを保持しています。インデックスは各 Confluence ノードの <Confluence ホーム>/index ディレクトリ内部にローカルで保管され、各 DC ノードやサーバー インスタンスで実行される Confluence のジャーナル ジョブで最新に保たれます。

ユーザーが外部ディレクトリから同期されるかローカルで作成されると、そのユーザーの個人情報 (特に姓名) がインデックス キューに追加されます。メール アドレスやユーザー名はインデックスされず、アプリケーション コードによるリクエストに応じて DB から直接取得されます。

ユーザーが追加されたあとにインデックスされない、いくつかの既知の問題があります。これらのほとんどは「Confluence で特定のユーザーを @ メンションできない」ナレッジベースに記載されたいずれかの操作で対応できます。

• Go to <Confluence URL>/confluence/display/~<不足しているユーザー> に移動してユーザー プロフィールを表示します

• <Confluence URL>/admin/force-upgrade.action URL に移動して 'UserIndexingUpgradeTask' タスクを実行します

• <Confluence URL>/confluence/admin/users/edituser.action?username=<不足しているユーザー> に移動し、自己紹介や他の任意の情報を更新します

• 新しいユーザーが単純に未インデックスである可能性があるため、 > [一般設定] > [コンテンツ インデックス] に移動し、そこからインデックスを再構築します
• 可能であればインデックスをゼロから再構築します。この方法でほとんどの問題を解決できます

ブラウザのローカル ストレージやキャッシュもユーザー メンションに影響します。これらはユーザーが頻繁にメンションする人を素早く表示できるよう保管しています。このため、別のブラウザでのテストも重要です。

便利なナレッジベース記事

• Confluence で特定のユーザーに @メンションできない

• オートコンプリートの無効化オプションを有効化しているときに特定のユーザーでメンション機能が動作しない

• コンテンツ インデックス管理
• REST API を通じて再インデックスの進捗を監視する方法
• ご利用のブラウザでユーザー メンションの一覧をリセットする方法

バグ

ユーザー メンション機能に影響する可能性がある、現在確認されているバグをいくつかご紹介します。

トラブルシューティング

ユーザー メンションやインデックスの問題のトラブルシューティングを行う際は、検索可能なユーザーと検索不可能なユーザーを比較するために DB からユーザー情報を収集することをおすすめします。

select cu.*
from CWD_USER cu
where cu.EMAIL_ADDRESS in ('non-working-user-email', 'working-user-email')
;

select cua.*
from CWD_USER cu
join CWD_USER_ATTRIBUTE cua on cua.USER_ID=cu.id
where cu.EMAIL_ADDRESS in ('non-working-user-email', 'working-user-email')
;

select um.*
from CWD_USER cu
join USER_MAPPING um on um.LOWER_USERNAME=cu.LOWER_USER_NAME
where cu.EMAIL_ADDRESS in ('non-working-user-email', 'working-user-email')
;

また、@ メンションしたいユーザーに対する USERINFO レコードが存在するかどうかを確認します。

SELECT user_mapping.username,
       content.contenttype
FROM content
INNER JOIN user_mapping ON content.username = user_mapping.user_key
WHERE contenttype = 'USERINFO'
  AND lower_username = 'username-here'
;

デバッグ ロギング

[管理] > [ロギングとプロファイル] に移動し、次のパッケージを追加して DEBUG に設定します。

com.atlassian.confluence.internal.index.AbstractBatchIndexer
com.atlassian.confluence.search.lucene
com.atlassian.bonnie.search.extractor

詳細については「インデックス用にデバッグを有効化する方法」ナレッジベースをご確認ください。

Confluence は追加されたすべてのコンテンツをインデックスします。これにはマクロ内のテキストや添付ファイル内のテキストも含まれます (抽出可能な場合)。

テキストのインデックスにおいては、選択されたインデックス言語が重要な役割を果たします。選択するインデックス言語は Confluence に保管されているコンテンツを代表するものである必要があり、次のような複数の理由のため、正確な検索に必要です。

• インデックスに保管される言葉は「ステミング (語幹解釈)」(検索対象の言葉から言語学的に。たとえば wait は waited および waits の語幹であり、meet は meeting、met、および meets の語幹) されます。
• 特定の単語は「ストップ ワード」と呼ばれ、インデックスされません。ご利用のインデックス言語が英語に設定されている場合、テキスト内の “a“、“the“、および “it“ は、ノイズと見なされ、たとえば "the" と検索しても意味のある検索結果は得られないため、インデックスされません。

Most of the indexing or search issues can be solved by simply rebuilding index. Be is standalone Server instance or Data Center, all rebuilding processes are outlined in below guides, you can also monitor rebuilding progress from REST API if you do not have WebUI access for some reason.

• コンテンツ インデックス管理
• コンテンツ インデックスをゼロから再構築する方法
• REST API を通じて再インデックスの進捗を監視する方法

インデックスのゼロからの再構築プロセスでは、発生した問題はスキップされるため、このプロセス中に発生するほとんどのエラーは無視できます。しかしながら、エラーが無くならない場合や調査が必要な場合は、次のナレッジベースをご確認ください。

便利なナレッジベース記事

• Confluence でインデックスのディレクトリに書き込めない
• 1 つのジョブがスタックしたときにスケジュール ジョブが滞留して処理に失敗する
• Confluence の再インデックスがスタックする
• ERROR java.io.IOException: No space left on device でインデクサーが停止する
• ヘルス チェック: Lucene インデックス ファイルの場所

添付ファイルのインデックス

特定のテキスト ファイル タイプでは添付ファイルの抽出およびインデックスが発生し、Confluence は 100 MB 未満のファイルでのみこれを試行します。詳細情報やデフォルトの抽出ファイル サイズの変更については「添付ファイルのサイズの構成」ガイドをご確認ください。

この機能をまとめて無効化することもできます。

バグ

全般的なインデックスや検索機能に影響する可能性がある、現在確認されているバグをいくつかご紹介します。

再構築、ロギング、内部

インデックスと Confluence 検索はコンテンツの権限に依存します。Confluence で特定のキーワードを検索すると、 Confluence のインデックス全体が検索され、コンテンツの権限に基づいて検索結果に制限が適用されます。このため、ancestor テーブルの問題はインデックスやインデックスの再構築に影響します。再構築の問題が発生している場合はこれらをご確認ください。

インデックスに関連するほとんどのエラーや警告は通常記録されますが、デバッグ ロギングを有効化し、検索、インデックスの構築、または再構築中の記録内容を確認すると、調査に非常に役立つ場合があります。

インデックスの再構築タスクでは、 "Indexer: <n>" という名前のスレッドが最大 6 つ起動されます。このタスクの実行中に発生したすべてのエラーがこのスレッドのいずれかによって記録されます。

「ERROR java.io.IOException: No space left on device でインデクサーが停止する」ナレッジベースの例です。

ERROR [Indexer: 1] [internal.index.lucene.LuceneBatchIndexer] doIndex Exception indexing document with id: 12345678
│java.io.IOException: No space left on device                                

インデックスの構築は Flush Edge Index Queue ジョブで実行されますが、これは Confluence のジョブ スケジューラーで処理されます。このため、これらのジョブの実行中に発生したすべての関連エラーや警告は基本的に "scheduler_Worker-<n>" スレッドで記録されます。同じナレッジベース内の次の例にあるように、メッセージを確認して警告/エラーの性質を判断する必要があります。

ERROR [scheduler_Worker-10] [org.quartz.core.ErrorLogger] schedulerError Job (DEFAULT.IndexQueueFlusher threw an exception.
org.quartz.SchedulerException: Job threw an unhandled exception. [See nested exception: com.atlassian.bonnie.LuceneException: com.atlassian.confluence.api.service.exceptions.ServiceException: Failed to process entries]
WARN [scheduler_Worker-10] [search.lucene.tasks.AddDocumentIndexTask] perform Error getting document from searchable
java.io.IOException: No space left on device
WARN [scheduler_Worker-1] [search.lucene.tasks.AddDocumentIndexTask] perform Error getting document from searchable
java.io.FileNotFoundException: /opt/confluence/confluence-home/index/_z8ey.fdx (No space left on device)               

インデックスの確認

稀に、Lucene インデックスそのものに格納されている情報を確認する必要がある場合があります。たとえばデバッグの一環として、コンテンツの特定の部分がインデックスされたかどうかを確認することがあります。この方法については次のガイドをご確認ください。
インデックスの問題や破損を内部から直すことはできず、破損したインデックスの再構築が最適かつ安全なオプションです。

• Confluence Server および Data Center の検索インデックスの内容を表示する方法

当社で提供している一般的な Confluence 構成は、Confluence のパフォーマンスに影響を与えることなくインデックスを運用できるように最適化したものです。

デフォルト構成を変更してインデックスの消費リソースを増やせますが、このような変更を行うと Confluence でパフォーマンスの問題が発生したり Out of Memory 例外が発生したりすることがあります。

また、Confluence に十分なリソースが割り当てられていないと、Confluence インスタンスの通常のインデックス処理で OOM イベントが発生することがあります。このようなシナリオではインデックス処理ではなくリソース割り当てが原因です。

Confluence に十分なリソース (メモリ/CPU/ディスク) が割り当てられている状態でインデックス タスクへのリソースを増やすと、インデックスの再構築時間を軽減できます。ただし、再構築時間が実際に改善の余地があるものかどうかを事前に考慮する必要があります。大量のページや添付ファイルのインデックスの構築は、インデックス タスクに割り当てられたリソースにかかわらず、長い時間を要することが期待されます。

Confluence のパフォーマンスの問題

If Confluence is facing performance problems during index rebuild operations, below are some of the things you should check:

• Confluence のノードまたはインスタンスが Out of Memory 状態になっているかどうかを確認します。該当する場合は「利用可能なメモリ量を増やして Out of Memory エラーを修正する方法」ナレッジベースに従って対応します。
• インデックスが破損していると負荷が高まる可能性があるため、インデックスのゼロからの再構築を試します (まだ行っていない場合)
• reindex.thread.count システム プロパティを 4 に設定することで、Confluence が利用するスレッドの数を一時的に減らしてみます。
  
• 上記の手順で意図した成果が得られない場合、インデックスの再構築中 (可能であればプロセスの開始時からある程度の時間が経過したあと) のスレッド ダンプ と CPU 情報をアトラシアン サポート用に集めてください。

添付ファイル

Confluence は添付ファイルからテキストを抽出し、検索用のインデックス構築を試みます。実現したい内容に応じ、この機能や潜在的な問題を取り上げたさまざまなナレッジベースを提供しています。

• 添付ファイルのインデックス作成を無効化する方法
• 添付ファイルの再インデックスに利用されるスレッドの数を変更する方法
• Confluence の再インデックスがスタックする
• ドキュメントのコンテンツが検索できない
• 添付ファイルのサイズを設定する

システム プロパティでインデックスを最適化する

If you wish for rebuilding index task to complete faster or if day to day index building is not keeping up with newly generate content rate, below parameters might help.
Try to focus on one parameter at a time to keep track of changes and control system load.

• -Dreindex.thread.count システム プロパティを 6 に設定し、一定数ずつ (2) 増やしながら、再構築処理中のディスク、CPU、メモリ負荷を監視します。
  上記のパラメーターは、Lucene がインデックスの再構築タスク用に開放するスレッドの数を決定します。インデックスの再構築時間を短縮できるかどうかの確認に役立ちます。

• -Dreindex.attachments.thread.count システム プロパティを 6 に設定し、一定数ずつ (2) 増やしながら、再構築処理中のディスク、CPU、メモリ負荷を監視します。
  上記のパラメーターは Lucene が添付ファイルのインデックスの再構築用に開放できるスレッドの数を決定します。たくさんの添付ファイルを持つシステムでインデックスの再構築時間を短縮できるかどうかの確認に役立ちます。
  

• -Dindex.queue.batch.size システム プロパティを 1500 に設定し、一定数ずつ (500) 増やしながら、通常処理中のディスク、CPU、メモリ負荷を監視します。
  上記のパラメーターは Flush Edge Index Queue ジョブで毎回処理されるアイテムの数を決定します。ご利用のシステムで大量のコンテンツが生成されていて Lucene で追いつけず、キューが常に積み上がっているような場合に便利です。移行中や大量のコンテンツ生成が予測されるときに一時的に有効化できます。

バグ

インデックスやパフォーマンスに影響する可能性がある、現在確認されているバグをいくつかご紹介します。