Oak 색인 문제 해결 troubleshooting-oak-indexes

웹 콘솔을 열고 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분 동안 자동으로 색인 재지정을 일시 중단합니다.

AEM이 일반적인 비동기 인덱싱 작업을 다시 시작할 때까지 약 45분 정도 기다립니다.

비동기 인덱싱에 사용할 Apache Sling 스케줄러에 대해 격리된 새 스레드 풀을 정의합니다.

• 영향을 받는 AEM 인스턴스에서 AEM OSGi 웹 콘솔>OSGi>구성>Apache Sling 스케줄러로 이동하거나 https://으로 이동합니다.<host>:<port>/system/console/configMgr (예: http://localhost:4502/system/console/configMgr)
• 값이 "oak"인 "허용된 스레드 풀" 필드에 항목을 추가합니다.
• 변경 사항을 저장하려면 를 클릭합니다. 저장 오른쪽 하단에 있습니다.

새 Apache Sling 스케줄러 스레드 풀이 등록되고 Apache Sling 스케줄러 상태 웹 콘솔에 표시되는지 확인합니다.

• AEM OSGi 웹 콘솔>상태>Sling 스케줄러로 이동하거나 https://으로 이동합니다.<host>:<port>/system/console/status-slingscheduler(예: http://localhost:4502/system/console/status-slingscheduler)

• 다음 풀 항목이 있는지 확인하십시오.

  • 아파치슬링고악
  • ApacheSlingdefault

웹 콘솔로 이동하고 JMX 탭을 클릭하거나 https://으로 이동합니다.<host>:<port>/system/console/jmx (예: http://localhost:4502/system/console/jmx)

Oak 저장소 통계 MBean을 열고 있는지 확인합니다. ObservationQueueMaxLength 값이 10,000보다 큽니다.

• 일반 작업에서 이 최대값은 항상 0으로 감소해야 합니다(특히 per second 섹션)을 클릭하여 ObservationQueueMaxLength의 초 지표는 0입니다.
• 값이 10,000 이상이며 꾸준히 증가하는 경우 새로운 변경(커밋)이 발생하는 즉시 하나 이상의 대기열을 처리할 수 없음을 나타냅니다.
• 각 관찰 큐에는 제한(기본적으로 10,000)이 있으며 큐가 해당 제한에 도달하면 처리가 저하됩니다.
• MongoMK를 사용할 때 대기열 길이가 커지면 내부 Oak 캐시 성능이 저하됩니다. 이러한 상관관계는 증가한 것으로 볼 수 있다 missRate 대상: DocChildren 의 캐시 Consolidated Cache 통계 MBean

허용 가능한 관찰 대기열 한도를 초과하지 않도록 다음 작업을 수행하는 것이 좋습니다.

• 일정한 커밋 비율을 낮춥니다. 커밋의 짧은 스파이크는 허용되지만 상수 비율은 감소해야 합니다.
• 크기 늘리기 DiffCache 에 설명된대로 성능 조정 팁 > Mongo Storage Tuning > 문서 캐시 크기.

색인화가 중단된 원인을 식별하려면 다음 정보를 수집해야 합니다.

• 5분의 스레드 덤프를 수집하고, 2초마다 하나의 스레드 덤프를 수집합니다.

• appenders에 대한 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 웹 콘솔>기본>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을 식별합니다.

• AEM OSGi 웹 콘솔>메인>JMX 또는 https://으로 이동하여 JMX 콘솔을 통해 해당 IndexStats MBean으로 이동합니다.<host>:<port>/system/console/jmx (예: http://localhost:4502/system/console/jmx)

• 중지하려는 리인덱싱 레인을 기반으로 IndexStats MBean을 엽니다. ( async, async-reindex, 또는 fulltext-async)

  • 적절한 레인과 IndexStats MBean 인스턴스를 식별하려면 Oak Indexes "async" 속성을 참조하십시오. "async" 속성은 레인 이름을 포함합니다. async, async-reindex, 또는 fulltext-async.
  • "비동기" 열에서 AEM Index Manager에 액세스하여 레인을 사용할 수도 있습니다. 색인 관리자에 액세스하려면 작업>진단>색인 관리자로 이동합니다.

호출 abortAndPause() 적절한 명령 IndexStats MBean.

색인 지정 레인이 다시 시작될 때 색인 재지정을 다시 시작하지 않도록 Oak 색인 정의를 적절하게 표시하십시오.

• 리인덱싱 시 기존 index, reindex 속성을 false로 설정합니다.

  • /oak:index/someExistingIndex@reindex=false

• 또는 신규 색인:

  • 유형 속성을 비활성화로 설정

    • /oak:index/someNewIndex@type=disabled

  • 또는 색인 정의를 완전히 제거하십시오

완료되면 변경 사항을 저장소에 커밋합니다.

마지막으로, 중단된 인덱싱 레인에서 비동기 인덱싱을 다시 시작합니다.

• 다음에서 IndexStats 을(를) 발급한 MBean abortAndPause() 2단계의 명령에서 resume()명령입니다.