Azure Uygulaması Hizmeti'nde Tomcat, JBoss veya Java SE uygulamaları için APM platformlarını yapılandırma

Makale
11/12/2024

Bu makalede, Azure Uygulaması Hizmetinde dağıtılan Java uygulamalarının Azure İzleyici Application Insights, NewRelic ve AppDynamics uygulama performansı izleme (APM) platformlarına nasıl bağlanılacağı gösterilmektedir.

Azure Uygulaması Hizmeti, tam olarak yönetilen bir hizmette Java web uygulamalarını üç farklı şekilde çalıştırır:

Java SE - Eklenmiş bir sunucu (Spring Boot, Dropwizard, Quarkus gibi) veya katıştırılmış Tomcat veya Jetty sunucusu içeren bir JAR paketi olarak dağıtılan bir uygulamayı çalıştırabilir.
Tomcat - Yerleşik Tomcat sunucusu WAR paketi olarak dağıtılan bir uygulamayı çalıştırabilir.
JBoss EAP - Yalnızca Ücretsiz, Premium v3 ve Yalıtılmış v2 fiyatlandırma katmanlarında Linux uygulamaları için desteklenir. Yerleşik JBoss EAP sunucusu WAR veya EAR paketi olarak dağıtılan bir uygulamayı çalıştırabilir.

Application Insights'ı Yapılandırma

Azure İzleyici Application Insights, müşterilerin uygulama performansını geliştirmek ve ortalama çözüm süresini (MTTR) azaltmak için hataları, performans sorunlarını ve kullanım düzenlerini gözlemlemesini sağlayan buluta özel bir uygulama izleme hizmetidir. Birkaç tıklama veya CLI komutuyla Node.js veya Java uygulamalarınız için izlemeyi etkinleştirebilir, günlükleri, ölçümleri ve dağıtılmış izlemeleri otomatik olarak toplayarak uygulamanıza SDK ekleme gereksinimini ortadan kaldırabilirsiniz. Aracıyı yapılandırmaya yönelik kullanılabilir uygulama ayarları hakkında daha fazla bilgi için Application Insights belgelerine bakın.

Azure portalı
Azure CLI

Azure portalından Application Insights'ı etkinleştirmek için sol taraftaki menüde Application Insights'a gidin ve Application Insights'ı aç'ı seçin. Varsayılan olarak, web uygulamanızla aynı ada sahip yeni bir application insights kaynağı kullanılır. Mevcut bir application insights kaynağını kullanmayı veya adı değiştirmeyi seçebilirsiniz. Alttaki Uygula'yı seçin.

Azure CLI aracılığıyla etkinleştirmek için bir Application Insights kaynağı oluşturmanız ve Application Insights'ı web uygulamanıza bağlamak için Azure portalında birkaç uygulama ayarı yapmanız gerekir.

Applications Insights uzantısını etkinleştirme
```
az extension add -n application-insights
```
Aşağıdaki CLI komutunu kullanarak bir Application Insights kaynağı oluşturun. Yer tutucuları istediğiniz kaynak adı ve grubuyla değiştirin.
```
az monitor app-insights component create --app <resource-name> -g <resource-group> --location westus2  --kind web --application-type web
```
ve instrumentationKeydeğerlerini connectionString not edin. Sonraki adımda bu değerlere ihtiyacınız olacaktır.

Not

Diğer konumların listesini almak için komutunu çalıştırın az account list-locations.

İzleme anahtarını, bağlantı dizesi ve izleme aracısı sürümünü web uygulamasında uygulama ayarları olarak ayarlayın. ve <connectionString> değerlerini önceki adımdaki değerlerle değiştirin<instrumentationKey>.

Linux
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"

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"

Not

En son New Relic belgelerinde 7.x'e kadar JBoss EAP desteği listelenmiştir . JBoss EAP 8.x henüz desteklenmiyor.

NewRelic.com'de NewRelic hesabı oluşturma
NewRelic'ten Java aracısını indirin.
Lisans anahtarınızı kopyalayın, aracıyı daha sonra yapılandırmak için bu anahtara ihtiyacınız vardır.
App Service örneğinize SSH girin ve yeni bir dizin oluşturun /home/site/wwwroot/apm.
Paketlenmemiş NewRelic Java aracı dosyalarını /home/site/wwwroot/apm altındaki bir dizine yükleyin. Aracınızın dosyaları /home/site/wwwroot/apm/newrelic konumunda olmalıdır.
/home/site/wwwroot/apm/newrelic/newrelic.yml adresinde YAML dosyasını değiştirin ve yer tutucu lisans değerini kendi lisans anahtarınızla değiştirin.
Azure portalında App Service'te uygulamanıza göz atın ve yeni bir Uygulama Ayarı oluşturun.

değeriyle -javaagent:/home/site/wwwroot/apm/newrelic/newrelic.jaradlı JAVA_OPTS bir ortam değişkeni oluşturun.

değeriyle -javaagent:/home/site/wwwroot/apm/newrelic/newrelic.jaradlı CATALINA_OPTS bir ortam değişkeni oluşturun.

