疑難排解Oak索引

慢速重新索引

AEM的內部重新索引程式會收集儲存庫資料，並將它儲存在Oak索引中，以支援內容的效能查詢。 在例外情況下，程式可能會變得緩慢甚至停滯。 本頁提供疑難排解指南，可協助您識別索引是否緩慢、找出原因並解決問題。

請務必區分需要花費不適當時間的重新建立索引，以及需要花費大量時間的重新建立索引，因為這是為大量內容建立索引。 例如，索引內容所花的時間會隨著內容量而擴展，因此大型生產儲存庫的重新索引所需時間會比小型開發儲存庫更長。

有關何時以及如何重新索引內容的詳細資訊，請參閱查詢和索引的最佳做法。

初始檢測

初始檢測慢速索引需要查看IndexStats JMX MBean。 在受影響的AEM例項上，執行下列動作：

1. 開啟Web控制台並按一下JMX頁籤，或轉至https://<host>:<port>/system/console/jmx(例如http://localhost:4502/system/console/jmx)。

2. 導航至IndexStats Mbean。

3. 開啟「 async」和「 fulltext-async」的IndexStats MBean。

4. 對於兩個MBean，檢查​Done​時間戳記和​LastIndexTime​時間戳記是否比當前時間少45分鐘。

5. 對於任一MBean，如果時間值（Done​或​LastIndexedTime）從當前時間大於45分鐘，則索引作業會失敗或過長。 這會導致非同步索引過時。

強制關閉後索引暫停

強制關閉會導致AEM在重新啟動後最多30分鐘暫停非同步索引，而且通常需要15分鐘才能完成第一次重新索引傳遞，總共約45分鐘（與初始偵測時間範圍45分鐘相連）。 如果您懷疑索引在強制關閉後暫停：

1. 首先，判斷AEM例項是否以強制方式關閉（AEM程式已強制中止，或發生電源故障），然後重新啟動。

   • AEM 記錄可依此目的進行審查。

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

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

線程池過載

在特殊情況下，用於管理非同步索引的線程池可能會過載。 為了隔離索引程式，可以設定執行緒池，以防止其他AEM工作干擾Oak即時索引內容的能力。 若要這麼做，您應：

1. 為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"。
   • 按一下右下角的「儲存」，儲存變更。

   

2. 驗證新的Apache Sling Scheduler執行緒池已註冊並顯示在Apache Sling Scheduler Satus網站主控台中。

   • 導覽至AEM OSGi Web console>Status>Sling Scheduler或前往https://<host>:<port>/system/console/status-slingscheduler(例如，http://localhost:4502/system/console/status-slingscheduler)

   • 驗證是否存在以下池條目：

     • ApacheSlingoak
     • ApacheSlingdefault

   

觀察佇列已滿

如果在短時間內對儲存庫進行了太多更改和提交，則由於完全觀察隊列，索引可能會延遲。 首先，確定觀測隊列是否滿：

1. 轉到Web控制台並按一下「JMX」頁籤，或轉到https://<host>:<port>/system/console/jmx(例如http://localhost:4502/system/console/jmx)

2. 開啟Oak Repository統計資料MBean，並判斷是否有ObservationQueueMaxLength值大於10,000。

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

3. 為避免超過可接受的觀察隊列限制，建議您：

   • 降低提交的恆定速率。 提交中的短尖峰是可以接受的，但應該降低恆定速率。
   • 按照效能調整提示>單次儲存調整>文檔快取大小中所述增加DiffCache的大小。

確定並修正停滯的重新索引進程

在兩種情況下，重新編製索引可以被視為「完全停滯」:

• 重新編製索引非常緩慢，以至於日誌檔案中沒有報告有關所遍歷的節點數的顯著進展。

  • 例如，如果在一小時內沒有訊息，或進度太慢，以至需要一週或更久才能完成。

• 如果索引線程的日誌檔案（例如OutOfMemoryException）中出現重複的異常，則重新索引將被困在一個循環中。 重複記錄中的相同例外，表示Oak嘗試重複索引相同的項目，但在相同問題上失敗。

要識別並修復停滯的重新索引過程，請執行以下操作：

1. 為了找出索引卡住的原因，必須收集下列資訊：

   • 收集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>listChreckeptions()

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

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

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

安全中止非同步重新索引

可以通過async, async-reindex和f ulltext-async索引通道(IndexStats Mbean)安全中止（在完成前停止）重新索引。 如需詳細資訊，請參閱如何中止重新索引上的Apache Oak檔案。 此外，請考慮：

• Lucene和Lucene屬性索引的重新索引可以中止，因為它們是自然同步的。
• 只有透過PropertyIndexAsyncReindexMBean啟動重新索引時，Oak屬性索引的重新索引才能中止。

要安全中止重新編製索引，請執行以下步驟：

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

   • 透過JMX主控台導覽至適當的IndexStats MBean，方法是前往AEM OSGi Web Console>Main>JMX或https://<host>:<port>/system/console/jmx(例如http://localhost:4502/system/console/jmx)

   • 根據您要停止的重新索引通道（async、async-reindex或fulltext-async）開啟IndexStats MBean

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

   

2. 在相應的IndexStats MBean上調用abortAndPause()命令。

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

   • 在重新索引​existing​索引時，將reindex屬性設為false

     • /oak:index/someExistingIndex@reindex=false

   • 或者，對於​new​索引，可以：

     • 將type屬性設為disabled

       • /oak:index/someNewIndex@type=disabled

     • 或完全刪除索引定義

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

4. 最後，在中止的索引通道上恢復非同步索引。

   • 在步驟2中發出abortAndPause()命令的IndexStats MBean中，調用resume()命令。

防止慢速重新索引

最好在安靜時段（例如，不是在大型內容收錄時）重新索引，最理想的是在維護視窗中，當AEM的負載已知並受控時。 此外，請確保在其他維護活動期間不會重新編製索引。