Risoluzione dei problemi degli indici Oak troubleshooting-oak-indexes

Last update: Sun Jul 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Argomenti:
Amministrazione

Creato per:

Amministratore

Reindicizzazione lenta slow-re-indexing

Il processo di reindicizzazione interno dell’AEM raccoglie i dati dell’archivio e li memorizza negli indici Oak per supportare l’esecuzione di query sui contenuti. In circostanze eccezionali, il processo può diventare lento o addirittura bloccato. Questa pagina funge da guida alla risoluzione dei problemi per identificare se l’indicizzazione è lenta, individuare la causa e risolvere il problema.

È importante distinguere tra la reindicizzazione che richiede una quantità di tempo inappropriatamente lunga e la reindicizzazione che richiede una quantità di tempo molto lunga perché sta indicizzando grandi quantità di contenuto. Ad esempio, il tempo necessario per indicizzare il contenuto corrisponde alla quantità di contenuto, pertanto la reindicizzazione dei grandi archivi di produzione richiede più tempo rispetto alla reindicizzazione dei piccoli archivi di sviluppo.

Per ulteriori informazioni su quando e come reindicizzare il contenuto, consulta le best practice per query e indicizzazione.

Rilevamento iniziale initial-detection

Per l'indicizzazione lenta del rilevamento iniziale è necessario rivedere IndexStats MBean JMX. Nell’istanza AEM interessata, effettua le seguenti operazioni:

Apri la console Web e fai clic sulla scheda JMX o passa a https://<host>:<port>/system/console/jmx (ad esempio, http://localhost:4502/system/console/jmx).
Passare a IndexStats Mbean.
Aprire IndexStats MBean per " async" e " fulltext-async".
Per entrambi gli MBean, verifica se la marca temporale Fine e LastIndexTime sono inferiori a 45 minuti dall'ora corrente.
Per MBean, se il valore di ora (Fine o LastIndexedTime) è maggiore di 45 minuti rispetto all'ora corrente, il processo dell'indice non riesce o richiede troppo tempo. Questo problema fa sì che gli indici asincroni non siano aggiornati.

Indicizzazione sospesa dopo un arresto forzato indexing-is-paused-after-a-forced-shutdown

