Documentazione di Oracle Cloud Infrastructure

Provisioning e distribuzione dell'agente Java APM su Oracle E-Business Suite

Il monitoraggio APM richiede la distribuzione dell'agente Java APM per acquisire le operazioni eseguite sul server WebLogic. In questo caso, ciò deve avvenire nei cluster oacore e oafm WebLogic.

Scaricare l'agente Java APM

  1. Accedi alla console di Oracle Cloud Infrastructure.
  2. Aprire il menu di navigazione e fare clic su Osservabilità e gestione. In Application Performance Monitoring fare clic su Amministrazione.
  3. Nella pagina Amministrazione fare clic su Scarica agenti APM dal menu a sinistra per aprire la pagina Scarica agenti APM.
  4. Nella pagina Scarica agenti APM selezionare Agente Java per scaricare l'agente Java APM.

    Il file software dell'agente Java APM viene scaricato e contiene il file apm-java-agent-installer-<version>.jar.

Eseguire il provisioning dell'agente Java APM

  1. Connettersi all'host in cui è installato l'Application Server, eseguire il login come lo stesso utente che ha installato l'Application Server e confermare che l'utente dell'Application Server dispone delle autorizzazioni di lettura e scrittura nella directory in cui viene scaricato il file dell'agente Java APM. Copiare il file software dell'agente Java APM scaricato in una directory qualsiasi:
  2. Assicurarsi di aver eseguito il login come utente che ha installato l'Application Server e di passare alla directory in cui è stato copiato il software dell'agente Java APM. Tenere presente che è necessario disporre delle autorizzazioni di lettura e scrittura nella directory che ospita l'agente Java APM.
  3. Rivedere i seguenti argomenti obbligatori che devono essere specificati per eseguire il provisioning di un agente Java APM.
    • -service-name: il nome del servizio monitorato. Questo argomento consente di filtrare per servizio e visualizzare i trace nell'interfaccia utente di Trace Explorer. Per l'ambiente EBS, utilizzare EBS_WLS come valore temporaneo. Successivamente, eseguirà l'override della configurazione con valori specifici per ciascuno dei cluster WLS monitorati.
    • -destination: la directory di destinazione in cui verrà eseguito il provisioning dell'agente Java APM. In questo caso, questo dovrebbe puntare alla directory di destinazione EBS: <PATH_TO_fs_ne> , che è il percorso completo EBS per la directory non edizione. Ad esempio: directory /u01/ebs122/fs_ne/.
    • -private-data-key: la chiave di installazione dell'agente utilizzata dagli agenti Java APM (chiave dati privata), generata al momento della creazione del dominio APM.
    • -data-upload-endpoint: l'URL dataUploadEndpoint generato quando viene creato il dominio APM.

      Per ulteriori informazioni sulla chiave dati privata e dataUploadEndpoint, vedere Ottenere l'endpoint e le chiavi dati di caricamento dati.

    Facoltativo:

    • È possibile specificare argomenti aggiuntivi durante il provisioning dell'agente Java APM. Per informazioni, vedere Specificare gli argomenti proxy.

    • È possibile eseguire il comando seguente per visualizzare la Guida sugli argomenti provision-agent:
      java -jar ./apm-java-agent-installer-<version>.jar provision-agent -help
  4. Eseguire il provisioning dell'agente specificando gli argomenti obbligatori descritti nel passo precedente ed eseguendo il seguente comando java:
    java -jar ./apm-java-agent-installer-<version>.jar provision-agent -service-name=EBS_WLS -destination=/u01/ebs122/fs_ne/ -private-data-key=<Agent installation key generated during APM domain creation> -data-upload-endpoint=<dataUploadEndpoint URL generated during APM domain creation>

    Di seguito viene fornito un esempio.

    java -jar ./apm-java-agent-installer-1.1.jar provision-agent -service-name=apm_service -destination=$DOMAIN_HOME -private-data-key=IMWJ5UN2C6YOLQSUZ5Q7IGN3QACF4AZD -data-upload-endpoint=https://dataUploadEndpoint.com
    Quando si esegue il comando java, se il provisioning dell'agente Java APM è riuscito:
    • Viene visualizzato il messaggio Action [provision-agent] completed successfully.
    • La directory oracle-apm-agent viene creata nella directory di destinazione. Ad esempio, /u01/ebs122/fs_ne/oracle-apm-agent.

      La directory oracle-apm-agent deve contenere quanto segue:

      • bin: contiene l'inizio dell'aggregatore.
      • bootstrap: contiene i file .jar di avvio dell'agente che verranno utilizzati dal comando -javaagent per distribuire l'agente Java APM.
      • config: contiene i file di configurazione globali che possono essere modificati. Questa directory contiene:
        • Il file AgentConfig.properties, che contiene gli argomenti di configurazione dell'agente Java APM.
        • Il file ProbeConfig.acml, che contiene le informazioni di configurazione relative alle sonde.
      • install: contiene la directory <release-version>/config contenente i file binari dell'agente Java APM e i file di configurazione predefiniti. Tenere presente che i file in questa directory non devono essere modificati.
      • version: il file di versione contenente informazioni sulla versione e sulla data di attivazione dell'agente Java APM.

    Se il comando java termina e il provisioning dell'agente Java APM non viene eseguito correttamente, è possibile esaminare i dettagli dell'errore nel file ApmAgentInstall.log e nel log di output dell'Application Server per risolvere il problema.

