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

重新索引緩慢 slow-re-indexing

AEM的內部重新索引程式會收集存放庫資料並將其儲存在Oak索引中,以支援對內容的效能查詢。 在特殊情況下,流程可能會變得緩慢甚至停滯。 本頁作為疑難排解指南,有助於識別索引是否緩慢、找出原因並解決問題。

區分需要花費不適當的長時間重新索引與需要很長時間重新索引很重要,因為這會索引大量內容。 例如,為內容建立索引所需的時間會隨著內容量而調整,因此大型生產存放庫重新建立索引的時間會比小型開發存放庫長。

請參閱關於查詢和索引的最佳實務,以取得關於何時及如何重新索引內容的詳細資訊。

初始偵測 initial-detection

初始偵測緩慢索引需要檢閱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分鐘,則索引工作會失敗或花費太長時間。 此問題會導致非同步索引過時。

在強制關機後暫停索引 indexing-is-paused-after-a-forced-shutdown

強制關閉導致AEM在重新啟動後暫停非同步索引長達30分鐘。 而且通常需要再花15分鐘來完成第一個重新索引階段,總共大約需要45分鐘(繫結回初始偵測45分鐘的時間範圍)。 如果索引在強制關機後暫停:

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

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

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

執行緒集區超載 thread-pool-overloaded

NOTE
對於AEM 6.1,請確定已安裝AEM 6.1 CFP 11

在特殊情況下,用於管理非同步索引的對話串池可能會變得超載。 為了隔離索引過程,可以設定對話串集區,以防止其他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」。
    • 若要儲存變更,請按一下右下角的​ 儲存

    chlimage_1-119

  2. 確認新的Apache Sling排程器執行緒集區已註冊,並顯示在Apache Sling排程器狀態Web主控台中。

    chlimage_1-120

觀察佇列已滿 observation-queue-is-full

如果在短時間內對存放庫進行了太多變更和認可,則索引可能會由於觀察佇列已滿而延遲。 首先,判斷觀察佇列是否已滿:

  1. 前往Web主控台,然後按一下JMX標籤,或前往https://<host>:<port>/system/console/jmx (例如,http://localhost:4502/system/console/jmx)

  2. 開啟Oak存放庫統計MBean並判斷是否有任何ObservationQueueMaxLength值大於10,000。

    • 在一般作業中,此最大值最終必須一律減少為零(尤其是在per second區段中),因此請確認ObservationQueueMaxLength的秒數量度是0。
    • 如果值為10,000或更多,並且穩定增加,則表示至少一個(可能更多)佇列無法以新變更(認可)發生時的速度處理。
    • 每個觀察佇列都有限制(預設為10,000),如果佇列點選該限制,其處理會降級。
    • 使用MongoMK時,隨著佇列長度增加,內部Oak快取效能會降低。 在Consolidated Cache統計資料MBean中,DocChildren快取的增加missRate中可以看到此相互關聯。
  3. 為避免超過可接受的觀察佇列限制,建議:

識別及修正停滯的重新索引程式 identifying-and-remediating-a-stuck-re-indexing-process

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

  • 重新索引的速度很慢,以至於記錄檔案中並未報告有關已周遊節點數的顯著進度。

    • 例如,如果一小時內沒有訊息,或進度太慢,需要一週或更長時間才能完成。
  • 如果索引執行緒中的記錄檔(例如,OutOfMemoryException)中出現重複的例外狀況,則重新索引會卡在無限回圈中。 記錄中重複一或多個相同的例外狀況,表示Oak嘗試重複為相同專案編制索引,但因相同問題而失敗。

若要識別並修正停滯的重新索引程式,請執行下列動作:

  1. 若要找出索引卡住的原因,必須收集下列資訊:

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

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

安全地中止非同步重新索引 safely-aborting-asynchronous-re-indexing

可以透過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)

    • 根據您要停止的重新索引通道(asyncasync-reindexfulltext-async)開啟IndexStats MBean

      • 若要識別適當的通道,並藉此識別IndexStats MBean執行個體,請檢視Oak索引「非同步」屬性。 「非同步」屬性包含通道名稱: asyncasync-reindexfulltext-async
      • 您也可以存取「非同步」欄中的AEM Index Manager來存取通道。 若要存取「索引管理員」,請瀏覽至「作業」>「診斷」>「索引管理員」。

    chlimage_1-121

  2. 在適當的IndexStats MBean上叫用abortAndPause()命令。

  3. 適當地標籤Oak索引定義,以防止在索引領域恢復時繼續重新索引。

    • 重新索引​ 現有 ​索引時,將重新索引屬性設定為false

      • /oak:index/someExistingIndex@reindex=false
    • 或者,對於​ ​索引,可以:

      • 將type屬性設定為disabled

        • /oak:index/someNewIndex@type=disabled
      • 或完全移除索引定義

    完成時將變更提交到存放庫。

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

    • 在步驟2中發出abortAndPause()命令的IndexStats MBean中,呼叫resume()命令。

防止緩慢重新索引 preventing-slow-re-indexing

最好在靜默期(例如,在大型內容擷取期間)重新索引,最好在已知並控制AEM載入的維護期間重新索引。 此外,請確定重新索引不會在其他維護活動期間發生。

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2