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

本文說明如何將部署於 Azure App Service 的 Java 應用程式與 Azure Monitor Application Insights、New Relic 及 AppDynamics 應用效能監控（APM）平台連結起來。

Azure App Service 在完全託管的服務上執行三種類型的 Java 網頁應用程式：

Java 標準版（SE）。 Java SE 可執行以 Java 壓縮包（JAR）套件部署的應用程式，該套件包含嵌入式伺服器，例如 Spring Boot、Quarkus、Dropwizard，或是內建 Tomcat 或 Jetty 伺服器的應用程式。
Tomcat。內建的 Tomcat 伺服器可執行以網頁應用程式壓縮套件（WAR）部署的應用程式。
JBoss 企業應用程式平臺（EAP）：內建的 JBoss EAP 伺服器可以執行部署為 WAR 或企業封存（EAR）套件的應用程式。此選項支援 Linux 應用程式，包含免費、Premium v3 及 Isolated v2 等價格層級。

附註

JBoss EAP 現在在 App Service 上支援「自備授權」（Bring Your Own License，BYOL）計費。 BYOL 允許擁有現有 Red Hat 訂閱的客戶，直接將這些授權套用到 Azure App Service 上的 JBoss EAP 部署。欲了解更多資訊，請參閱 BYOL 對 App Service 上 JBoss EAP 的支援。

設定 Application Insights

Azure Monitor Application Insights 是一項雲端原生應用程式監控服務。它能讓你觀察失敗、瓶頸和使用模式，進而提升應用程式效能並縮短平均解決時間（MTTR）。你可以啟用監控 Node.js 或 Java 應用程式，自動收集日誌、指標和分散式追蹤。 Application Insights 消除了你在應用程式中加入 SDK 的需求。如需可用於設定代理程式的應用程式設定詳細資訊，請參閱 Application Insights 文件。

Azure 入口網站
Azure CLI

要從 Azure 入口網站啟用應用程式洞察，在左側選單中選擇「監控>應用程式洞察」。 選取 [開啟 Application Insights]。

預設情況下，會使用與你的網頁應用程式同名的新 Application Insights 資源。你可以選擇使用現有的 Application Insights 資源，或更改名稱。選取底部的 [套用]。

要啟用 Azure CLI，你需要建立一個 Application Insights 資源，並設定幾個應用程式設定，將 Application Insights 連接到你的網頁應用程式。

啟用 Application Insights 擴充功能。
```
az extension add -n application-insights
```
使用下列 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。

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

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"

設定 NewRelic

若要設定 New Relic：

Linux
Windows 作業系統

附註

最新的 New Relic 文件會列出最高到 7.x 的 JBoss EAP 支援。 JBoss EAP 8.x 尚未支援。

在 NewRelic.com 建立一個帳號。
從 New Relic 下載 Java 代理程式。
複製您的授權金鑰，以供稍後設定代理程式時使用。
透過 SSH 連線到您的 App Service 執行個體，然後建立新目錄 /home/site/wwwroot/apm。
將解壓後的 New Relic Java 代理檔上傳到 /home/site/wwwroot/apm 下的目錄。代理程式檔案應位於 /home/site/wwwroot/apm/newrelic 中。
修改 /home/site/wwwroot/apm/newrelic/newrelic.yml 的 YAML 檔案。用你的授權金鑰取代佔位符的授權值。
在 Azure 入口網站中，瀏覽至您在 App Service 中的應用程式，並建立新的應用程式設定。

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

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

在 NewRelic.com 建立一個帳號。
從 New Relic 下載 Java 代理程式。檔案名稱類似於 newrelic-java-x.x.x.zip。
複製您的授權金鑰，以供稍後設定代理程式時使用。
透過 SSH 連線到您的 App Service 執行個體，然後建立新目錄 /home/site/wwwroot/apm。
將解壓後的 New Relic Java 代理檔上傳到 /home/site/wwwroot/apm 下的目錄。代理程式檔案應位於 /home/site/wwwroot/apm/newrelic 中。
修改 /home/site/wwwroot/apm/newrelic/newrelic.yml 的 YAML 檔案。用你的授權金鑰取代佔位符的授權值。
在 Azure 入口網站中，瀏覽至您在 App Service 中的應用程式，並建立新的應用程式設定。

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

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

附註

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

附註

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

設定 AppDynamics

若要設定 AppDynamics：

Linux
Windows 作業系統

在 AppDynamics.com 建立一個 AppDynamics 帳號。
從 AppDynamics 網站下載 Java 代理程式。檔案名稱與 AppServerAgent-x.x.x.xxxxx.zip相似。
透過 SSH 連線到您的 App Service 執行個體，然後建立新目錄 /home/site/wwwroot/apm。
將 Java 代理程式檔案上傳至 /home/site/wwwroot/apm 下的目錄。代理程式檔案應位於 /home/site/wwwroot/apm/appdynamics 中。
在 Azure 入口網站中，瀏覽至您在 App Service 中的應用程式，並建立新的應用程式設定。

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

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

在 AppDynamics.com 建立一個 AppDynamics 帳號。
從 AppDynamics 網站下載 Java 代理程式。檔案名稱與 AppServerAgent-x.x.x.xxxxx.zip相似。
使用 Kudu 主控台來建立新的目錄 /home/site/wwwroot/apm。
將 Java 代理程式檔案上傳至 /home/site/wwwroot/apm 下的目錄。代理程式檔案應位於 /home/site/wwwroot/apm/appdynamics 中。
在 Azure 入口網站中，瀏覽至您在 App Service 中的應用程式，並建立新的應用程式設定。

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

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

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

設定 Dynatrace

Linux
Windows 作業系統

Dynatrace 提供 Azure Native Dynatrace 服務。若想使用 Dynatrace 監控 Azure 應用服務，請參閱官方 Dynatrace for Azure 文件。

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

意見反應

此頁面對您有幫助嗎？

Last updated on 2026-04-24