你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

如何使用 AppDynamics Java 代理监视 Spring Boot 应用

2025-04-12

注意

基本计划、标准计划和企业计划于 2025 年 3 月 17 日进入停用期。有关详细信息，请参阅 Azure Spring Apps 停用公告。

标准消耗和专用计划于 2024 年 9 月 30 日进入停用期，并将在 2025 年 3 月底之前完全关闭。有关详细信息，请参阅将 Azure Spring Apps 标准消耗和专用计划迁移到 Azure 容器应用。

本文适用于：✅ 标准消耗和专用计划（预览版）✅ 基本/标准计划 ❎ 企业计划

本文介绍如何使用 AppDynamics Java 代理监视 Azure Spring Apps 中的 Spring Boot 应用程序。

使用 AppDynamics Java 代理，可以：

监视应用程序
使用环境变量配置 AppDynamics Java 代理
从 AppDynamics 仪表板检查所有监视数据

以下视频介绍了 AppDynamics Java 进程内代理。

先决条件

激活 AppDynamics Java 进程内代理

对于整个工作流，需要：

在 Azure Spring Apps 中激活 AppDynamics Java 进程内代理以生成应用程序指标数据。
将 AppDynamics 代理连接到 AppDynamics 收集器以在控制器中收集并可视化数据。

示意图显示 AppDynamics 代理，其中显示有双向箭头从该代理指向 Azure Spring Apps 中的 Spring Boot 应用，有单向箭头从该代理指向 AppDynamics 代理。

使用 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 中查看和组织报告，请参阅层级和节点。

使用 Azure 门户通过 AppDynamics 代理激活应用程序

若要通过 Azure 门户激活应用程序，请使用以下步骤。

在 Azure 门户中导航到 Azure Spring Apps 实例。
在导航窗格的“设置”部分，选择“应用”。
选择应用，然后在导航窗格中选择“配置”。
使用“常规设置”选项卡更新 JVM 选项之类的值。
选择“环境变量”，添加或更新应用程序使用的变量。

自动预配

还可以使用 Terraform、Bicep 或 Azure 资源管理器模板（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",
  ...
}