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

将应用程序实时视图与 Azure Spring Apps 企业计划配合使用

注意

基本、标准和企业计划将从 2025 年 3 月中旬开始弃用，停用期为 3 年。 建议转换到 Azure 容器应用。 有关详细信息，请参阅 Azure Spring Apps 停用公告。

标准消耗和专用计划将于 2024 年 9 月 30 日开始弃用，并在六个月后完全关闭。 建议转换到 Azure 容器应用。 有关详细信息，请参阅将 Azure Spring Apps 标准消耗和专用计划迁移到 Azure 容器应用。

本文适用于：❎ 基本/标准计划 ✅ 企业计划

本文介绍了如何将 VMware Tanzu 的应用程序实时视图与 Azure Spring Apps 企业计划配合使用。

VMware Tanzu 的应用程序实时视图是一种轻量级见解和故障排除工具，可帮助应用开发人员和应用操作员查看正在运行的应用内部情况。

应用程序实时视图仅支持 Spring Boot 应用程序。

先决条件

• Azure 订阅。 如果没有 Azure 订阅，请在开始之前创建一个免费帐户。

• 了解并满足 Azure 市场中企业计划的要求部分。

• 带有 Azure Spring Apps 扩展的 Azure CLI。 使用以下命令删除以前的版本，并安装最新的扩展。 如果以前安装了 spring-cloud 扩展，请卸载它以避免配置和版本不匹配。

  az extension remove --name spring
  az extension add --name spring
  az extension remove --name spring-cloud
  

启用应用程序实时视图

预配 Azure Spring Apps 企业计划实例时，可以启用应用程序实时视图。 如果已有预配的 Azure Spring Apps 企业资源，请参阅本文中的在现有企业计划实例中管理应用程序实时视图部分。

可以使用 Azure 门户或 Azure CLI 启用应用程序实时视图。

Azure 门户

使用以下步骤通过 Azure 门户来启用应用程序实时视图：

1. 导航到 Azure 门户。

2. 在“基本信息”选项卡上，在定价中选择“企业层级”，指定其他输入字段，然后选择“下一步”。

3. 在“VMware Tanzu 设置”选项卡上，选择“启用应用实时视图”。

   

4. 指定其他设置，然后选择“查看并创建”。

5. 确保在“审阅和创建 ”选项卡上将“启用应用程序实时视图 ”和“启用开发人员工具门户”设置为“是”，然后选择“创建”以创建企业计划实例。

Azure CLI

使用以下步骤通过 Azure CLI 预配 Azure Spring Apps 服务实例。

1. 使用以下命令登录到 Azure CLI 并指定活动订阅：

   az login
   az account list --output table
   az account set --subscription <subscription-ID>
   

2. 使用以下命令接受企业计划的法律条款和隐私声明。 仅当订阅从未用于创建 Azure Spring Apps 企业计划实例时，才需要执行此步骤。

   az provider register --namespace Microsoft.SaaS
   az term accept \
       --publisher vmware-inc \
       --product azure-spring-cloud-vmware-tanzu-2 \
       --plan asa-ent-hr-mtr
   

3. 选择一个位置。 此位置必须是支持 Azure Spring Apps 企业计划的位置。 有关详细信息，请参阅 Azure Spring Apps 常见问题解答。

4. 使用以下命令来创建资源组：

   az group create \
       --name <resource-group-name> \
       --location <location>
   

   有关资源组的详细信息，请参阅什么是 Azure 资源管理器？

5. 准备 Azure Spring Apps 服务实例的名称。 该名称必须为 4 到 32 个字符，只能包含小写字母、数字及连字符。 服务名称的第一个字符必须是字母，最后一个字符必须是字母或数字。

6. 使用以下命令创建 Azure Spring Apps 服务实例：

   az spring create \
       --resource-group <resource-group-name> \
       --name <Azure-Spring-Apps-service-instance-name> \
       --sku enterprise \
       --enable-application-live-view
   

