Configurare le piattaforme APM per le app Tomcat, JBoss o Java SE nel servizio app di Azure

Questo articolo illustra come connettere le applicazioni Java distribuite nel Servizio app di Azure con le piattaforme di monitoraggio delle prestazioni applicative Application Insights di Monitoraggio di Azure, NewRelic e AppDynamics.

Il servizio app di Azure esegue applicazioni Web Java in un servizio completamente gestito in tre varianti:

• Java SE: può eseguire un'app distribuita come pacchetto JAR che contiene un server incorporato (ad esempio Spring Boot, Dropwizard, Quarkus o uno con un server Tomcat o Jetty incorporato).
• Tomcat: il server Tomcat predefinito può eseguire un'app distribuita come pacchetto WAR.
• JBoss EAP: supportato per le app Linux solo nei piani tariffari Gratuito, Premium v3 e Isolato v2. Il server JBoss EAP predefinito può eseguire un'app distribuita come pacchetto WAR o EAR.

Nota

Per le applicazioni Spring, è consigliabile usare Azure Spring Apps. Tuttavia, è comunque possibile usare il Servizio app di Azure come destinazione. Per consigli, vedere Indicazioni sulla destinazione del carico di lavoro Java.

Configurare Application Insights

Application Insights di Monitoraggio di Azure è un servizio di monitoraggio delle applicazioni nativo del cloud che consente ai clienti di osservare errori, colli di bottiglia e modelli di utilizzo per migliorare le prestazioni dell'applicazione e ridurre il tempo medio di risoluzione (MTTR). Con pochi clic o comandi dell'interfaccia della riga di comando, è possibile abilitare il monitoraggio per le app Node.js o Java, la raccolta automatica di log, metriche e tracce distribuite, eliminando la necessità di includere un SDK nell'app. Per altre informazioni sulle impostazioni dell'app disponibili per la configurazione dell'agente, vedere la documentazione di Application Insights.

Azure portal

Per abilitare Application Insights dal portale di Azure, passare ad Application Insights nel menu a sinistra e selezionare Attiva Application Insights. Per impostazione predefinita, viene usata una nuova risorsa di Application Insights con lo stesso nome dell'app Web. È possibile scegliere di usare una risorsa di Application Insights esistente o modificare il nome. Selezionare Applica nella parte inferiore.

Interfaccia della riga di comando di Azure

Per abilitare tramite l'interfaccia della riga di comando di Azure, è necessario creare una risorsa di Application Insights e impostare un paio di impostazioni dell'app nel portale di Azure per connettere Application Insights all'app Web.

1. Abilitare l'estensione Application Insights

   az extension add -n application-insights
   

2. Creare una risorsa di Application Insights usando il comando dell'interfaccia della riga di comando. Sostituire i segnaposto con i gruppi e i nomi di risorsa desiderati.

   az monitor app-insights component create --app <resource-name> -g <resource-group> --location westus2  --kind web --application-type web
   

   Si notino i valori per connectionString e instrumentationKey, questi valori saranno necessari nel passaggio successivo.

   Nota

   Per recuperare un elenco di altri percorsi, eseguire az account list-locations.

3. Impostare la chiave di strumentazione, la stringa di connessione e la versione dell'agente di monitoraggio come impostazioni dell'app nell'app Web. Sostituire <instrumentationKey> e <connectionString> con i valori del passaggio precedente.

   Linux

   az webapp config appsettings set -n <webapp-name> -g <resource-group> --settings "APPINSIGHTS_INSTRUMENTATIONKEY=<instrumentationKey>" "APPLICATIONINSIGHTS_CONNECTION_STRING=<connectionString>" "ApplicationInsightsAgent_EXTENSION_VERSION=~3" "XDT_MicrosoftApplicationInsights_Mode=default"
   

   Windows

   az webapp config appsettings set -n <webapp-name> -g <resource-group> --settings "APPINSIGHTS_INSTRUMENTATIONKEY=<instrumentationKey>" "APPLICATIONINSIGHTS_CONNECTION_STRING=<connectionString>" "ApplicationInsightsAgent_EXTENSION_VERSION=~3" "XDT_MicrosoftApplicationInsights_Mode=default" "XDT_MicrosoftApplicationInsights_Java=1"
   

Configurare New Relic

Linux

Nota

La documentazione più recente di New Relic elenca il supporto di JBoss EAP fino a 7.x. JBoss EAP 8.x non è ancora supportato.

1. Creare un account NewRelic in NewRelic.com

2. Scaricare l'agente Java da NewRelic.

3. Copiare il codice di licenza, necessario per configurare l'agente in un secondo momento.

4. Usare SSH per connettersi all'istanza del Servizio app di Azure e creare una nuova directory /home/site/wwwroot/apm.

5. Caricare i file dell'agente Java NewRelic decompressi in una directory in /home/site/wwwroot/apm. I file per l'agente devono trovarsi in /home/site/wwwroot/apm/newrelic.

6. Modificare il file YAML in /home/site/wwwroot/apm/newrelic/newrelic.yml e sostituire il valore della licenza segnaposto con il proprio codice di licenza.

7. Nel portale di Azure passare all'applicazione nel servizio app e creare una nuova impostazione dell'applicazione.

   Creare una variabile di ambiente denominata JAVA_OPTS con il valore -javaagent:/home/site/wwwroot/apm/newrelic/newrelic.jar.

   Creare una variabile di ambiente denominata CATALINA_OPTS con il valore -javaagent:/home/site/wwwroot/apm/newrelic/newrelic.jar.

