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

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

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

• Java Standard Edition （SE）：可以執行部署為 Java Archive （JAR） 套件的應用程式，其中包含內嵌伺服器（例如 Spring Boot、Quarkus、Dropwizard 或具有內嵌 Tomcat 或 Jetty 伺服器的應用程式）。
• Tomcat：內建 Tomcat 伺服器可以執行部署為 Web 應用程式封存 （WAR） 套件的應用程式。
• JBoss 企業應用程式平臺 （EAP）：內建的 JBoss EAP 伺服器可以執行部署為 WAR 或企業封存 （EAR） 套件的應用程式。 支援 Linux 應用程式中包括免費、進階 v3 和隔離式方案 v2.gti 的一系列價格層。

附註

App Service 上的 JBoss EAP 現在支援「自備授權」（BYOL） 計費，這可讓擁有現有 Red Hat 訂用帳戶的客戶將這些授權直接套用至 Azure App Service 上的 JBoss EAP 部署。 深入瞭解。

設定 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

若要設定 New Relic：

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

若要設定 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 常見問題集
• 環境變數與應用程式設定參考