Felsöka ekindex 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 IndexStats Mönster.

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

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

För 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 gör att asynkrona index blir inaktuella.

För det första ska du avgöra om AEM stängdes av på ett tvingat sätt (den AEM processen tvångsdödades eller ett strömavbrott inträffade) och därefter starta 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:

• På den berörda AEM-instansen går du till AEM OSGi Web Console>OSGi>Configuration>Apache Sling Scheduler eller går 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.
• Klicka på Spara längst ned till höger för att spara ändringarna.

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 (t.ex. 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 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 fastande 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.

• Om du startar om AEM kan problemet åtgärdas vid hög samtidig belastning (spill i observationskön eller liknande).
• Om en omstart inte löser problemet kan du öppna 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 behöver 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 (t.ex. 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" kommer att innehålla 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". Om du vill komma åt indexhanteraren går du till Åtgärder > Diagnostik > Indexhanteraren.

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

Markera indexdefinitionen på ekv för att förhindra att indexeringen å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.