Oak 인덱스 문제 해결 troubleshooting-oak-indexes

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

IndexStats Mbean으로 이동합니다.

" async" 및 " fulltext-async"에 대한 IndexStatsMBean을 엽니다.

두 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 캐시 성능이 저하됩니다. 이 상관 관계는 Consolidated Cache 통계 MBean의 DocChildren 캐시에 대해 증가된 missRate에서 볼 수 있습니다.

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

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

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

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

• Appenders에 대한 디버그 수준 및 로그를 설정합니다.

  • org.apache.jackrabbit.oak.plugins.index.AsyncIndexUpdate
  • org.apache.jackrabbit.oak.plugins.index.IndexUpdate

• 비동기 IndexStatsMBean에서 데이터 수집:

  • 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* 노드 아래에 있는 항목에 대한 세부 정보를 수집합니다.

• CheckpointManagerMBean을 사용하여 저장소 체크포인트 목록을 수집합니다.

  • 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 Web Console>Main>JMX 또는 https://<host>:<port>/system/console/jmx(예: http://localhost:4502/system/console/jmx)로 이동하여 JMX 콘솔을 통해 적절한 IndexStats MBean으로 이동합니다.

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

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

적절한 IndexStatsMBean에서 abortAndPause() 명령을 호출합니다.

인덱싱 레인이 다시 시작될 때 다시 인덱싱되지 않도록 Oak 인덱스 정의를 적절하게 표시합니다.

• 기존 인덱스를 다시 인덱싱하는 경우 reindex 속성을 false로 설정하십시오.

  • /oak:index/someExistingIndex@reindex=false

• 또는 new 인덱스의 경우 다음 중 하나를 수행합니다.

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

    • /oak:index/someNewIndex@type=disabled

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

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

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

• 2단계에서 abortAndPause() 명령을 실행한 IndexStats MBean에서 resume() 명령을 호출합니다.