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

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

导航至 IndexStats 姆比安。

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

对于两个MBean，检查 完成 时间戳和 LastIndexTime 时间戳距当前时间不到45分钟。

对于任一MBean，如果时间值(完成 或 LastIndexedTime)大于当前时间的45分钟，则索引作业失败或耗时过长。 此问题会导致异步索引过时。

首先，确定AEM实例是否以强制方式关闭(AEM进程被强制终止，或发生电源故障)，然后重新启动。

• AEM日志记录 可以为此目的审查。

如果发生强制关闭，则在重新启动时，AEM会自动暂停重新索引长达30分钟。

请等待大约45分钟，以便AEM恢复正常的异步索引操作。

为Apache Sling调度程序定义新的独立线程池以用于异步索引：

• 在受影响的AEM实例上，导航到AEM OSGi Web Console>OSGi>配置>Apache Sling计划程序，或转到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存储库统计数据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>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)

• 根据要停止的重新索引通道打开IndexStats MBean( async， async-reindex，或 fulltext-async)

  • 要识别适当的通道，从而识别IndexStats MBean实例，请查看Oak索引“异步”属性。 “async”属性包含通道名称： async， async-reindex，或 fulltext-async.
  • 此外，还可以通过访问“异步”列中的AEM索引管理器来使用此通道。 要访问索引管理器，请导航到“操作”>“诊断”>“索引管理器”。

调用 abortAndPause() 命令(位于相应的 IndexStats MBean。

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

• 重新索引时 现有 index，将reindex属性设置为false

  • /oak:index/someExistingIndex@reindex=false

• 否则，对于 新建 索引：

  • 将type属性设置为禁用

    • /oak:index/someNewIndex@type=disabled

  • 或完全删除索引定义

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

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

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