ドキュメントExperience Cloud KCS

AEM インデックス作成の問題の分析

最終更新日： 2026年6月24日

この記事では、低速クエリの分析、非同期インデックスのインデックス再作成、Adobe Experience Managerでのインデックス作成の問題のトラブルシューティングに関するガイダンスを提供します。

説明 description

環境

Adobe Experience Manager

問題/症状

一般的なインデックス作成の問題をすべてトラブルシューティングする方法

解決策 resolution

スロークエリの分析

ツール > 操作 > ダッシュボード > 診断 > クエリパフォーマンス に移動すると、動作の遅いクエリのリストが表示されます。

低速なクエリの分析について詳しくは、このドキュメント ​を参照してください。

実稼動以外の環境では、Adobe Consulting サービス（ACS）のAEM ツールパッケージをインストールして、さらにデバッグを行うためのexplain クエリツールを提供できます。

非同期インデックスの再作成

注： インデックス再作成では、通常、クエリが適切な結果を返さないなど、クエリの問題は解決されません。 また、インデックス再作成には時間がかかる場合があります。インデックス再作成は、ここに記載されている理由でカバーされていない限り避けてください。

非同期インデックスを再インデックスする方法

  • AEM インスタンスにログインします

  • http://aemhost:port/crx/de/index.jspを開きます

  • /oak:indexの下のインデックス定義を参照します

  • インデックスを再インデックス化するインデックスにブール型プロパティ reindex=trueを設定し、保存します。 インデックス作成を開始すると、次のようなログメッセージが表示されます。

    code language-none 
    23.06.2015 14:26:23.070 *INFO* [ FelixStartLevel]
org.apache.jackrabbit.oak.plugins.index.IndexUpdate Reindexing will be performed for following indexes:
[ /oak:index/cqAcUUID, /oak:index/nodetype, /oak:index/deviceIdentificationMode, /oak:index/campaignpath, /oak:index/active, /oak:index/jcrFrozenMixinTypes]

  • インデックス再作成が進行中の間、IndexStatsMBeanの​ status ​属性の値は​ running ​となります。

    code language-none 
    23.06.2015 14:26:23.517 *INFO* [ FelixStartLevel]
org.apache.jackrabbit.oak.plugins.index.IndexUpdate Reindexing Traversed #10000 /jcr:system/jcr:versionStorage/c8/5f...
23.06.2015 14:28:51.999 *INFO* [ pool-8-thread-1]  org.apache.jackrabbit.oak.plugins.index.IndexUpdate Indexing
report    - /oak:index/counter
(708)    - /oak:index/authorizables
(159)    - /oak:index/cqPageLucene
(1913)    - /oak:index/ntBaseLucene
(444)    - /oak:index/cqTagLucene
(512)    - /oak:index/workflowDataLucene*(116)

  • インデックス定義ノードを確認して、インデックス作成が完了したことを確認できます。プロパティ reindexCountを増分し、再インデックスのブール値を​ false ​に設定する必要があります。

    ログファイルで、インデックス作成が正常に完了した場合、次のエントリが表示されます。

    code language-none 
    23.06.2015 14:28:52.009 *INFO* [ pool-8-thread-1]
org.apache.jackrabbit.oak.plugins.index.AsyncIndexUpdate Reindexing (async) completed for indexes:
[ /oak:index/counter*(708), /oak:index/authorizables*(159),
/oak:index/cqPageLucene*(1913), /oak:index/ntBaseLucene*(444),
/oak:index/cqTagLucene*(512), /oak:index/workflowDataLucene*(116)]
in 30.36 s

  • インデックス再作成が完了せず、ループに入った場合は、下の「失敗したインデックス再作成の分析」の節を参照してください。

  • 非同期インデックスアクティビティは、次の場所でグリップすることで、INFO レベルで識別できます。

    code language-none 
    org.apache.jackrabbit.plugins.index.IndexUpdate, and
org.apache.jackrabbit.plugins.index.AsyncIndexUpdate

非同期インデックス作成パフォーマンスの問題

  1. 有効なタイミングでのログを有効にします。

    TRACE Level（Oak 1.0.17 以降のみ）：

    code language-none 
    org.apache.jackrabbit.oak.plugins.index.lucene.LuceneIndexEditorContext.perf

    DEBUG Level：

    code language-none 
    org.apache.jackrabbit.oak.plugins.index.AsyncIndexUpdate
org.apache.jackrabbit.oak.plugins.index.IndexUpdate
org.apache.jackrabbit.oak.plugins.index.lucene.LuceneIndexEditor
org.apache.jackrabbit.oak.plugins.index.lucene.IndexTracker
org.apache.jackrabbit.oak.plugins.index.lucene.LuceneIndexEditorContext
org.apache.jackrabbit.oak.plugins.index.lucene.IndexCopier

    インデックス作成のタイミングを示す、次のようなログが生成されます。

    code language-none 
    09.07.2015 08:13:38.401 *TRACE* [ 192.168.193.1 [ 1436444018387]  POST /content/dam/site/test.createasset.html HTTP/1.1]  org.apache.jackrabbit.oak.jcr.operations.writes [ session-101777]  Adding node [ /content/dam/site/test/jackrabbit-oak7.png]


