Oak索引疑难解答 troubleshooting-oak-indexes

打开Web控制台，然后单击JMX选项卡或转到https://<host>：<port>/system/console/jmx (例如，http://localhost:4502/system/console/jmx)。

导航到IndexStats Mbean。

打开“async”和“fulltext-async”的IndexStats MBean。

对于两个MBean，检查​ Done ​时间戳和​ LastIndexTime ​时间戳是否比当前时间少于45分钟。

对于任一MBean，如果时间值（Done ​或​ 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控制台>Status>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存储库统计数据MBean并确定是否有任何ObservationQueueMaxLength值大于10,000。

• 在正常操作中，此最大值最终必须始终减少到零（尤其是在per second部分中），因此请验证ObservationQueueMaxLength的秒量度是否为0。
• 如果值为10,000或更多，并且稳步增加，则表示至少一个（可能更多）队列的处理速度不能像新更改（提交）发生一样快。
• 每个观察队列都有一个限制（默认为10,000），如果队列点击了该限制，则其处理会降级。
• 使用MongoMK时，随着队列长度增大，内部Oak缓存性能会降低。 可以在Consolidated Cache统计数据MBean中DocChildren缓存的增加missRate中看到此关联。

为避免超出可接受的观察队列限制，建议：

• 降低提交固定速率。 承诺量出现短峰值是可以接受的，但应降低恒定速率。
• 按照性能优化提示> Mongo存储优化>文档缓存大小中的说明增加DiffCache的大小。

要确定索引卡住的原因，必须收集以下信息：

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

    或转到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。

• 通过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索引“异步”属性。 “async”属性包含通道名称： async、async-reindex或fulltext-async。
  • 此外，还可以通过访问“异步”列中的AEM索引管理器来使用此通道。 要访问索引管理器，请导航到“操作”>“诊断”>“索引管理器”。

在适当的IndexStats MBean上调用abortAndPause()命令。

适当地标记Oak索引定义，以防止在索引领域恢复时恢复重新索引。

• 重新索引​ existing ​索引时，将重新索引属性设置为false

  • /oak:index/someExistingIndex@reindex=false

• 否则，对于​ 新 ​索引：

  • 将type属性设置为禁用

    • /oak:index/someNewIndex@type=disabled

  • 或完全删除索引定义

完成后，将更改提交到存储库。

最后，恢复在中止索引车道上的异步索引。

• 在步骤2中发出abortAndPause()命令的IndexStats MBean中，调用resume()命令。