Windows

1. Creare un account NewRelic in NewRelic.com

2. Scaricare l'agente Java da NewRelic. Ha un nome di file simile a newrelic-java-x.x.x.zip.

3. Copiare il codice di licenza, necessario per configurare l'agente in un secondo momento.

4. Usare SSH per connettersi all'istanza del Servizio app di Azure e creare una nuova directory /home/site/wwwroot/apm.

5. Caricare i file dell'agente Java NewRelic decompressi in una directory in /home/site/wwwroot/apm. I file per l'agente devono trovarsi in /home/site/wwwroot/apm/newrelic.

6. Modificare il file YAML in /home/site/wwwroot/apm/newrelic/newrelic.yml e sostituire il valore della licenza segnaposto con il proprio codice di licenza.

7. Nel portale di Azure passare all'applicazione nel servizio app e creare una nuova impostazione dell'applicazione.

   Creare una variabile di ambiente denominata JAVA_OPTS con il valore -javaagent:/home/site/wwwroot/apm/newrelic/newrelic.jar.

   Creare una variabile di ambiente denominata CATALINA_OPTS con il valore -javaagent:/home/site/wwwroot/apm/newrelic/newrelic.jar.

Nota

Se si dispone già di una variabile di ambiente per JAVA_OPTS, aggiungere l'opzione -javaagent:/... alla fine del valore corrente.

Nota

Se si dispone già di una variabile di ambiente per CATALINA_OPTS, aggiungere l'opzione -javaagent:/... alla fine del valore corrente.

Configurare AppDynamics

Linux

1. Creare un account AppDynamics in AppDynamics.com

2. Scaricare l'agente Java dal sito Web AppDynamics. Il nome del file è simile a AppServerAgent-x.x.x.xxxxx.zip

3. Usare SSH per connettersi all'istanza del Servizio app di Azure e creare una nuova directory /home/site/wwwroot/apm.

4. Caricare i file dell'agente Java decompressi in una directory in /home/site/wwwroot/apm. I file per l'agente devono trovarsi in /home/site/wwwroot/apm/appdynamics.

5. Nel portale di Azure passare all'applicazione nel servizio app e creare una nuova impostazione dell'applicazione.

   Creare una variabile di ambiente denominata JAVA_OPTS con il valore -javaagent:/home/site/wwwroot/apm/appdynamics/javaagent.jar -Dappdynamics.agent.applicationName=<app-name> in cui <app-name> è il nome del servizio app. Se si dispone già di una variabile di ambiente per JAVA_OPTS, aggiungere l'opzione -javaagent:/... alla fine del valore corrente.

   Creare una variabile di ambiente denominata CATALINA_OPTS con il valore -javaagent:/home/site/wwwroot/apm/appdynamics/javaagent.jar -Dappdynamics.agent.applicationName=<app-name> in cui <app-name> è il nome del servizio app. Se si dispone già di una variabile di ambiente per CATALINA_OPTS, aggiungere l'opzione -javaagent:/... alla fine del valore corrente.

Windows

1. Creare un account AppDynamics in AppDynamics.com

2. Scaricare l'agente Java dal sito Web AppDynamics. Il nome del file è simile a AppServerAgent-x.x.x.xxxxx.zip

3. Usare la console Kudu per creare una nuova directory /home/site/wwwroot/apm.

4. Caricare i file dell'agente Java decompressi in una directory in /home/site/wwwroot/apm. I file per l'agente devono trovarsi in /home/site/wwwroot/apm/appdynamics.

5. Nel portale di Azure passare all'applicazione nel servizio app e creare una nuova impostazione dell'applicazione.

   Creare una variabile di ambiente denominata JAVA_OPTS con il valore -javaagent:/home/site/wwwroot/apm/appdynamics/javaagent.jar -Dappdynamics.agent.applicationName=<app-name> in cui <app-name> è il nome del servizio app. Se si dispone già di una variabile di ambiente per JAVA_OPTS, aggiungere l'opzione -javaagent:/... alla fine del valore corrente.

   Creare una variabile di ambiente denominata CATALINA_OPTS con il valore -javaagent:/home/site/wwwroot/apm/appdynamics/javaagent.jar -Dappdynamics.agent.applicationName=<app-name> in cui <app-name> è il nome del servizio app. Se si dispone già di una variabile di ambiente per CATALINA_OPTS, aggiungere l'opzione -javaagent:/... alla fine del valore corrente.

Configurare Datadog

Linux

Le opzioni di configurazione sono diverse a seconda del sito Datadog usato dall'organizzazione. Vedere la documentazione ufficiale sull'integrazione di Datadog per Azure

Windows

Le opzioni di configurazione sono diverse a seconda del sito Datadog usato dall'organizzazione. Vedere la documentazione ufficiale sull'integrazione di Datadog per Azure

Configurare Dynatrace

Linux

Dynatrace offre un servizio Dynatrace nativo di Azure. Per monitorare i Servizi app di Azure con Dynatrace, vedere la documentazione ufficiale di Dynatrace per Azure

Windows

Dynatrace offre un servizio Dynatrace nativo di Azure. Per monitorare i Servizi app di Azure con Dynatrace, vedere la documentazione ufficiale di Dynatrace per Azure

Passaggi successivi

Per trovare guide introduttive di Azure, esercitazioni e documentazione di riferimento su Java, visitare la pagina Azure per sviluppatori Java.

• Domande frequenti sul Servizio app di Azure in Linux
• Informazioni di riferimento sulle variabili di ambiente e impostazioni dell'app