Best practice per il monitoraggio in Assets

Dal punto di vista di Adobe Experience Manager (AEM) Assets, il monitoraggio deve includere l’osservazione e la generazione di rapporti sui seguenti processi e tecnologie:

• CPU di sistema

• Utilizzo della memoria di sistema

• Tempo di attesa del disco di sistema IO e IO

• I/O di rete del sistema

• MBeans JMX per:

  • Utilizzo heap
  • Processi asincroni, ad esempio flussi di lavoro

• Controlli dello stato della console OSGi

In genere, AEM Assets può essere monitorato in due modi, il monitoraggio live e a lungo termine.

Monitoraggio live

È necessario eseguire il monitoraggio in tempo reale durante la fase di test delle prestazioni dello sviluppo o durante le situazioni a carico elevato per comprendere le caratteristiche delle prestazioni dell'ambiente. In genere, il monitoraggio live deve essere eseguito utilizzando una suite di strumenti. Ecco alcuni consigli:

• VM visiva: Visual VM consente di visualizzare informazioni dettagliate su Java VM, tra cui l'utilizzo della CPU, l'utilizzo della memoria Java. Inoltre, ti consente di campionare e valutare il codice in esecuzione su un'istanza.

• Parte superiore: Top è un comando Linux che apre un dashboard, che visualizza le statistiche di utilizzo, tra cui CPU, memoria e utilizzo IO. Fornisce una panoramica di alto livello di ciò che sta accadendo in un'istanza.

• Htop: Htop è un visualizzatore di processi interattivo. Fornisce l'utilizzo dettagliato della CPU e della memoria oltre a ciò che Top può fornire. Htop può essere installato sulla maggior parte dei sistemi Linux utilizzando yum install htop o apt-get install htop.

• Iotop: Iotop è un dashboard dettagliato per l'utilizzo dell'IO del disco. Visualizza barre e misuratori che rappresentano i processi che utilizzano l'IO del disco e la quantità che utilizzano. Iotop può essere installato sulla maggior parte dei sistemi Linux utilizzando yum install iotop o apt-get install iotop.

• Iftop: Iftop visualizza informazioni dettagliate sull'utilizzo di ethernet/rete. Iftop visualizza le statistiche dei canali di comunicazione sulle entità che utilizzano ethernet e la quantità di larghezza di banda utilizzata. Iftop può essere installato sulla maggior parte dei sistemi Linux utilizzando yum install iftop o apt-get install iftop.

• Registratore di volo Java (JFR): Uno strumento commerciale dall'Oracle che può essere utilizzato liberamente in ambienti non di produzione. Per ulteriori dettagli, consulta Come utilizzare il registratore di volo Java per diagnosticare i problemi runtime CQ.

• AEM file error.log: È possibile esaminare il file error.log AEM per i dettagli degli errori registrati nel sistema. Usa il comando tail -F quickstart/logs/error.log per identificare gli errori da esaminare.

• Console del flusso di lavoro: Utilizza la console del flusso di lavoro per monitorare i flussi di lavoro in ritardo o bloccati.

In genere, questi strumenti vengono utilizzati insieme per ottenere un'idea completa delle prestazioni dell'istanza AEM.

Monitoraggio a lungo termine

Il monitoraggio a lungo termine di un'istanza AEM comporta il monitoraggio per un periodo più lungo delle stesse parti monitorate in tempo reale. Include inoltre la definizione di avvisi specifici per l’ambiente.

Aggregazione dei registri e reporting

Sono disponibili diversi strumenti per i registri aggregati, ad esempio Splunk™ e Elastic Search/Logstash/Kabana (ELK). Per valutare il tempo di attività dell’istanza AEM, è importante comprendere gli eventi di registro specifici del sistema e creare avvisi basati su di essi. Una buona conoscenza delle procedure di sviluppo e delle operazioni consente di comprendere meglio come ottimizzare il processo di aggregazione dei log per generare avvisi critici.

Monitoraggio ambientale

Il monitoraggio dell'ambiente include il monitoraggio dei seguenti elementi:

• Velocità effettiva di rete
• IO del disco
• Memoria
• Utilizzo della CPU
• MBeans JMX
• Siti web esterni

Per monitorare ogni elemento sono necessari strumenti esterni, ad esempio NewRelic™ e AppDynamics™. Utilizzando questi strumenti, puoi definire avvisi specifici per il tuo sistema, ad esempio un elevato utilizzo del sistema, un backup del flusso di lavoro, un errore di verifica dello stato o un accesso non autenticato al tuo sito web. L’Adobe non consiglia l’uso di strumenti particolari su altri. Trova lo strumento che funziona per te e lo sfrutta per monitorare gli elementi discussi.

Monitoraggio delle applicazioni interne

