Analisi dei problemi di indicizzazione di AEM

Questo articolo spiega come analizzare le query lente, reindicizzare gli indici asincroni e risolvere i problemi di indicizzazione dell’AEM.

Descrizione description

Ambiente

Experience Manager

Problema/Sintomi

Come risolvere tutti i problemi comuni di indicizzazione?

Risoluzione resolution

Analisi delle query lente

Vai a Strumenti  > Operazioni  > Dashboard  > Diagnosi  > Prestazioni query mostrerà l’elenco delle query lente.

Consulta questo documento per informazioni dettagliate sull’analisi delle query lente.

In ambienti non di produzione, è possibile installare il pacchetto di strumenti ACS AEM per fornire uno strumento di query esplicativo per ulteriori operazioni di debug.

Reindicizzazione degli indici asincroni

Nota: La reindicizzazione in genere non risolve i problemi relativi alle query, ad esempio le query che non restituiscono i risultati corretti. Inoltre, la reindicizzazione può richiedere molto tempo. La reindicizzazione deve essere evitata a meno che non sia coperta da uno dei motivi elencati.

Reindicizzare un indice asincrono

  • Accedi all’istanza AEM

  • Apri http://aemhost:port/crx/de/index.jsp

  • Passare alla definizione dell'indice in /oak:index

  • Imposta una proprietà booleana reindex=true sull’indice da reindicizzare, quindi salva. All’avvio dell’indicizzazione viene visualizzato un messaggio di registro simile al seguente:

    code language-none
    23.06.2015 14:26:23.070 *INFO* [ FelixStartLevel]
    org.apache.jackrabbit.oak.plugins.index.IndexUpdate Reindexing will be performed for following indexes:
    [ /oak:index/cqAcUUID, /oak:index/nodetype, /oak:index/deviceIdentificationMode, /oak:index/campaignpath, /oak:index/active, /oak:index/jcrFrozenMixinTypes]
    
  • Quando la reindicizzazione è in corso, l’attributo "status" di IndexStatsMBean avrà il valore "running".

    code language-none
    23.06.2015 14:26:23.517 *INFO* [ FelixStartLevel]
    org.apache.jackrabbit.oak.plugins.index.IndexUpdate Reindexing Traversed #10000 /jcr:system/jcr:versionStorage/c8/5f...
    23.06.2015 14:28:51.999 *INFO* [ pool-8-thread-1]  org.apache.jackrabbit.oak.plugins.index.IndexUpdate Indexing
    report    - /oak:index/counter
    (708)    - /oak:index/authorizables
    (159)    - /oak:index/cqPageLucene
    (1913)    - /oak:index/ntBaseLucene
    (444)    - /oak:index/cqTagLucene
    (512)    - /oak:index/workflowDataLucene*(116)
    
  • Puoi confermare che l’indicizzazione è stata completata verificando il nodo di definizione dell’indice, dove la proprietà reindexCount deve essere stata incrementata e la reindicizzazione booleana deve essere impostata su "false".

    Nel file di registro, se l’indicizzazione è stata completata correttamente, verrà visualizzata la seguente voce:

    code language-none
    23.06.2015 14:28:52.009 *INFO* [ pool-8-thread-1]
    org.apache.jackrabbit.oak.plugins.index.AsyncIndexUpdate Reindexing (async) completed for indexes:
    [ /oak:index/counter*(708), /oak:index/authorizables*(159),
    /oak:index/cqPageLucene*(1913), /oak:index/ntBaseLucene*(444),
    /oak:index/cqTagLucene*(512), /oak:index/workflowDataLucene*(116)]
    in 30.36 s
    
  • Se la reindicizzazione non è completa ed è entrata in un loop, vedi la sezione seguente dal titolo Analisi della reindicizzazione non riuscita.

  • L’attività dell’indice asincrono può essere identificata a livello di INFO eseguendo il comando grep su:

    code language-none
    org.apache.jackrabbit.plugins.index.IndexUpdate, and
    org.apache.jackrabbit.plugins.index.AsyncIndexUpdate
    