09.07.2015 08:13:38.583 *TRACE* [ 192.168.193.1 [ 1436444018387]  POST /content/dam/site/test.createasset.html HTTP/1.1]  org.apache.jackrabbit.oak.jcr.operations.writes [ session-101777]  save


09.07.2015 08:13:42.823 *DEBUG* [ pool-9-thread-1]  org.apache.jackrabbit.oak.plugins.index.AsyncIndexUpdate Running background index task async


09.07.2015 08:13:42.963 *TRACE* [ pool-9-thread-1]  org.apache.jackrabbit.oak.plugins.index.lucene.LuceneIndexEditor [ /oak:index/lucene]  Indexed document for /content/dam/site/test/jackrabbit-oak7.png/jcr:content/related is Document<stored,indexed,omitNorms,indexOptions=DOCS_ONLY<:path:/content/dam/site/test/jackrabbit-oak7.png/jcr:content/related> indexed,tokenized<:fulltext:related>>


09.07.2015 08:13:43.579 *DEBUG* [ pool-9-thread-1]  org.apache.jackrabbit.oak.plugins.index.IndexUpdate Indexing report
- /oak:index/siteDamIndex(2)
- /oak:index/lucene(15)


09.07.2015 08:13:43.779 *TRACE* [ oak-lucene-0]  org.apache.jackrabbit.oak.plugins.index.lucene.IndexTracker.perf [ /oak:index/siteDamIndex]  Index found to be updated. Reopening the IndexNode [ took 150ms]


09.07.2015 08:13:45.248 *TRACE* [ oak-lucene-0]  org.apache.jackrabbit.oak.plugins.index.lucene.IndexCopier.perf [ /oak:index/lucene]  Copied 0 files totaling 0 B [ took 1465ms]


09.07.2015 08:13:45.248 *TRACE* [ oak-lucene-0]  org.apache.jackrabbit.oak.plugins.index.lucene.IndexCopier [ /oak:index/lucene]  opening remote only file segments.gen


09.07.2015 08:13:45.361 *TRACE* [ oak-lucene-0]  org.apache.jackrabbit.oak.plugins.index.lucene.IndexTracker.perf [ /oak:index/lucene]  Index found to be updated. Reopening the IndexNode [ took 1581ms]

  2. 一連のスレッドダンプを取得し、AsyncIndexUpdateを含むスレッドをスタック内で検索して、インデックス作成に費やされている時間の大部分を確認するか、インデックス作成が他のスレッドで待機しているかどうかを確認します。 スレッドダンプを取得するには、この記事を参照してください。

  3. ブール型プロパティ saveDirectoryListing=trueを設定し（後のバージョンが必要でない場合はOak 1.0.16を使用する場合のみ）、/oak:index/lucene OOTB インデックスのプロパティ excludedPaths=[ /var, /etc/workflow/instances, /jcr:system]を設定して最適化します。

  4. 「すべて保存」をクリックします。

  5. 独自のlucene プロパティインデックスを作成する場合は、Oak 1.0.16を使用している場合は必ずsaveDirectoryListing=true （Boolean）を設定し、includedPaths （String[ ]）プロパティを設定して、インデックスを特定のパスのみに限定します。

  6. このURL /system/console/configMgr/org.apache.jackrabbit.oak.plugins.index.lucene.LuceneIndexProviderService 読み取り​でのコピー、書き込み​でのコピー（Oak 1.0.18以降でのみ安全に使用できます）、「インデックスファイルの先行取得」（Oak 1.0.18以降のみ）に移動します

失敗したインデックス再作成の分析

  1. 非同期インデックス作成が失敗すると、非同期インデクサー統計JMX UI （以下のリンク）を確認すると、LastIndexedTimeが古い日時であることが表示されます：http://localhost:4502/system/console/jmx/org.apache.jackrabbit.oak%3Aid%3D11%2Cname%3D"async"%2Ctype%3D"IndexStats"

  2. インデックス再作成が失敗すると、次のようなループに入ります。

    code language-none 
    08.01.2015 01:22:04.474 *INFO* [ pool-9-thread-2]
org.apache.jackrabbit.oak.plugins.index.IndexUpdate Reindexing will be performed for following indexes
[ /oak:index/damFileSize, /oak:index/lucene, /oak:index/cqLastModified] 08.01.2015 01:52:08.365 *INFO* [ pool-9-thread-5]
org.apache.jackrabbit.oak.plugins.index.IndexUpdate Reindexing will be performed for following indexes
[ /oak:index/damFileSize, /oak:index/lucene, /oak:index/cqLastModified] 08.01.2015 09:33:23.306 *INFO* [ pool-9-thread-5]
org.apache.jackrabbit.oak.plugins.index.IndexUpdate Reindexing will be performed for following indexes
[ /oak:index/damFileSize, /oak:index/lucene, /oak:index/cqLastModified]

  3. それがわかったら、org.apache.jackrabbit.oak.plugins.indexのデバッグレベルのログを有効にする必要があります

  4. 次回、インデックス作成が上記のログメッセージを伴ってループしたら、デバッグログメッセージにインデックス作成が失敗した理由に関する詳細が表示されます。 次に、ノードが破損している、BLOBが見つからない、またはその他の問題など、問題に対処できます。

recommendation-more-help
experience-cloud-kcs-help-kbarticles