Verifica distribuzione agente Java APM

È possibile verificare se la distribuzione dell'agente Java APM è riuscita controllando l'interfaccia utente ed esaminando i log.

Controllo dell'interfaccia utente: Trace Explorer

Dopo aver distribuito correttamente l'agente Java APM, è possibile passare a Trace Explorer e verificare se i dati di trace dell'Application Server vengono caricati. Per informazioni, vedere Monitorare i trace in Trace Explorer.

Esaminare i log dell'agente Java APM

Dopo la distribuzione di un agente Java APM, viene creata una nuova directory log in <Destination Directory>/oracle-apm-agent. Si noti che <Destination Directory> è il punto in cui viene eseguito il provisioning dell'agente Java APM, ad esempio $DOMAIN_HOME per Oracle WebLogic Server.

Per verificare se la distribuzione dell'agente Java APM è riuscita, effettuare le operazioni riportate di seguito.

  1. Verificare che la directory log venga creata eseguendo il comando seguente:
    cd <Destination Directory>/oracle-apm-agent
    ls -l
  2. Verificare che la directory log contenga i seguenti file di log:
    • AgentErrors.log
    • Agent.log
    • AgentStartup.log
    • AgentStatus.log

    Tenere presente che se non sono stati creati tutti i file di log previsti, la distribuzione dell'agente Java APM non è riuscita.

  3. Aprire il file AgentStartup.log e verificare che venga visualizzato il seguente messaggio:

    Agent successfully initialized

  4. Cercare l'attività dell'agente nel file AgentStatus.log.

    Quando l'agente Java APM inizia a raccogliere e caricare i dati di trace in Application Performance Monitoring, registra brevi messaggi di stato nel file AgentStatus.log. Ciò indica che l'agente Java APM è attivo.

Se i passi di verifica di cui sopra non riescono, verificare che il processo in esecuzione per il server applicazioni disponga di javaagent nella riga di comando.

Ad esempio, eseguire il comando riportato di seguito per elencare il processo del server applicazioni con l'agente APM:
ps -ef | grep ApmAgent
Se il comando precedente non elenca il processo dell'applicazione, assicurarsi che qualsiasi variabile di ambiente non sostituisca le opzioni di avvio di Application Server. Ad esempio: se si utilizza Apache Tomcat, assicurarsi che CATALINA_OPTS non venga sostituito altrove tramite setenv.sh o qualsiasi impostazione esterna.