Problemi relativi alle prestazioni dell’indicizzazione asincrona

  1. Abilita la registrazione per convalidare la tempistica:

    Livello di TRACCIA (solo in Oak 1.0.17 o versioni successive):

    code language-none
    org.apache.jackrabbit.oak.plugins.index.lucene.LuceneIndexEditorContext.perf
    

    Livello di DEBUG:

    code language-none
    org.apache.jackrabbit.oak.plugins.index.AsyncIndexUpdate
    org.apache.jackrabbit.oak.plugins.index.IndexUpdate
    org.apache.jackrabbit.oak.plugins.index.lucene.LuceneIndexEditor
    org.apache.jackrabbit.oak.plugins.index.lucene.IndexTracker
    org.apache.jackrabbit.oak.plugins.index.lucene.LuceneIndexEditorContext
    org.apache.jackrabbit.oak.plugins.index.lucene.IndexCopier
    

    Vengono generati registri simili ai seguenti, che mostrano i tempi di indicizzazione:

    code language-none
    09.07.2015 08:13:38.401 *TRACE* [ 192.168.193.1 [ 1436444018387]  POST /content/dam/site/test.createasset.html HTTP/1.1]  org.apache.jackrabbit.oak.jcr.operations.writes [ session-101777]  Adding node [ /content/dam/site/test/jackrabbit-oak7.png]
    
    
    09.07.2015 08:13:38.583 *TRACE* [ 192.168.193.1 [ 1436444018387]  POST /content/dam/site/test.createasset.html HTTP/1.1]  org.apache.jackrabbit.oak.jcr.operations.writes [ session-101777]  save
    
    
    09.07.2015 08:13:42.823 *DEBUG* [ pool-9-thread-1]  org.apache.jackrabbit.oak.plugins.index.AsyncIndexUpdate Running background index task async
    
    
    09.07.2015 08:13:42.963 *TRACE* [ pool-9-thread-1]  org.apache.jackrabbit.oak.plugins.index.lucene.LuceneIndexEditor [ /oak:index/lucene]  Indexed document for /content/dam/site/test/jackrabbit-oak7.png/jcr:content/related is Document<stored,indexed,omitNorms,indexOptions=DOCS_ONLY<:path:/content/dam/site/test/jackrabbit-oak7.png/jcr:content/related> indexed,tokenized<:fulltext:related>>
    
    
    09.07.2015 08:13:43.579 *DEBUG* [ pool-9-thread-1]  org.apache.jackrabbit.oak.plugins.index.IndexUpdate Indexing report
    - /oak:index/siteDamIndex(2)
    - /oak:index/lucene(15)
    
    
    09.07.2015 08:13:43.779 *TRACE* [ oak-lucene-0]  org.apache.jackrabbit.oak.plugins.index.lucene.IndexTracker.perf [ /oak:index/siteDamIndex]  Index found to be updated. Reopening the IndexNode [ took 150ms]
    
    
    09.07.2015 08:13:45.248 *TRACE* [ oak-lucene-0]  org.apache.jackrabbit.oak.plugins.index.lucene.IndexCopier.perf [ /oak:index/lucene]  Copied 0 files totaling 0 B [ took 1465ms]
    
    
    09.07.2015 08:13:45.248 *TRACE* [ oak-lucene-0]  org.apache.jackrabbit.oak.plugins.index.lucene.IndexCopier [ /oak:index/lucene]  opening remote only file segments.gen
    
    
    09.07.2015 08:13:45.361 *TRACE* [ oak-lucene-0]  org.apache.jackrabbit.oak.plugins.index.lucene.IndexTracker.perf [ /oak:index/lucene]  Index found to be updated. Reopening the IndexNode [ took 1581ms]
    
  2. Acquisisci una serie di immagini thread e cerca il thread contenente AsyncIndexUpdate nello stack per vedere dove viene impiegato il tempo di indicizzazione o se l’indicizzazione è in attesa su altri thread. Per acquisire le immagini thread, consulta questo articolo.

  3. Imposta la proprietà booleana saveDirectoryListing=true (solo se utilizzi Oak 1.0.16, se non è necessaria una versione successiva) e la proprietà excludedPaths=[ /var, /etc/workflow/instances, /jcr:system] sull’indice OOTB /oak:index/lucene per ottimizzarlo.

  4. Clic Salva tutto.

  5. Quando crei indici personalizzati con proprietà Lucene, assicurati di impostare saveDirectoryListing=true (Boolean) se utilizzi Oak 1.0.16 e di impostare includedPaths (String)[ ] ) per limitare l’indicizzazione solo a determinati percorsi.

  6. Vai a questo URL /system/console/configMgr/org.apache.jackrabbit.oak.plugins.index.lucene.LuceneIndexProviderService "Copy on Read" (Copia su lettura), "Copy on Write" (Copia su scrittura) (utilizzabile solo in Oak 1.0.18 e versioni successive) e "Prefetch Index Files" (Preacquisizione dei file di indice) (solo in Oak 1.0.18 e versioni successive)

Analisi della reindicizzazione non riuscita

  1. Quando l’indicizzazione asincrona ha esito negativo e verifichi le statistiche dell’indicizzatore asincrono nell’interfaccia utente di JMX (collegamento qui sotto), puoi notare che LastIndexedTime è una data e un’ora precedenti: http://localhost:4502/system/console/jmx/org.apache.jackrabbit.oak%3Aid%3D11%2Cname%3D"async"%2Ctype%3D"IndexStats"

  2. Quando la reindicizzazione non riesce, entra in un loop simile al seguente:

    code language-none
    08.01.2015 01:22:04.474 *INFO* [ pool-9-thread-2]
    org.apache.jackrabbit.oak.plugins.index.IndexUpdate Reindexing will be performed for following indexes
    [ /oak:index/damFileSize, /oak:index/lucene, /oak:index/cqLastModified] 08.01.2015 01:52:08.365 *INFO* [ pool-9-thread-5]
    org.apache.jackrabbit.oak.plugins.index.IndexUpdate Reindexing will be performed for following indexes
    [ /oak:index/damFileSize, /oak:index/lucene, /oak:index/cqLastModified] 08.01.2015 09:33:23.306 *INFO* [ pool-9-thread-5]
    org.apache.jackrabbit.oak.plugins.index.IndexUpdate Reindexing will be performed for following indexes
    [ /oak:index/damFileSize, /oak:index/lucene, /oak:index/cqLastModified]
    
  3. Se visualizzi questo codice, abilita la registrazione a livello di debug per org.apache.jackrabbit.oak.plugins.index

  4. Al successivo loop dell’indicizzazione con relativo messaggio di registro, verrà visualizzato anche un messaggio di registro di debug nella parte superiore con ulteriori dettagli sul motivo del fallimento dell’indicizzazione. Quindi puoi risolvere il problema, che sia un nodo corrotto, un BLOB mancante o un altro problema.

recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f