在 Azure App Service 中設定 Tomcat、JBoss 或 Java SE 應用程式的 APM 平台

本文說明如何將部署在 Azure App Service 上的 Java 應用程式，與 Azure 監視器 Application Insights、NewRelic 和 AppDynamics 應用程式效能監視 (APM) 平台連線。

Azure App Service 會以三種變體在完全受控的服務上執行 Java Web 應用程式：

• Java SE - 可以執行部署為包含內嵌伺服器的 JAR 套件的應用程式 (例如 Spring Boot、Dropwizard、Quarkus 或具有內嵌 Tomcat 或 Jetty 伺服器的應用程式)。
• Tomcat - 內建 Tomcat 伺服器可以執行部署為 WAR 套件的應用程式。
• JBoss EAP - 僅支持免費、進階 v3 和隔離 v2 定價層中的Linux應用程式。 內建 JBoss EAP 伺服器可以執行部署為 WAR 或 EAR 套件的應用程式。

注意

針對 Spring 應用程式，我們建議使用 Azure Spring 應用程式。 不過，您仍然可以使用 Azure App Service 作為目的地。 如需建議，請參閱 Java 工作負載目的地指導。

設定 Application Insights

Azure 監視器 Application Insights 是雲端原生的應用程式監視服務，可讓客戶觀察失敗、瓶頸和使用模式，以改善應用程式效能，並減少平均解決時間 (MTTR)。 只要按幾下滑鼠或透過幾個 CLI 命令，就可以監視 Node.js 或 Java 應用程式；自動收集記錄、計量和分散式追蹤；不需要在應用程式中納入 SDK。 如需可用於設定代理程式的應用程式設定詳細資訊，請參閱 Application Insights 文件。

Azure 入口網站

若要從 Azure 入口網站啟用 Application Insights，請移至左側功能表上的 [Application Insights]，然後選取 [開啟 Application Insights]。 根據預設，系統會使用與 Web 應用程式同名的新 Application Insights 資源。 您可以選擇使用現有的 Application Insights 資源，或變更名稱。 選取底部的 [套用]。

Azure CLI

若要透過 Azure CLI 啟用，您必須建立 Application Insights 資源，並在 Azure 入口網站上設定幾個應用程式設定，以將 Application Insights 連線到 Web 應用程式。

1. 啟用 Applications Insights 延伸模組

   az extension add -n application-insights
   

2. 使用下列 CLI 命令建立 Application Insights 資源。 使用所需的資源名稱和群組來取代預留位置。

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

   請記下 connectionString 和 instrumentationKey 的值，下一個步驟中會需要這些值。

   注意

   若要擷取其他位置的清單，請執行 az account list-locations。

3. 將檢測金鑰、連接字串和監視代理程式版本設定為 Web 應用程式上的應用程式設定。 以先前步驟中的值取代 <instrumentationKey> 和 <connectionString>。

   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"
   

設定 NewRelic

Linux

注意

最新的 New Relic 檔 列出最多 7.x 的 JBoss EAP 支援。 尚不支援 JBoss EAP 8.x。

1. 在 NewRelic.com 建立 NewRelic 帳戶

2. 從 NewRelic 下載 Java 代理程式。

3. 複製您的授權金鑰，以供稍後設定代理程式時使用。

4. 透過 SSH 連線到您的 App Service 執行個體，然後建立新目錄 /home/site/wwwroot/apm。

5. 將解壓縮的 NewRelic Java 代理程式檔案上傳至 /home/site/wwwroot/apm 之下的目錄。 代理程式檔案應位於 /home/site/wwwroot/apm/newrelic 中。

6. 在 /home/site/wwwroot/apm/newrelic/newrelic.yml 修改 YAML 檔案，並將預留位置授權值取代為您自己的授權金鑰。

7. 在 Azure 入口網站中，瀏覽至您在 App Service 中的應用程式，並建立新的應用程式設定。

   使用 -javaagent:/home/site/wwwroot/apm/newrelic/newrelic.jar 這個值建立名為 JAVA_OPTS 的環境變數。

   使用 -javaagent:/home/site/wwwroot/apm/newrelic/newrelic.jar 這個值建立名為 CATALINA_OPTS 的環境變數。

Windows

1. 在 NewRelic.com 建立 NewRelic 帳戶

2. 從 NewRelic 下載 Java 代理程式。 檔案名稱類似於 newrelic-java-x.x.x.zip。

3. 複製您的授權金鑰，以供稍後設定代理程式時使用。

4. 透過 SSH 連線到您的 App Service 執行個體，然後建立新目錄 /home/site/wwwroot/apm。

5. 將解壓縮的 NewRelic Java 代理程式檔案上傳至 /home/site/wwwroot/apm 之下的目錄。 代理程式檔案應位於 /home/site/wwwroot/apm/newrelic 中。

