疑難排解Oak索引 troubleshooting-oak-indexes

開啟Web控制台，然後按一下JMX頁簽或轉到https://<host>:<port>/system/console/jmx(例如， http://localhost:4502/system/console/jmx)。

導覽至 IndexStats 姆班斯。

開啟 IndexStats 「 async"和" fulltext-async」。

對於兩個MBean，檢查 完成 時間戳記和 LastIndexTime 時間戳記自目前時間起不到45分鐘。

對於任一MBean，如果時間值(完成 或 LastIndexedTime)大於當前時間的45分鐘，則索引作業失敗或花費太長時間。 這會導致非同步索引過時。

首先，判斷AEM執行個體是否以強制方式關閉(AEM程式已強制終止，或發生電源故障)，然後重新啟動。

• AEM記錄 可就此審查。

如果發生強制關閉，重新啟動時，AEM會自動暫停重新索引最多30分鐘。

等待約45分鐘，讓AEM繼續正常的非同步索引操作。

為Apache Sling排程器定義新的隔離執行緒池，以用於非同步索引：

• 在受影響的AEM例項上，導覽至AEM OSGi Web Console>OSGi > Configuration > Apache Sling Scheduler或前往https://<host>:<port>/system/console/configMgr(例如， http://localhost:4502/system/console/configMgr)
• 將項目新增至「允許的執行緒池」欄位，並將其值設為「oak」。
• 按一下右下角的「儲存」 ，儲存變更。

確認已註冊新的Apache Sling排程器執行緒池，並在Apache Sling排程器狀態Web主控台中顯示。

• 導覽至AEM OSGi Web主控台>狀態> Sling排程器，或前往https://<host>:<port>/system/console/status-slingscheduler(例如， http://localhost:4502/system/console/status-slingscheduler)

• 驗證是否存在以下池項：

  • ApacheSlingoak
  • ApacheSlingdefault

轉到Web控制台，然後按一下JMX頁簽或轉到https://<host>:<port>/system/console/jmx(例如， http://localhost:4502/system/console/jmx)

開啟Oak Repository Statistics MBean，並判斷是否有 ObservationQueueMaxLength 值大於10,000。

• 在正常操作中，此最大值必須最終降為零(尤其是 per second 部分)，確認 ObservationQueueMaxLength的秒量度為0。
• 如果值為10,000或更多，並且穩步增加，則表示至少一個（可能更多）隊列無法像發生新更改（提交項）一樣快速處理。
• 每個觀察佇列都有一個限制（預設為10,000），如果佇列達到該限制，其處理會降低。
• 使用MongoMK時，當佇列長度長度增加時，內部Oak快取效能會降低。 此關聯可以在 missRate 針對 DocChildren 快取 Consolidated Cache 統計MBean。

為避免超過可接受的觀察隊列限制，建議執行以下操作：

• 降低提交的恆定速率。 提交量中短的尖峰是可接受的，但應該降低恆定速率。
• 增加 DiffCache 如 效能調整提示> Mongo儲存調整>文檔快取大小.

為了確定索引停滯的原因，必須收集以下資訊：

• 收集5分鐘的線程轉儲，每2秒收集一個線程轉儲。

• 設定附加程式的DEBUG層級和記錄.

  • org.apache.jackrabbit.oak.plugins.index.AsyncIndexUpdate
  • org.apache.jackrabbit.oak.plugins.index.IndexUpdate

• 從非同步收集資料 IndexStats MBean:

  • 導覽至「AEM OSGi Web Console>Main>JMX>IndexStat>async」

    或前往 http://localhost:4502/system/console/jmx/org.apache.jackrabbit.oak%3Aname%3Dasync%2Ctype%3DIndexStats

• 使用 oak-run.jar的主控台模式 收集* /:async*節點。

• 使用 CheckpointManager MBean:

  • AEM OSGi Web Console>Main>JMX>CheckpointManager>listChapperits()

    或前往 http://localhost:4502/system/console/jmx/org.apache.jackrabbit.oak%3Aname%3DSegment+node+store+checkpoint+management%2Ctype%3DCheckpointManager

收集步驟1中概述的所有資訊後，請重新啟動AEM。

• 重新啟動AEM可解決併發負載高（觀察隊列溢出或類似情況）的問題。
• 如果重新啟動無法解決問題，請開啟 Adobe客戶服務 並提供在步驟1中收集的所有資訊。

識別控制需要停止的重新索引通道的IndexStats MBean。

• 通過轉到AEM OSGi Web Console>Main>JMX或https://，導航到JMX控制台的相應IndexStats MBean<host>:<port>/system/console/jmx(例如， http://localhost:4502/system/console/jmx)

• 根據要停止的重新索引通道開啟IndexStats MBean( async, async-reindex，或 fulltext-async)

  • 若要識別適當的通道，進而識別IndexStats MBean例項，請查看Oak Indexes "async"屬性。 「async」屬性將包含通道名稱： async, async-reindex，或 fulltext-async.
  • 存取「非同步」欄中的AEM Index Manager也可使用通道。 要訪問索引管理器，請導航到操作>診斷>索引管理器。

叫用 abortAndPause() 命令 IndexStats MBean。

正確標示Oak索引定義，以防止在索引通道恢復時繼續重新索引。

• 重新索引 現有 索引，將reindex屬性設定為false

  • /oak:index/someExistingIndex@reindex=false

• 或者，對於 new 索引，或者：

  • 將type屬性設定為已禁用

    • /oak:index/someNewIndex@type=disabled

  • 或完全刪除索引定義

完成後將更改提交到儲存庫。

最後，在中止的索引通道上繼續非同步索引。

• 在 IndexStats 發出 abortAndPause() 命令，調用 resume()命令。