如何使用 AppDynamics Java 代理程式監視 Spring Boot 應用程式

發行項
01/31/2024

注意

Azure Spring Apps 是 Azure Spring Cloud 服務的新名稱。雖然服務有新的名稱，但是您暫時還是會在某些位置看到舊的名稱。我們正在致力更新螢幕擷取畫面、影片和圖表等資產。

本文適用於： ✔️標準取用和專用（預覽） ✔️ 基本/標準 ❌️ 企業版

本文說明如何使用AppDynamics Java代理程式來監視 Azure Spring Apps 中的 Spring Boot 應用程式。

使用 AppDynamics Java 代理程式，您可以：

監視應用程式
使用環境變數設定 AppDynamics Java 代理程式
從 AppDynamics 儀錶板檢查所有監視數據

下列影片介紹AppDynamics Java進程代理程式。

必要條件

啟動 AppDynamics Java 進程代理程式

針對整個工作流程，您需要：

在 Azure Spring Apps 中啟動 AppDynamics Java 進程代理程式，以產生應用程式計量數據。
連線 AppDynamics 代理程式至 AppDynamics 控制器，以收集和可視化控制器中的數據。

此圖顯示 AppDynamics Agent 在 Azure Spring Apps 中使用雙向箭號指向 Spring Boot Apps，以及指向 AppDynamics Agent 的箭號。

使用 Azure CLI 使用 AppDynamics 代理程式啟用應用程式

若要透過 Azure CLI 啟用應用程式，請使用下列步驟。

建立資源群組。
建立 Azure Spring Apps 的實例。

使用下列命令建立應用程式。將佔位元 <...> 取代為您自己的值。

az spring app create \
    --resource-group "<your-resource-group-name>" \
    --service "<your-Azure-Spring-Apps-instance-name>" \
    --name "<your-app-name>" \
    --is-public true

使用環境變數，使用 AppDynamics 代理程式建立部署。

az spring app deploy \
    --resource-group "<your-resource-group-name>" \
    --service "<your-Azure-Spring-Apps-instance-name>" \
    --name "<your-app-name>" \
    --artifact-path app.jar \
    --jvm-options="-javaagent:/opt/agents/appdynamics/java/javaagent.jar" \
    --env APPDYNAMICS_AGENT_APPLICATION_NAME=<your-app-name> \
          APPDYNAMICS_AGENT_ACCOUNT_ACCESS_KEY=<your-agent-access-key> \
          APPDYNAMICS_AGENT_ACCOUNT_NAME=<your-agent-account-name> \
          APPDYNAMICS_JAVA_AGENT_REUSE_NODE_NAME=true \
          APPDYNAMICS_JAVA_AGENT_REUSE_NODE_NAME_PREFIX=<your-agent-node-name> \
          APPDYNAMICS_AGENT_TIER_NAME=<your-agent-tier-name> \
          APPDYNAMICS_CONTROLLER_HOST_NAME=<your-AppDynamics-controller-host-name> \
          APPDYNAMICS_CONTROLLER_SSL_ENABLED=true \
          APPDYNAMICS_CONTROLLER_PORT=443

Azure Spring Apps 會將 AppDynamics Java 代理程式預安裝到路徑 /opt/agents/appdynamics/java/javaagent.jar。您可以從應用程式的 JVM 選項啟動代理程式，然後使用環境變數設定代理程式。您可以在使用 Java 代理程式監視 Azure Spring Apps 中找到這些變數的值。如需這些變數如何協助在 AppDynamics UI 中檢視及組織報表的詳細資訊，請參閱階層和節點。

使用 appDynamics 代理程式使用 Azure 入口網站啟動應用程式

若要透過 Azure 入口網站啟用應用程式，請使用下列步驟。

流覽至 Azure 入口網站中的 Azure Spring Apps 實例。
在瀏覽窗格的 [設定] 區段中選取 [應用程式]。
選取應用程式，然後在瀏覽窗格中選取 [組態 ]。
使用 [ 一般設定 ] 索引標籤來更新 JVM 選項等值。
選取 [環境變數 ] 以新增或更新應用程式所使用的變數。

自動化佈建

您也可以使用 Terraform、Bicep 或 Azure Resource Manager 範本（ARM 範本）來執行布建自動化管線。此管線可以提供完整的交接體驗，以檢測及監視您建立和部署的任何新應用程式。