6. 在 /home/site/wwwroot/apm/newrelic/newrelic.yml 修改 YAML 檔案，並將預留位置授權值取代為您自己的授權金鑰。

7. 在 Azure 入口網站中，瀏覽至您在 App Service 中的應用程式，並建立新的應用程式設定。

   使用 -javaagent:/home/site/wwwroot/apm/newrelic/newrelic.jar 這個值建立名為 JAVA_OPTS 的環境變數。

   使用 -javaagent:/home/site/wwwroot/apm/newrelic/newrelic.jar 這個值建立名為 CATALINA_OPTS 的環境變數。

注意

如果您已經有 JAVA_OPTS 的環境變數，請將 -javaagent:/... 選項附加至目前值的結尾。

注意

如果您已經有 CATALINA_OPTS 的環境變數，請將 -javaagent:/... 選項附加至目前值的結尾。

設定 AppDynamics

Linux

1. 在 AppDynamics.com 建立 AppDynamics 帳戶

2. 從 AppDynamics 網站下載 Java 代理程式。 檔案名稱類似於 AppServerAgent-x.x.x.xxxxx.zip

3. 透過 SSH 連線到您的 App Service 執行個體，然後建立新目錄 /home/site/wwwroot/apm。

4. 將 Java 代理程式檔案上傳至 /home/site/wwwroot/apm 下的目錄。 代理程式檔案應位於 /home/site/wwwroot/apm/appdynamics 中。

5. 在 Azure 入口網站中，瀏覽至您在 App Service 中的應用程式，並建立新的應用程式設定。

   使用 -javaagent:/home/site/wwwroot/apm/appdynamics/javaagent.jar -Dappdynamics.agent.applicationName=<app-name> 這個值建立名為 JAVA_OPTS 的環境變數，其中 <app-name> 是您的 App Service 名稱。 如果您已經有 JAVA_OPTS 的環境變數，請將 -javaagent:/... 選項附加至目前值的結尾。

   使用 -javaagent:/home/site/wwwroot/apm/appdynamics/javaagent.jar -Dappdynamics.agent.applicationName=<app-name> 這個值建立名為 CATALINA_OPTS 的環境變數，其中 <app-name> 是您的 App Service 名稱。 如果您已經有 CATALINA_OPTS 的環境變數，請將 -javaagent:/... 選項附加至目前值的結尾。

Windows

1. 在 AppDynamics.com 建立 AppDynamics 帳戶

2. 從 AppDynamics 網站下載 Java 代理程式。 檔案名稱類似於 AppServerAgent-x.x.x.xxxxx.zip

3. 使用 Kudu 主控台來建立新的目錄 /home/site/wwwroot/apm。

4. 將 Java 代理程式檔案上傳至 /home/site/wwwroot/apm 下的目錄。 代理程式檔案應位於 /home/site/wwwroot/apm/appdynamics 中。

5. 在 Azure 入口網站中，瀏覽至您在 App Service 中的應用程式，並建立新的應用程式設定。

   使用 -javaagent:/home/site/wwwroot/apm/appdynamics/javaagent.jar -Dappdynamics.agent.applicationName=<app-name> 這個值建立名為 JAVA_OPTS 的環境變數，其中 <app-name> 是您的 App Service 名稱。 如果您已經有 JAVA_OPTS 的環境變數，請將 -javaagent:/... 選項附加至目前值的結尾。

   使用 -javaagent:/home/site/wwwroot/apm/appdynamics/javaagent.jar -Dappdynamics.agent.applicationName=<app-name> 這個值建立名為 CATALINA_OPTS 的環境變數，其中 <app-name> 是您的 App Service 名稱。 如果您已經有 CATALINA_OPTS 的環境變數，請將 -javaagent:/... 選項附加至目前值的結尾。

設定 Datadog

Linux

組態選項會根據貴組織所使用的 Datadog 網站而有所不同。 請參閱官方適用於 Azure 的 Datadog 整合文件

Windows

組態選項會根據貴組織所使用的 Datadog 網站而有所不同。 請參閱官方適用於 Azure 的 Datadog 整合文件

設定 Dynatrace

Linux

Dynatrace 提供 Azure Native Dynatrace 服務。 若要使用 Dynatrace 監視 Azure App Services，請參閱 Azure 官方適用於 Azure 的 Dynatrace 文件

Windows

Dynatrace 提供 Azure Native Dynatrace 服務。 若要使用 Dynatrace 監視 Azure App Services，請參閱 Azure 官方適用於 Azure 的 Dynatrace 文件

下一步

瀏覽適用於 Java 開發人員的 Azure 中心，以找出 Azure 快速入門、教學課程和 Java 參考文件。

• App Service Linux 常見問題集
• 環境變數與應用程式設定參考