Monitoraggio delle distribuzioni dei moduli AEM

Puoi monitorare le distribuzioni dei moduli AEM sia a livello di sistema che a livello interno. Puoi utilizzare strumenti di gestione specializzati come HP OpenView, IBM® Tivoli e CA UniCenter e un monitor JMX di terze parti denominato JConsole per monitorare in modo specifico l’attività Java™. L’implementazione di una strategia di monitoraggio migliora la disponibilità, l’affidabilità e le prestazioni delle implementazioni dei moduli AEM.

Monitoraggio tramite MBean

AEM Forms fornisce due MBean registrati che forniscono informazioni di navigazione e statistiche. Queste parti sono le uniche MBean supportate per l'integrazione e l'ispezione:

ServiceStatistic: Questo MBean fornisce informazioni sul nome del servizio e sulla relativa versione.
Statistica operazione: Questo MBean fornisce le statistiche del servizio di ogni server AEM Forms. In questo MBean gli amministratori possono ottenere informazioni su un particolare servizio, ad esempio il tempo di chiamata e il numero di errori.

Interfacce pubbliche ServiceStatisticMbean

È possibile accedere alle seguenti interfacce pubbliche di ServiceStatistic MBean a scopo di test:

 public String getServiceId();
 public int getMajorVersion();
 public int getMinorVersion();

Interfacce pubbliche OperationStatisticMbean

È possibile accedere alle seguenti interfacce pubbliche di OperationStatistic MBean a scopo di test:

 // InvocationCount: The number of times the method is invoked.
 public long getInvocationCount();
 // InvocationStartTime: The time at which the method started to execute.
 public long getInvocationStartTime();
 // InvocationEndTime: The time at which the method finished execution.
 public long getInvocationEndTime();
 // InvocationTime: The time taken for the execution of the method.
 public long getInvocationTime();
 // LastSamplingDateTime: Convert InvocationStartTime to a formatted string
 public String getLastSamplingDateTime();
 // MaxInvocationTime: The maximum time taken for the execution of the method.
 public long getMaxInvocationTime();
 // MinInvocationTime: The minimum time taken for the execution of the method.
 public long getMinInvocationTime();
 // AverageInvocationTime: the averege execution time taken for the execution of the method.
 public double getAverageInvocationTime();
 // ExceptionCount: The number of times the method has thrown an Exception.
 public long getExceptionCount();
 // ExceptionMessage: The message of the last exception occurred.
 public String getExeptionMessage();
 public void setExceptionMessage(String errorMessage);

Statistiche operazioni e struttura MBean

Utilizzando una console JMX (JConsole), sono disponibili le statistiche di OperationStatistic MBean. Queste statistiche sono attributi di MBean e possono essere visualizzate nella seguente struttura gerarchica:

Struttura MBean

Nome dominio Adobe: Dipende dal server applicazioni. Se il server applicazioni non definisce il dominio, l'impostazione predefinita è adobe.com.

Tipo servizio: AdobeService è il nome utilizzato per elencare tutti i servizi.

AdobeServiceName: Nome servizio o ID servizio.

Versione: Versione del servizio.

Statistiche operazione

Tempo di chiamata: Tempo impiegato per l’esecuzione del metodo. Questa chiamata non include l'ora in cui la richiesta viene serializzata, trasferita dal client al server e deserializzata.

Conteggio richiami: Il numero di volte in cui il servizio viene richiamato.

Tempo medio di chiamata: Tempo medio di tutte le chiamate eseguite dall'avvio del server.

Tempo massimo di chiamata: La durata della chiamata più lunga eseguita dall'avvio del server.

Tempo minimo di chiamata: La durata della chiamata più breve eseguita dall'avvio del server.

Conteggio eccezioni: Numero di chiamate che hanno generato errori.

Messaggio eccezione: Messaggio di errore dell'ultima eccezione verificatasi.

Data e ora ultimo campionamento: Data dell'ultima chiamata.

Unità di tempo: Il valore predefinito è millisecondi.

Per abilitare il monitoraggio JMX, in genere i server applicazioni richiedono una certa configurazione. Per informazioni dettagliate, consulta la documentazione del server applicazioni.

Esempi di come impostare l’accesso aperto JMX

JBoss® 4.0.3/4.2.0 - configurare l’avvio di JVM

Per visualizzare MBean da JConsole, configurare i parametri di avvio JVM del server applicazioni JBoss. Assicurati che JBoss sia avviato dal file run.bat/sh.

Modifica il file run.bat che si trova in InstallJBoss/bin.

Trova la riga JAVA_OPTS e aggiungi quanto segue:

 -Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.port=9088 -Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false

WebLogic 9.2 /10 - configurare l'avvio JVM

Modifica il file startWebLogic.bat che si trova in [WebLogic home]/user_projects/domains/Adobe_Live_Cycle/bin.

Trova la riga JAVA_OPTS e aggiungi quanto segue:

 -Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.port=9088 -Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false

Riavviare WebLogic.

NOTA

Per WebLogic, è possibile accedere a MBean utilizzando remoto o IIOP.

Accesso remoto a MBean

Avviare JConsole per la nuova connessione e fare clic sulla scheda remota.
Immetti il nome host e la porta (9088, il numero specificato durante le opzioni di avvio di JVM).

WebSphere® 6.1 - configurazione dell'avvio di JVM

Nell’Admin Console (Server applicazioni > server1 > Definizione processo > JVM), aggiungi la seguente riga al campo Argomento JVM generico:
```
 -Djavax.management.builder.initial= -Dcom.sun.management.jmxremote
```
Aggiungi o rimuovi il commento dalle tre righe seguenti nel file /opt/IBM/WebSphere/AppServer/java/jre/lib/management/management.properties (oppure <your websphere="" jre="">/ lib/management/management.properties):
```
 com.sun.management.jmxremote.port=9999 //any port you like, but make sure you use this port when you connect
 com.sun.management.jmxremote.authenticate=false
 com.sun.management.jmxremote.ssl=false
```
Riavviare WebSphere.