Un arresto forzato comporta la sospensione dell’indicizzazione asincrona da parte dell’AEM per un massimo di 30 minuti dopo il riavvio. Inoltre, in genere sono necessari altri 15 minuti per completare la prima fase di reindicizzazione, per un totale di circa 45 minuti (rilegati all'intervallo temporale di rilevamento iniziale di 45 minuti). Se l'indicizzazione viene sospesa dopo un arresto forzato:

In primo luogo, stabilire se l'istanza AEM è stata chiusa in modo forzato (il processo AEM è stato interrotto con la forza o si è verificato un guasto di corrente) e successivamente riavviata.
- Registrazione AEM può essere rivista a questo scopo.
Se si è verificata la chiusura forzata, al riavvio l’AEM sospende automaticamente la reindicizzazione per un massimo di 30 minuti.
Attendere circa 45 minuti affinché l’AEM riprenda le normali operazioni di indicizzazione asincrona.

Pool di thread sovraccaricato thread-pool-overloaded

NOTE

Per AEM 6.1, assicurati che sia installato AEM 6.1 CFP 11.

In circostanze eccezionali, il pool di thread utilizzato per gestire l’indicizzazione asincrona potrebbe subire un sovraccarico. Per isolare il processo di indicizzazione, è possibile configurare un pool di thread per evitare che altri processi AEM interferiscano con la capacità di Oak di indicizzare il contenuto in modo tempestivo. In questi casi, effettuare le seguenti operazioni:

Definisci un nuovo pool di thread isolati per Apache Sling Scheduler da utilizzare per l’indicizzazione asincrona:
- Nell’istanza AEM interessata, passa a AEM OSGi Web Console>OSGi>Configuration>Apache Sling Scheduler oppure vai su https://<host>:<port>/system/console/configMgr (ad esempio, http://localhost:4502/system/console/configMgr)
- Aggiungi una voce al campo "Pool di thread consentiti" con il valore "oak".
- Per salvare le modifiche, fai clic su Salva in basso a destra.
Verifica che il nuovo pool di thread di Apache Sling Scheduler sia registrato e visualizzato nella console web Stato Apache Sling Scheduler.
- Passa alla console Web OSGi>Stato>Sling Scheduler di AEM o vai a https://<host>:<port>/system/console/status-slingscheduler (ad esempio, http://localhost:4502/system/console/status-slingscheduler)
- Verificare che siano presenti le seguenti voci del pool:
  - ApacheSlingoak
  - ApacheSlingdefault

La coda di osservazione è piena observation-queue-is-full

Se vengono apportate troppe modifiche e commit all’archivio in un breve periodo di tempo, l’indicizzazione può essere ritardata a causa di una coda di osservazione completa. Innanzitutto, verifica se la coda di osservazione è piena:

Vai alla console Web e fai clic sulla scheda JMX oppure vai a https://<host>:<porta>/system/console/jmx (ad esempio, http://localhost:4502/system/console/jmx)
Aprire l'MBean delle statistiche dell'archivio di Oak e determinare se il valore ObservationQueueMaxLength è maggiore di 10.000.
- Nelle normali operazioni, questo valore massimo deve sempre alla fine ridursi a zero (in particolare nella sezione per second), quindi verificare che le metriche dei secondi di ObservationQueueMaxLength siano 0.
- Se i valori sono 10.000 o più e aumentano costantemente, indica che almeno una coda (possibilmente più code) non può essere elaborata con la stessa rapidità con cui si verificano nuove modifiche (commit).
- Ogni coda di osservazione ha un limite (10.000 per impostazione predefinita) e se la coda raggiunge tale limite, la sua elaborazione si deteriora.
- Quando si utilizza MongoMK, con l’aumentare delle lunghezze delle code, le prestazioni della cache interna di Oak si riducono. Questa correlazione può essere vista in un missRate aumentato per la cache DocChildren nella MBean delle statistiche Consolidated Cache.
Per evitare di superare i limiti accettabili della coda di osservazione, si raccomanda di:
- Abbassa la percentuale costante di commit. Picchi brevi nei commit sono accettabili, ma la velocità costante deve essere ridotta.
- Aumentare le dimensioni di DiffCache come descritto in Suggerimenti per l'ottimizzazione delle prestazioni > Ottimizzazione archiviazione Mongo > Dimensione cache documento.

Identificazione e correzione di un processo di reindicizzazione bloccato identifying-and-remediating-a-stuck-re-indexing-process

La reindicizzazione può essere considerata "completamente bloccata" in due condizioni:

La reindicizzazione è lenta, al punto che nei file di registro non viene segnalato alcun progresso significativo per quanto riguarda il numero di nodi attraversati.
- Ad esempio, se non ci sono messaggi nel corso di un’ora o se l’avanzamento è così lento che il completamento richiede una settimana o più.
La reindicizzazione è bloccata in un ciclo infinito se vengono visualizzate eccezioni ripetute nei file di registro (ad esempio, OutOfMemoryException) nel thread di indicizzazione. La ripetizione di una o più stesse eccezioni nel registro indica che Oak tenta di indicizzare la stessa cosa ripetutamente, ma non riesce per lo stesso problema.

Per identificare e correggere un processo di reindicizzazione bloccato, effettuare le seguenti operazioni:

Per identificare la causa del blocco dell’indicizzazione, è necessario raccogliere le seguenti informazioni:
- Raccogli 5 minuti di immagine thread, un’immagine thread ogni 2 secondi.
- Impostare il livello DEBUG e i registri per le appendici.
  - org.apache.jackrabbit.oak.plugins.index.AsyncIndexUpdate
  - org.apache.jackrabbit.oak.plugins.index.IndexUpdate
- Raccogli dati da IndexStats MBean asincroni:
  - Passa a AEM OSGi Web Console>Principale>JMX>IndexStat>asincrono
    
    oppure vai a http://localhost:4502/system/console/jmx/org.apache.jackrabbit.oak%3Aname%3Dasync%2Ctype%3DIndexStats
- Utilizza la modalità console di oak-run.jar per raccogliere i dettagli di ciò che esiste nel nodo * /:async*.
- Raccogli un elenco di punti di controllo dell'archivio utilizzando CheckpointManager MBean:
  - Console Web OSGi AEM>Principale>JMX>Gestione punti di controllo>listCheckpoints()
    
    oppure vai a http://localhost:4502/system/console/jmx/org.apache.jackrabbit.oak%3Aname%3DSegment+node+store+checkpoint+management%2Ctype%3DCheckpointManager
Dopo aver raccolto tutte le informazioni descritte nel passaggio 1, riavviare l'AEM.
- Il riavvio dell’AEM può risolvere il problema in presenza di un carico concorrente elevato (overflow della coda di osservazione o simile).
- Se il riavvio non risolve il problema, apri un problema con l'Assistenza clienti Adobe e fornisci tutte le informazioni raccolte al passaggio 1.

Interruzione sicura della reindicizzazione asincrona safely-aborting-asynchronous-re-indexing

La reindicizzazione può essere interrotta senza problemi (interrotta prima del completamento) tramite le async, async-reindex e f ulltext-async corsie di indicizzazione ( IndexStats Mbean). Per ulteriori informazioni, consulta anche la documentazione di Apache Oak su Come interrompere la reindicizzazione. Inoltre, considera quanto segue:

La reindicizzazione degli indici di proprietà Lucene e Lucene può essere interrotta in quanto sono naturalmente asincroni.
La reindicizzazione degli indici di proprietà Oak può essere interrotta solo se la reindicizzazione è stata avviata tramite PropertyIndexAsyncReindexMBean.

Per interrompere in modo sicuro la reindicizzazione, segui questi passaggi:

Identificare la voce MBean IndexStats che controlla la corsia di reindicizzazione che deve essere interrotta.
- Passa all'MBean IndexStats appropriato tramite la console JMX, da AEM OSGi Web Console>Main>JMX o https://<host>:<port>/system/console/jmx (ad esempio, http://localhost:4502/system/console/jmx)
- Aprire l'elemento MBean IndexStats in base alla corsia di reindicizzazione che si desidera interrompere ( async, async-reindex o fulltext-async)
  - Per identificare la corsia appropriata e quindi l’istanza MBean IndexStats, controlla la proprietà "async" degli indici Oak. La proprietà "async" contiene il nome della corsia: async, async-reindex o fulltext-async.
  - La corsia è disponibile anche accedendo al Gestore indice AEM nella colonna "Async". Per accedere a Gestione indice, passare a Operazioni>Diagnosi>Gestione indice.
Richiama il comando abortAndPause() sull'elemento IndexStats MBean appropriato.
Contrassegna la definizione dell’indice Oak in modo appropriato per impedire la ripresa della reindicizzazione quando la corsia di indicizzazione riprende.
- Durante la reindicizzazione di un indice esistente, impostare la proprietà reindex su false
  - /oak:index/someExistingIndex@reindex=false
- In alternativa, per un indice new:
  - Impostare la proprietà type su disabled
    - /oak:index/someNewIndex@type=disabled
  - o rimuovere completamente la definizione dell’indice
Al termine, esegui il commit delle modifiche nell’archivio.
Infine, riprendere l'indicizzazione asincrona sulla corsia di indicizzazione interrotta.
- Nel MBean IndexStats che ha emesso il comando abortAndPause() nel passaggio 2, richiamare il comando resume().

Prevenzione della reindicizzazione lenta preventing-slow-re-indexing

È meglio reindicizzare durante i periodi di silenzio (ad esempio, non durante un caricamento di contenuti di grandi dimensioni), e idealmente durante le finestre di manutenzione quando il carico dell’AEM è noto e controllato. Inoltre, assicurati che la reindicizzazione non avvenga durante altre attività di manutenzione.

recommendation-more-help

19ffd973-7af2-44d0-84b5-d547b0dffee2