Il monitoraggio interno delle applicazioni include il monitoraggio dei componenti dell'applicazione che compongono lo stack AEM, tra cui JVM, l'archivio dei contenuti e il monitoraggio tramite codice dell'applicazione personalizzato generato sulla piattaforma. In generale, viene eseguito tramite JMX Mbeans che può essere monitorato direttamente da molte soluzioni di monitoraggio popolari, come SolarWinds ™, HP OpenView™, Hyperic™, Zabbix™ e altri. Per i sistemi che non supportano una connessione diretta a JMX, è possibile scrivere script di shell per estrarre i dati JMX ed esporli a questi sistemi in un formato che essi comprendono nativamente.

L'accesso remoto ai Mbeans JMX non è abilitato per impostazione predefinita. Per ulteriori informazioni sul monitoraggio tramite JMX, consulta Monitoraggio e gestione utilizzando la tecnologia JMX.

In molti casi, è necessaria una linea di base per monitorare efficacemente una statistica. Per creare una linea di base, osservare il sistema in condizioni di lavoro normali per un periodo predeterminato e quindi identificare la metrica normale.

Monitoraggio JVM

Come per qualsiasi stack di applicazioni basato su Java, AEM dipende dalle risorse che gli vengono fornite tramite la macchina virtuale Java sottostante. Puoi monitorare lo stato di molte di queste risorse tramite Platform MXBeans esposti da JVM. Per ulteriori informazioni su MXBeans, consulta Utilizzo del server MBean e della piattaforma MXBeans.

Di seguito sono riportati alcuni parametri di base che è possibile monitorare per JVM:

Memoria

• MBean: lava.lang:type=Memory
• URL: /system/console/jmx/java.lang:type=Memory
• Istanze: Tutti i server
• Soglia allarme: Quando l'utilizzo della memoria heap o non heap supera il 75% della memoria massima corrispondente.
• Definizione dell'allarme: Memoria di sistema insufficiente o perdita di memoria nel codice. Analizza un dump di thread per arrivare a una definizione.

Nota: Le informazioni fornite da questo fagiolo sono espresse in byte.

Thread

• MBean: java.lang:type=Threading
• URL: /system/console/jmx/java.lang:type=Threading
• Istanze: Tutti i server
• Soglia allarme: Quando il numero di thread è maggiore del 150% della linea di base.
• Definizione dell'allarme: Esiste un processo di runtime attivo o un'operazione inefficiente consuma una grande quantità di risorse. Analizza un dump di thread per arrivare a una definizione.

Monitoraggio AEM

AEM inoltre espone una serie di statistiche e operazioni attraverso JMX. Questi possono aiutare a valutare lo stato di salute del sistema e individuare potenziali problemi prima che influiscano sugli utenti. Per ulteriori informazioni, consulta documentazione su AEM MBeans JMX.

Di seguito sono riportati alcuni parametri di base che è possibile monitorare per AEM:

Agenti di replica

• MBean: com.adobe.granite.replication:type=agent,id=”<AGENT_NAME>”

• URL: /system/console/jmx/com.adobe.granite.replication:type=agent,id="<AGENT_NAME>"

• Istanze: Un autore e tutte le istanze di pubblicazione (per agenti flush)

• Soglia allarme: Quando il valore di QueueBlocked è true o il valore di QueueNumEntries è maggiore del 150% della linea di base.

• Definizione dell'allarme: Presenza di una coda bloccata nel sistema che indica che la destinazione di replica è inattiva o non raggiungibile. Spesso, problemi di rete o di infrastruttura causano la messa in coda di voci eccessive, che possono influire negativamente sulle prestazioni del sistema.

Nota: Per i parametri MBean e URL, sostituisci <AGENT_NAME> con il nome dell'agente di replica che desideri monitorare.

Contatore sessione

• MBean: org.apache.jackrabbit.oak:id=7,name="OakRepository Statistics",type="RepositoryStats"
• URL: /system/console/jmx/org.apache.jackrabbit.oak:id=7,name="Statistiche OakRepository",type="RepositoryStats"
• Istanze: Tutti i server
• Soglia allarme: Quando le sessioni aperte superano la linea di base di oltre il 50%.
• Definizione dell'allarme: Le sessioni possono essere aperte tramite un codice e non possono mai chiudersi. Questo può accadere lentamente nel tempo e alla fine causare perdite di memoria nel sistema. Il numero di sessioni dovrebbe variare su un sistema, ma non dovrebbe aumentare continuamente.

Verifiche stato

I controlli di integrità disponibili nel dashboard delle operazioni dispongono dei MBeans JMX corrispondenti per il monitoraggio. Tuttavia, è possibile scrivere controlli di integrità personalizzati per esporre statistiche di sistema aggiuntive.

Di seguito sono riportati alcuni controlli di integrità predefiniti utili per il monitoraggio:

• Verifiche di sistema

  • MBean: org.apache.sling.healthcheck:name=systemchecks,type=HealthCheck
  • URL: /system/console/jmx/org.apache.sling.health.check:name=systemcheck,type=HealthCheck
  • Istanze: Un autore, tutti i server di pubblicazione
  • Soglia allarme: Quando lo stato non è OK
  • Definizione dell'allarme: Lo stato di una delle metriche è WARN o CRITICAL. Per ulteriori informazioni sulla causa del problema, consulta l’attributo di registro .

• Coda di replica

  • MBean: org.apache.sling.healthcheck:name=replicationQueue,type=HealthCheck
  • URL: /system/console/jmx/org.apache.sling.healthcheck:name=replicationQueue,type=HealthCheck
  • Istanze: Un autore, tutti i server di pubblicazione
  • Soglia allarme: Quando lo stato non è OK
  • Definizione dell'allarme: Lo stato di una delle metriche è WARN o CRITICAL. Controlla l'attributo del registro per ulteriori informazioni sulla coda che ha causato il problema.

• Prestazioni delle risposte

  • MBean: org.apache.sling.healthcheck:name=requestsStatus,type=HealthCheck
  • URL: /system/console/jmx/org.apache.sling.healthcheck:name=requestsStatus,type=HealthCheck
  • Istanze: Tutti i server
  • Durata dell'allarme: Quando lo stato non è OK
  • Definizione dell'allarme: Lo stato di una delle metriche è WARN o CRITICAL. Controlla l'attributo del registro per ulteriori informazioni sulla coda che ha causato il problema.

• Prestazioni delle query

  • MBean: org.apache.sling.healthcheck:name=queriesStatus,type=HealthCheck
  • URL: /system/console/jmx/org.apache.sling.healthcheck:name= queryStatus,type=HealthCheck
  • Istanze: Un autore, tutti i server di pubblicazione
  • Soglia allarme: Quando lo stato non è OK
  • Definizione dell'allarme: Una o più query in esecuzione lenta nel sistema. Per ulteriori informazioni sulle query che hanno causato il problema, consulta l’attributo di registro .

• Bundle attivi

  • MBean: org.apache.sling.health.check:name=inactiveBundles,type=HealthCheck
  • URL: /system/console/jmx/org.apache.sling.healthcheck:name=inactiveBundles,type=HealthCheck
  • Istanze: Tutti i server
  • Soglia allarme: Quando lo stato non è OK
  • Definizione dell'allarme: Presenza di bundle OSGi inattivi o non risolti sul sistema. Controlla l'attributo del registro per ulteriori informazioni sui bundle che hanno causato il problema.

• Errori registro

  • MBean: org.apache.sling.healthcheck:name=logErrorHealthCheck,type=HealthCheck
  • URL: /system/console/jmx/org.apache.sling.healthcheck:name=logErrorHealthCheck,type=HealthCheck
  • Istanze: Tutti i server
  • Soglia allarme: Quando lo stato non è OK
  • Definizione dell'allarme: Ci sono errori nei file di log. Per ulteriori informazioni sulla causa del problema, consulta l’attributo di registro .

Problemi comuni e risoluzioni

Nel processo di monitoraggio, in caso di problemi, ecco alcune attività di risoluzione dei problemi che è possibile eseguire per risolvere i problemi comuni con le istanze AEM:

• Se utilizzi TarMK, esegui spesso la compattazione Tar. Per ulteriori dettagli, vedere Mantenimento del repository.
• Controlla i registri OutOfMemoryError. Per ulteriori informazioni, vedere Analizzare i problemi di memoria.
• Controlla i registri per eventuali riferimenti a query non indicizzate, traversate ad albero o traversate di indici. Ciò indica query non indicizzate o query indicizzate in modo inadeguato. Per le best practice sull’ottimizzazione delle prestazioni di query e indicizzazione, consulta Best practice per query e indicizzazione.
• Utilizza la console del flusso di lavoro per verificare che i flussi di lavoro funzionino come previsto. Se possibile, riduci più flussi di lavoro in un unico flusso di lavoro.
• Rivedere il monitoraggio live e cercare ulteriori strozzature o un elevato numero di consumatori di risorse specifiche.
• Indagare i punti di uscita dalla rete client e i punti di ingresso alla rete di istanze AEM, incluso il dispatcher. Spesso si tratta di aree a collo di bottiglia. Per ulteriori informazioni, consulta Considerazioni sulla rete Assets.
• Aggiorna il server AEM. Potresti avere una dimensione insufficiente della tua istanza AEM. L’Assistenza clienti Adobe può aiutarti a identificare se il server è di dimensioni inferiori.
• Esamina i file access.log e error.log per verificare la presenza di voci nel momento in cui si è verificato un errore. Cerca pattern che possano indicare anomalie nel codice personalizzato. Aggiungili all’elenco degli eventi monitorati.