Nota

Per ulteriori dettagli sul download e il provisioning dell'agente Java APM, vedere Provisioning e distribuzione dell'agente Java APM sugli Application Server.

Abilitare l'agente Java APM nel server gestito WebLogic

Per abilitare l'accesso a Oracle E-Business Suite da Oracle Application Performance Monitoring, è necessario apportare modifiche alla configurazione JVM ai server gestiti WebLogic.

Eseguire i passi riportati di seguito su ciascuno dei server gestiti dei servizi oacore e oafm.

  1. Eseguire il login alla console di amministrazione del server WebLogic come utente con ruolo di sicurezza amministratore. Per impostazione predefinita, si tratta dell'utente weblogic.
  2. Fare clic su Server. Viene visualizzata la pagina di riepilogo del server di amministrazione e dei server gestiti WebLogic.
  3. Scegliere i server gestiti WebLogic su cui distribuire l'agente Java APM: oacore e oafm.
  4. Viene visualizzata una pagina contenente varie schede per le impostazioni del server gestito.

    Fare clic sulla scheda Avvio server.

  5. Nel centro modifiche, fare clic su Blocca e modifica. Aggiornare il campo Argomenti con i parametri necessari per Oracle Application Performance Monitoring. Assicurarsi che gli argomenti esistenti non vengano modificati.

    Per il servizio oacore, aggiungere quanto segue: 

    -javaagent:<PATH_TO_fs_ne>/oracle-apm-agent/bootstrap/ApmAgent.jar -Dcom.oracle.apm.agent.service.name=oacore

    Per il servizio oafm, aggiungere quanto segue: 

    -javaagent:<PATH_TO_fs_ne>/oracle-apm-agent/bootstrap/ApmAgent.jar -Dcom.oracle.apm.agent.service.name=oafm
  6. Fare clic su Salva.
  7. Nel Centro modifiche fare clic su Attiva modifiche per attivare le modifiche.
  8. Ripetere tutti i passi precedenti per ciascuno dei server gestiti dei servizi oacore e oafm finché a ogni server gestito non vengono aggiornati gli argomenti JVM.
  9. Riavviare i server gestiti utilizzando lo script disponibile in $ADMIN_SCRIPTS_HOME nell'ambiente Oracle E-Business Suite per arrestare e avviare i server gestiti.

Dopo aver installato correttamente un agente APM, è possibile abilitare il monitoraggio dell'utente finale in un ambiente Oracle E-Business Suite configurando gli agenti del browser con il tipo di inserimento riferimento per gli agenti APM correlati ai server gestiti oacore.