Felsöka ekindex

Långsam omindexering

AEM interna omindexeringsprocess samlar in databasdata och lagrar dem i Oak-index för att ge stöd för prestandafrågor. I undantagsfall kan processen bli långsam eller till och med fastna. Den här sidan fungerar som en felsökningsguide som hjälper dig att identifiera om indexeringen är långsam, hitta orsaken och lösa problemet.

Det är viktigt att skilja mellan omindexering som tar en otillräckligt lång tid och omindexering som tar lång tid eftersom det indexerar enorma mängder innehåll. Den tid det tar att indexera innehåll skalas till exempel med mängden innehåll, så stora produktionsdatabaser tar längre tid att indexera om än små utvecklingsdatabaser.

Se Metodtips för frågor och indexering om du vill ha mer information om när och hur du indexerar om innehåll.

Inledande identifiering

Inledande identifiering av långsam indexering kräver granskning av IndexStats JMX MBeans. Gör följande på den påverkade AEM:

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

  2. Navigera till IndexStats Mönster.

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

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

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

Indexeringen pausas efter en tvingad avstängning

En framtvingad avstängning medför AEM asynkron indexering i upp till 30 minuter efter omstarten. Det tar normalt ytterligare 15 minuter att slutföra den första omindexeringen, vilket tar totalt ca 45 minuter (återknytning till Inledande identifiering 45 minuter). Om indexering pausas efter en tvingad avstängning:

  1. 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.

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

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

Trådpoolen har överlästs

OBSERVERA

För AEM 6.1 ska du se till att AEM 6.1 CFP 11 är installerat.

I undantagsfall kan den trådpool som används för att hantera asynkron indexering bli överbelastad. Om du vill isolera indexeringsprocessen kan en trådpool konfigureras så att den förhindrar att andra AEM stör Oaks möjlighet att indexera innehåll i tid. I så fall gör du följande:

  1. 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.
    • Spara ändringarna genom att klicka på Spara längst ned till höger.

    chlimage_1-119

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

    chlimage_1-120

Observationskön är full

Om för många ändringar och implementeringar görs i databasen på kort tid kan indexeringen fördröjas på grund av en fullständig observationskö. Kontrollera först om observationskön är full:

  1. 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)

  2. Ö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.

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

Identifiera och åtgärda en fast omindexeringsprocess

Omindexering kan betraktas som"helt fast" under två förhållanden:

  • Omindexeringen är långsam, till den punkt där inga större framsteg rapporteras i loggfiler om antalet noder som har gått igenom.

    • Om det t.ex. inte finns några meddelanden under en timme, eller om förloppet är så långsamt att det tar en vecka eller mer att slutföra.

  • Omindexering fastnar i en oändlig slinga om upprepade undantag förekommer i loggfilerna (till exempel OutOfMemoryException) i indexeringstråden. Upprepningen av ett eller flera undantag i loggen anger att Oak försöker indexera samma sak flera gånger, men misslyckas i samma problem.

Så här identifierar och korrigerar du en fast omindexeringsprocess:

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

  2. 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 tillhandahålla all information som samlats in i steg 1.

Säkert avbrytande av asynkron omindexering

Omindexering kan avbrytas (stoppas innan den är klar) via async, async-reindexoch f ulltext-async indexera köer ( IndexStats Mbean). Mer information finns också i dokumentationen för Apache Oak på Så här avbryter du omindexering. Tänk också på följande:

  • Omindexeringen av egenskapsindexen Lucene och Lucene kan avbrytas eftersom de är naturligt asynkrona.
  • Omindexeringen av Oak-egenskapsindex kan endast avbrytas om omindexering initierades via PropertyIndexAsyncReindexMBean.

Så här avbryter du omindexering:

  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 (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" 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.

    chlimage_1-121

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

  3. Markera indexdefinitionen 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.

  4. 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.

Förhindra långsam omindexering

Det är bäst att indexera om under tysta perioder (t.ex. inte under ett stort innehållsintag) och helst under underhållsperioder när AEM är känd och kontrollerad. Se även till att omindexeringen inte sker under andra underhållsaktiviteter.

På denna sida