使用 Terraform 自動布建

若要在 Terraform 樣本中設定環境變數，請將下列程式代碼新增至範本，並將 <...> 佔位元取代為您自己的值。如需詳細資訊，請參閱管理作用中的 Azure Spring Apps 部署。

resource "azurerm_spring_cloud_java_deployment" "example" {
  ...
  jvm_options = "-javaagent:/opt/agents/appdynamics/java/javaagent.jar"
  ...
    environment_variables = {
      "APPDYNAMICS_AGENT_APPLICATION_NAME" : "<your-app-name>",
      "APPDYNAMICS_AGENT_ACCOUNT_ACCESS_KEY" : "<your-agent-access-key>",
      "APPDYNAMICS_AGENT_ACCOUNT_NAME" : "<your-agent-account-name>",
      "APPDYNAMICS_JAVA_AGENT_REUSE_NODE_NAME" : "true",
      "APPDYNAMICS_JAVA_AGENT_REUSE_NODE_NAME_PREFIX" : "<your-agent-node-name>",
      "APPDYNAMICS_AGENT_TIER_NAME" : "<your-agent-tier-name>",
      "APPDYNAMICS_CONTROLLER_HOST_NAME" : "<your-AppDynamics-controller-host-name>",
      "APPDYNAMICS_CONTROLLER_SSL_ENABLED" : "true",
      "APPDYNAMICS_CONTROLLER_PORT" : "443"
  }
}

使用 Bicep 自動布建

若要在 Bicep 檔案中設定環境變數，請將下列程式代碼新增至檔案，並將 <...> 佔位元取代為您自己的值。如需詳細資訊，請參閱 Microsoft.AppPlatform Spring/apps/deployments。

deploymentSettings: {
  environmentVariables: {
    APPDYNAMICS_AGENT_APPLICATION_NAME : '<your-app-name>'
    APPDYNAMICS_AGENT_ACCOUNT_ACCESS_KEY : '<your-agent-access-key>'
    APPDYNAMICS_AGENT_ACCOUNT_NAME : '<your-agent-account-name>'
    APPDYNAMICS_JAVA_AGENT_REUSE_NODE_NAME : 'true'
    APPDYNAMICS_JAVA_AGENT_REUSE_NODE_NAME_PREFIX : '<your-agent-node-name>'
    APPDYNAMICS_AGENT_TIER_NAME : '<your-agent-tier-name>'
    APPDYNAMICS_CONTROLLER_HOST_NAME : '<your-AppDynamics-controller-host-name>'
    APPDYNAMICS_CONTROLLER_SSL_ENABLED : 'true'
    APPDYNAMICS_CONTROLLER_PORT : '443'
  }
  jvmOptions: '-javaagent:/opt/agents/appdynamics/java/javaagent.jar'
}

使用ARM範本自動布建

若要在 ARM 範本中設定環境變數，請將下列程式代碼新增至範本，並將 <...> 佔位元取代為您自己的值。如需詳細資訊，請參閱 Microsoft.AppPlatform Spring/apps/deployments。

"deploymentSettings": {
  "environmentVariables": {
    "APPDYNAMICS_AGENT_APPLICATION_NAME" : "<your-app-name>",
    "APPDYNAMICS_AGENT_ACCOUNT_ACCESS_KEY" : "<your-agent-access-key>",
    "APPDYNAMICS_AGENT_ACCOUNT_NAME" : "<your-agent-account-name>",
    "APPDYNAMICS_JAVA_AGENT_REUSE_NODE_NAME" : "true",
    "APPDYNAMICS_JAVA_AGENT_REUSE_NODE_NAME_PREFIX" : "<your-agent-node-name>",
    "APPDYNAMICS_AGENT_TIER_NAME" : "<your-agent-tier-name>",
    "APPDYNAMICS_CONTROLLER_HOST_NAME" : "<your-AppDynamics-controller-host-name>",
    "APPDYNAMICS_CONTROLLER_SSL_ENABLED" : "true",
    "APPDYNAMICS_CONTROLLER_PORT" : "443"
  },
  "jvmOptions": "-javaagent:/opt/agents/appdynamics/java/javaagent.jar",
  ...
}