监视应用程序实时视图

Azure Spring Apps 在连接器模式下运行应用程序实时视图。

组件	说明
应用程序实时视图服务器	包含已注册应用列表的中心服务器组件。 应用程序实时视图服务器负责代理请求以获取与应用相关的执行器信息。
应用程序实时视图连接器	该组件负责发现正在运行的应用，并将实例注册到应用程序实时视图服务器，以便对其进行观察。 应用程序实时视图连接器还负责将执行器查询代理到应用。

预配 Azure Spring Apps 企业计划实例后，可以获取其正在运行的状态和资源消耗，或管理应用程序实时视图。

可以使用 Azure 门户或 Azure CLI 监视应用程序实时视图。

Azure 门户

可以在 Azure 门户中通过“开发人员工具”页的“概述”选项卡查看应用程序实时视图的状态。

Azure CLI

使用以下命令查看应用程序实时视图：

az spring application-live-view show \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-service-instance-name>

配置开发人员工具以访问应用程序实时视图

若要访问应用程序实时视图，需要配置 Tanzu 开发工具。 有关详细信息，请参阅在 Azure Spring Apps 企业计划中配置 Tanzu 开发人员工具。

使用应用程序实时视图来监视应用

使用应用程序实时视图可以查看 Spring Boot 应用程序和 Spring Native 应用程序的实时指标。 应用程序实时视图基于 Spring Boot 执行器的概念。

使用以下步骤部署应用并在应用程序实时视图中对其进行监视：

1. 将以下依赖项添加到应用程序的 pom.xml 文件中。

   <dependency>
       <groupId>org.springframework.boot</groupId>
       <artifactId>spring-boot-starter-actuator</artifactId>
    </dependency>
   

2. 将以下执行目标添加到 pom.xml 文件中的 Maven 插件，以公开版本信息：

   <plugin>
   <groupId>org.springframework.boot</groupId>
   <artifactId>spring-boot-maven-plugin</artifactId>
   <executions>
       <execution>
       <goals>
           <goal>build-info</goal>
       </goals>
       <configuration>
           <additionalProperties>
           <spring.boot.version>${project.parent.version}</spring.boot.version>
           </additionalProperties>
       </configuration>
       </execution>
   </executions>
   </plugin>
   

3. 通过在 application.properties 中添加以下配置来启用执行器终结点：

   management.endpoints.web.exposure.include=info,health
   

4. 使用以下命令在本地生成包：

   mvn clean package -DskipTests
   

5. 使用以下命令部署二进制文件：

   az spring app create \
       --resource-group <resource-group-name> \
       --service <Azure-Spring-Apps-service-instance-name> \
       --name <app-name>
   az spring app deploy \
       --resource-group <resource-group-name> \
       --service <Azure-Spring-Apps-service-instance-name> \
       --name <app-name> \
       --artifact-path <jar-file-in-target-folder>
   

6. 成功部署应用后，可以使用开发人员工具门户上的“应用程序实时视图”仪表板对其进行监视。 有关详细信息，请参阅通过应用程序实时视图监视应用。

   如果已启用开发人员工具门户并公开公共终结点，请使用以下命令获取开发人员工具门户仪表板 URL。 添加 /app-live-view 后缀来撰写终结点以访问应用程序实时视图。

   az spring dev-tool show --service <Azure-Spring-Apps-service-instance-name> \
       --resource-group <resource-group-name> \
       --query properties.url \
       --output tsv
   

   还可以使用 Visual Studio Code (VS Code) 访问应用程序实时视图。 有关详细信息，请参阅本文的在 VS Code 中使用应用程序实时视图部分。

在现有企业计划实例中管理应用程序实时视图

可以使用 Azure 门户或 Azure CLI，在现有的 Azure Spring Apps 企业计划实例中启用应用程序实时视图。

如果已启用开发人员工具门户并公开了公共终结点，请使用 Ctrl+F5 以在启用应用程序实时视图后停用浏览器缓存。

