Oak索引疑难解答

慢速重新索引

AEM内部重新索引过程会收集存储库数据并将其存储在Oak索引中，以支持对内容的性能查询。 在特殊情况下，该过程可能会变得缓慢甚至停滞。 本页作为疑难解答指南，可帮助确定索引速度是否慢、查找原因并解决问题。

区分需要花费不适当的时间的重新索引和需要很长时间的重新索引是很重要的，因为这是对大量内容进行索引。 例如，索引内容所需的时间会随内容量而扩展，因此大型生产存储库重新索引的时间要比小型开发存储库花费的时间长。

请参阅查询和索引的最佳实践 ，以了解有关何时以及如何重新索引内容的其他信息。

初始检测

初始检测慢速索引需要检查IndexStats JMX MBean。 在受影响的AEM实例上，执行以下操作：

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

  2. 导航到IndexStats Mbeans。

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

  4. 对于这两个MBean，检查​Done​时间戳和​LastIndexTime​时间戳是否距当前时间不足45分钟。

  5. 对于MBean，如果时间值（Done​或​LastIndexedTime）从当前时间起超过45分钟，则索引作业会失败或用时过长。 这会导致异步索引失效。

强制关闭后，索引暂停

强制关闭会导致AEM在重新启动后将异步索引挂起长达30分钟，并且通常需要另外15分钟才能完成首次重新索引传递，总共约45分钟（与Initial Detection时间范围45分钟绑定）。 如果您怀疑在强制关闭后暂停了索引，则：

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

    • 可 以为此目的审阅AEM日志。

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

  3. 大约需要等待45分钟，AEM才能恢复正常的异步索引操作。

线程池已重载

注意

对于AEM 6.1，请确保安装了AEM 6.1 CFP 11。

在特殊情况下，用于管理异步索引的线程池可能会变得过载。 为了隔离索引过程，可以配置一个线程池，以防止其他AEM工作干扰Oak及时索引内容的能力。 为此，您应：

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

    • 在受影响的AEM实例上，导航到AEM OSGi Web Console>OSGi>Configuration>Apache Sling调度程序，或转到https://<host>:<port>/system/console/configMgr(例如，http://localhost:4502/system/console/configMgr)
    • 在“允许的线程池”字段中添加一个值为“oak”的条目。
    • 单击右下方的保存以保存更改。

    chlimage_1-119

  2. 验证新的Apache Sling Scheduler线程池是否已注册并显示在Apache Sling Scheduler状态Web控制台中。

    chlimage_1-120

观察队列已满

如果在短时间内对存储库进行了太多更改和提交，则索引可能会因完整观察队列而延迟。 首先，确定观察队列是否满：

  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. 为避免超出可接受的观察队列限制，建议执行以下操作：

识别和修正停滞的重新索引进程

在以下两种情况下，可以将重新索引视为“完全停滞”：

  • 重新索引非常缓慢，直到日志文件中没有关于已遍历的节点数的显着进度报告为止。

    • 例如，如果在一小时内没有消息，或者进度太慢，需要一周或更长时间才能完成。

  • 如果索引线程的日志文件（例如OutOfMemoryException）中出现重复的异常，则重新索引会陷入无休止循环。 日志中重复出现相同的异常，表示Oak尝试重复对同一内容进行索引，但在同一问题上失败。

要识别并修复卡住的重新索引过程，请执行以下操作：

  1. 为了确定索引卡住的原因，必须收集以下信息：

  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索引“异步”属性。 “async”属性将包含车道名称：async、async-reindex或fulltext-async。
      • 通过访问“异步”列中的AEM Index Manager，也可以访问通道。 要访问索引管理器，请导航至“操作”>“诊断”>“索引管理器”。

    chlimage_1-121

  2. 在相应的IndexStats MBean上调用abortAndPause()命令。

  3. 正确标记Oak索引定义，以防止在索引通道恢复时恢复重新索引。

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

      • /oak:index/someExistingIndex@reindex=false

    • 或者，对于​new​索引，可以：

      • 将type属性设置为disabled

        • /oak:index/someNewIndex@type=disabled

      • 或完全删除索引定义

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

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

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

防止慢速重新索引

最好在安静时段（例如，不是在大内容摄取期间）重新编入索引，最好在已知并控制AEM加载的维护时段重新编入索引。 另外，请确保在其他维护活动期间不进行重新索引。

在此页面上