Felsöka Oak-index troubleshooting-oak-indexes

Öppna webbkonsolen och klicka på fliken JMX eller gå till https://<host>:<port>/system/console/jmx (t.ex. http://localhost:4502/system/console/jmx).

Navigera till de IndexStats bönerna.

Öppna IndexStats MBeans för async och fulltext-async.

Kontrollera om tidsstämpeln Done och tidsstämpeln LastIndexTime är mindre än 45 minuter från den aktuella tiden för båda MBeans.

Om tidsvärdet (Done eller LastIndexedTime) är större än 45 minuter från den aktuella tiden i MBean misslyckas indexjobbet eller tar för lång tid. Detta problem gör att asynkrona index blir inaktuella.

Börja med att kontrollera om AEM stängdes av på ett framtvingat sätt (AEM har tvångsdödats eller ett strömavbrott har inträffat) och sedan startats om.

• AEM loggning kan granskas för detta ändamål.

Om den framtvingade avstängningen inträffar kommer AEM automatiskt att avbryta omindexering i upp till 30 minuter vid omstart.

Vänta ca 45 minuter tills AEM återupptar vanliga asynkrona indexeringsåtgärder.

Definiera en ny isolerad trådpool för Apache Sling Scheduler som ska användas för asynkron indexering:

• På den berörda AEM-instansen går du till AEM OSGi Web Console>OSGi>Configuration>Apache Sling Scheduler eller till https://<host>:<port>/system/console/configMgr (t.ex. http://localhost:4502/system/console/configMgr)
• Lägg till en post i fältet Tillåtna trådpooler med värdet eke.
• Spara ändringarna genom att klicka på Spara längst ned till höger.

Kontrollera att den nya trådpoolen för Apache Sling Scheduler är registrerad och visas i webbkonsolen för Apache Sling Scheduler Status.

• Gå till AEM OSGi Web console>Status>Sling Scheduler eller gå till https://<port>/system/console/status-slingscheduler (t.ex. http://localhost:4502/system/console/status-slingscheduler)

• Kontrollera att följande poolposter finns:

  • ApacheSlingoak
  • ApacheSlingdefault

Gå till webbkonsolen och klicka på fliken JMX eller gå till https://<värd>:<port>/system/console/jmx (t.ex. http://localhost:4502/system/console/jmx)

Öppna MBean för Oak-databasstatistik och kontrollera om något ObservationQueueMaxLength-värde är större än 10 000.

• I normala åtgärder måste det här maxvärdet alltid minskas till noll (särskilt i avsnittet per second) så verifiera att ObservationQueueMaxLengths sekundmått är 0.
• Om värdena är 10 000 eller fler och ökar stadigt innebär det att minst en (eventuellt fler) kö inte kan bearbetas så fort nya ändringar (implementeringar) inträffar.
• Varje observationskö har en gräns (10 000 som standard) och om kön når den gränsen försämras hanteringen.
• När du använder MongoMK försämras prestanda för intern Oak-cache när kölängderna blir stora. Den här korrelationen kan ses i en ökad missRate för DocChildren-cachen i Consolidated Cache-statistiken i MBean.

För att undvika att överskrida tillåtna gränser för observationsköer bör du:

• Minska den konstanta frekvensen för implementeringar. Korta toppar i implementeringar är godtagbara, men den konstanta hastigheten bör minskas.
• Öka storleken på DiffCache enligt beskrivningen i Prestandajusteringstips > Justering av monolagring > Dokumentcache-storlek.

För att identifiera orsaken till den fasta indexeringen måste följande information samlas in:

• Samla 5 minuters tråddump, en tråddump varannan sekund.

• Ange DEBUG-nivå och loggar för programtilläggen.

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

• Samla in data från det asynkrona IndexStats MBean:

  • Navigera till AEM OSGi Web Console>Main>JMX>IndexStat>async

    eller gå till http://localhost:4502/system/console/jmx/org.apache.jackrabbit.oak%3Aname%3Dasync%2Ctype%3DIndexStats

• Använd konsolläget 🔗 för oak-run.jar för att samla in information om vad som finns under noden * /:async*.

• Samla in en lista med databaskontrollpunkter med CheckpointManager MBean:

  • AEM OSGi Web Console>Main>JMX>CheckpointManager>listCheckpoints()

    eller gå till http://localhost:4502/system/console/jmx/org.apache.jackrabbit.oak%3Aname%3DSegment+node+store+checkpoint+management%2Ctype%3DCheckpointManager

När du har samlat in all information som beskrivs i steg 1 startar du om AEM.

• Att starta om AEM kan lösa problemet om det finns en hög samtidig belastning (spill i observationskön eller något liknande).
• Om en omstart inte löser problemet kan du öppna ett problem med Adobe kundtjänst och ange all information som samlats in i steg 1.

Identifiera det IndexStats MBean som styr det omindexeringsintervall som måste stoppas.

• Navigera till rätt IndexStats MBean via JMX-konsolen genom att antingen gå till AEM OSGi Web Console>Main>JMX eller https://<host>:<port>/system/console/jmx (till exempel http://localhost:4502/system/console/jmx)

• Öppna IndexStats MBean baserat på det omindexeringsintervall som du vill stoppa ( async, async-reindex eller fulltext-async)

  • Titta på egenskapen async i Oak Indexes för att identifiera lämpligt intervall och därmed instansen IndexStats MBean. Egenskapen async innehåller körfältsnamnet: async, async-reindex eller fulltext-async.
  • Du kan även komma åt körfältet genom att AEM Indexhanteraren i kolumnen "Async". Gå till Åtgärder > Diagnostik > Indexhanteraren om du vill öppna indexhanteraren.

Anropa kommandot abortAndPause() på lämplig IndexStats MBean.

Markera Oak indexdefinition så att den inte kan återindexeras när indexeringsfältet återupptas.

• När du indexerar om ett befintligt-index ska du ange egenskapen reindex till false

  • /oak:index/someExistingIndex@reindex=false

• Eller, för ett nytt-index, antingen:

  • Ange att type-egenskapen ska vara inaktiverad

    • /oak:index/someNewIndex@type=disabled

  • eller ta bort indexdefinitionen helt

Genomför ändringarna i databasen när de är klara.

Slutligen kan du återuppta asynkron indexering på det avbrutna indexeringsfältet.

• Anropa kommandot resume() i IndexStats MBean som skickade kommandot abortAndPause() i steg 2.