Felsökning av aktivitetsindex troubleshooting-oak-indexes

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

Navigera till IndexStats Mönster.

Öppna IndexStats MBeans for " asyncoch " fulltext-async".

Kontrollera om Klar tidsstämpel och LastIndexTime tidsstämpeln är mindre än 45 minuter från den aktuella tiden.

För antingen MBean, om tidsvärdet (Klar eller LastIndexedTime) är längre än 45 minuter från den aktuella tiden. Indexjobbet misslyckas 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 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:

• I den berörda AEM går du till AEM OSGi Web Console>OSGi>Configuration>Apache Sling Scheduler eller till https://<host>:<port>/system/console/configMgr (till exempel http://localhost:4502/system/console/configMgr)
• Lägg till en post i fältet Tillåtna trådpooler med värdet eke.
• 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://<host>:<port>/system/console/status-slingscheduler (till exempel 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://<host>:<port>/system/console/jmx (till exempel http://localhost:4502/system/console/jmx)

Öppna MBean för Oak Repository-statistik och kontrollera om det finns några ObservationQueueMaxLength värdet är större än 10 000.

• Vid normal användning måste det här maxvärdet alltid minskas till noll (särskilt i per second -avsnittet) så verifiera att ObservationQueueMaxLengthSekundärstatistik ä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 ekacache när kölängden blir stor. Denna korrelation kan ses vid en ökad missRate för DocChildren cachelagra i Consolidated Cache statistik 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 beskrivning 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 tilläggen.

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

• Samla in data från asynkron 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 oak-run.jar konsolläge för att samla in uppgifter om vad som finns under * /:async* nod.

• 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 öppnar du ett problem med Adobe kundtjänst och tillhandahålla 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 omindexeringsfält som du vill stoppa ( async, async-reindex, eller fulltext-async)

  • Titta på egenskapen async för att identifiera lämpligt intervall och därmed instansen IndexStats MBean. Egenskapen "async" innehåller körfältets namn: async, async-reindex, eller fulltext-async.
  • Fältet är också tillgängligt genom att du öppnar AEM Index Manager i kolumnen "Async". Gå till Åtgärder > Diagnostik > Indexhanteraren om du vill öppna indexhanteraren.

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

Markera indexdefinitionen för att förhindra att indexering återupptas när indexeringsintervallet återupptas.

• När en befintlig index, ange egenskapen reindex till false

  • /oak:index/someExistingIndex@reindex=false

• Eller, för new 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.

• I IndexStats MBean som utfärdade abortAndPause() i steg 2 anropar du resume()-kommando.