NewRelic.com'de NewRelic hesabı oluşturma
NewRelic'ten Java aracısını indirin. newrelic-java-x.x.x.zip benzer bir dosya adına sahiptir.
Lisans anahtarınızı kopyalayın, aracıyı daha sonra yapılandırmak için bu anahtara ihtiyacınız vardır.
App Service örneğinize SSH girin ve yeni bir dizin oluşturun /home/site/wwwroot/apm.
Paketlenmemiş NewRelic Java aracı dosyalarını /home/site/wwwroot/apm altındaki bir dizine yükleyin. Aracınızın dosyaları /home/site/wwwroot/apm/newrelic konumunda olmalıdır.
/home/site/wwwroot/apm/newrelic/newrelic.yml adresinde YAML dosyasını değiştirin ve yer tutucu lisans değerini kendi lisans anahtarınızla değiştirin.
Azure portalında App Service'te uygulamanıza göz atın ve yeni bir Uygulama Ayarı oluşturun.

değeriyle -javaagent:/home/site/wwwroot/apm/newrelic/newrelic.jaradlı JAVA_OPTS bir ortam değişkeni oluşturun.

değeriyle -javaagent:/home/site/wwwroot/apm/newrelic/newrelic.jaradlı CATALINA_OPTS bir ortam değişkeni oluşturun.

Not

için JAVA_OPTSzaten bir ortam değişkeniniz varsa, geçerli değerin sonuna seçeneğini ekler -javaagent:/... .

Not

için CATALINA_OPTSzaten bir ortam değişkeniniz varsa, geçerli değerin sonuna seçeneğini ekler -javaagent:/... .

AppDynamics'i yapılandırma

Linux
Windows

AppDynamics.com'de AppDynamics hesabı oluşturma
AppDynamics web sitesinden Java aracısını indirin. Dosya adı AppServerAgent-x.x.x.xxxxx.zip benzer
App Service örneğinize SSH girin ve yeni bir dizin oluşturun /home/site/wwwroot/apm.
Java aracı dosyalarını /home/site/wwwroot/apm altındaki bir dizine yükleyin. Aracınızın dosyaları /home/site/wwwroot/apm/appdynamics içinde olmalıdır.
Azure portalında App Service'te uygulamanıza göz atın ve yeni bir Uygulama Ayarı oluşturun.

Adlı bir ortam değişkeni JAVA_OPTS-javaagent:/home/site/wwwroot/apm/appdynamics/javaagent.jar -Dappdynamics.agent.applicationName=<app-name> oluşturun ve burada <app-name> App Service adınızdır. için JAVA_OPTSzaten bir ortam değişkeniniz varsa, geçerli değerin sonuna seçeneğini ekler -javaagent:/... .

Adlı bir ortam değişkeni CATALINA_OPTS-javaagent:/home/site/wwwroot/apm/appdynamics/javaagent.jar -Dappdynamics.agent.applicationName=<app-name> oluşturun ve burada <app-name> App Service adınızdır. için CATALINA_OPTSzaten bir ortam değişkeniniz varsa, geçerli değerin sonuna seçeneğini ekler -javaagent:/... .

AppDynamics.com'de AppDynamics hesabı oluşturma
AppDynamics web sitesinden Java aracısını indirin. Dosya adı AppServerAgent-x.x.x.xxxxx.zip benzer
Kudu konsolunu kullanarak yeni bir dizin /home/site/wwwroot/apm oluşturun.
Java aracı dosyalarını /home/site/wwwroot/apm altındaki bir dizine yükleyin. Aracınızın dosyaları /home/site/wwwroot/apm/appdynamics içinde olmalıdır.
Azure portalında App Service'te uygulamanıza göz atın ve yeni bir Uygulama Ayarı oluşturun.

Adlı bir ortam değişkeni JAVA_OPTS-javaagent:/home/site/wwwroot/apm/appdynamics/javaagent.jar -Dappdynamics.agent.applicationName=<app-name> oluşturun ve burada <app-name> App Service adınızdır. için JAVA_OPTSzaten bir ortam değişkeniniz varsa, geçerli değerin sonuna seçeneğini ekler -javaagent:/... .

Adlı bir ortam değişkeni CATALINA_OPTS-javaagent:/home/site/wwwroot/apm/appdynamics/javaagent.jar -Dappdynamics.agent.applicationName=<app-name> oluşturun ve burada <app-name> App Service adınızdır. için CATALINA_OPTSzaten bir ortam değişkeniniz varsa, geçerli değerin sonuna seçeneğini ekler -javaagent:/... .

Datadog'ı yapılandırma

Linux
Windows

Yapılandırma seçenekleri, kuruluşunuzun hangi Datadog sitesini kullandığına bağlı olarak farklıdır. Azure için Resmi Datadog Tümleştirme belgelerine bakın

Dynatrace'ı yapılandırma

Linux
Windows

Dynatrace bir Azure Native Dynatrace Hizmeti sağlar. Dynatrace kullanarak Azure Uygulaması Hizmetlerini izlemek için Azure için resmi Dynatrace belgelerine bakın

Sonraki adımlar

Azure hızlı başlangıçları, öğreticileri ve Java başvuru belgelerini bulmak için Java geliştiricileri için Azure merkezini ziyaret edin.

Aracılığıyla paylaş