Azure 门户

使用以下步骤通过 Azure 门户管理应用程序实时视图：

1. 导航到 Azure Spring Apps 服务实例，然后选择“开发人员工具”。

2. 选择“管理工具”。

   

3. 选中“启用应用实时视图”复选框，然后选择“保存”。

   

4. 然后，可以在“开发人员工具”上查看应用程序实时视图的状态。

Azure CLI

使用以下命令通过 Azure CLI 启用应用程序实时视图：

az spring application-live-view create \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-service-instance-name>

若要访问应用程序实时视图仪表板，必须启用开发人员工具门户并分配公共终结点。 使用以下命令启用开发人员工具门户并分配公共终结点：

az spring dev-tool create \
   --resource-group <resource-group-name> \
   --service <Azure-Spring-Apps-service-instance-name> \
   --assign-endpoint

配置自定义的 Spring Boot 执行器

应用程序实时视图可以使用默认执行器设置自动连接和监视 Spring Boot 应用。 执行器终结点的默认 HTTP 端口与应用程序的 HTTP 端口相同，所有执行器终结点都可通过应用程序的默认上下文路径（具有 /actuator 后缀）进行访问。

如果为应用自定义了端口 (management.server.port=) 或上下文路径 (management.endpoints.web.base-path=/)，则应用程序实时视图将停止连接和监视应用，并针对该应用报告 404。 若要使应用程序实时视图能够继续监视此类应用，请使用以下步骤配置应用部署以自定义执行器终结点。

Azure 门户

使用以下步骤通过 Azure 门户配置部署：

1. 导航到 Azure Spring Apps 服务实例，然后转到“应用”并选择一个应用程序。

2. 在导航窗格中选择“配置”。

3. 在“常规设置”选项卡上，更新“Spring Boot 执行器端口”和“Spring Boot 执行器路径”值，然后选择“保存”。

   

Azure CLI

通过以下命令在 Azure CLI 中使用自定义执行器设置部署应用程序：

az spring app deploy \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-service-instance-name> \
    --name <app-name> \
    --artifact-path <jar-file-in-target-folder> \
    --custom-actuator-path <another-path-for-actuator> \
    --custom-actuator-port <another-port-for-actuator>

注意

可以在应用或部署上设置此配置。 配置应用时，它实际上对当前活动部署生效，但不会自动影响新的部署。

在 VS Code 中使用应用程序实时视图

可以直接在 VS Code 中访问应用程序实时视图，以在 Azure Spring Apps 企业计划中监视应用。

先决条件

• Visual Studio Code
• Visual Studio Code 的 Azure Spring Apps 扩展

查看应用程序实时视图仪表板

使用以下步骤查看服务实例的应用程序实时视图仪表板：

1. 在 Visual Studio Code 中，打开 Azure Spring Apps 扩展，然后登录到 Azure 帐户。

2. 展开要监视的服务实例，然后右键单击选择该服务实例。

3. 从菜单中选择“打开应用程序实时视图”，以在默认浏览器中打开应用程序实时视图仪表板。

   

查看应用的“应用程序实时视图”页

使用以下步骤查看应用的“应用程序实时视图”页：

1. 在 Visual Studio Code 中，打开 Azure Spring Apps 扩展，然后登录到 Azure 帐户。

2. 展开要监视的服务实例和应用。 右键单击应用。

3. 从菜单中选择“打开应用程序实时视图”，以在默认浏览器中打开应用的“应用程序实时视图”页面。

   

故障排查应用程序实时视图问题

如果尝试为一个服务实例或应用打开应用程序实时视图，该服务实例或应用未启用应用程序实时视图或未公开公共终结点，则会看到一条错误消息。

若要启用应用程序实时视图并公开公共终结点，请使用 Azure 门户或 Azure CLI。 有关详细信息，请参阅本文的在现有企业计划实例中管理应用程序实时视图部分。

后续步骤

• Azure Spring Apps