你当前正在访问 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 容器应用

本文适用于:✔️ 基本/标准层 ❌ Enterprise 层

使用 Azure Spring Apps 中的内置监视功能,可以调试和监视复杂问题。 Azure Spring Apps 将 Steeltoe 分布式跟踪 与 Azure 的 Application Insights 集成。 这种集成可以通过 Azure 门户提供强大的日志、指标和分布式跟踪功能。

以下过程说明如何通过你在前面快速入门中部署的示例应用使用日志流式处理、Log Analytics、指标和分布式跟踪。

先决条件

日志

可通过两种方式在 Azure Spring Apps 上查看日志:每个应用实例的实时日志的日志流式处理或具有高级查询功能的聚合日志的 Log Analytics。

日志流式处理

使用以下步骤在 Azure 门户中流式传输日志:

  1. 转到 Azure Spring Apps 服务实例的“概述”页面,然后在导航窗格中选择“应用”

  2. 找到目标应用,然后选择上下文菜单。

  3. 在弹出的上下文菜单中,选择“查看日志流”

    Azure 门户的屏幕截图,其中显示了“应用”页面,并突出显示了“查看日志流”上下文菜单项。

默认情况下,日志会从随机选择的应用实例开始流式传输。 之后可以选择自己的应用实例。

Azure 门户的屏幕截图,其中显示了“日志流”页面。

为了方便,有许多入口点可用于流式传输日志。 可以在以下窗格中找到它们:

  • “应用列表”窗格
  • “部署列表”窗格
  • “应用实例列表”窗格

Log Analytics

  1. 在 Azure 门户中转到“服务 | 概览”页,然后在“监视”部分选择“日志” 。 选择 Azure Spring Apps 的一个示例查询上的“运行”。

    Azure 门户中“日志”窗格的屏幕截图,其中“查询”页处于打开状态并突出显示了“运行”。

  2. 编辑查询以删除将显示限制为警告和错误日志的 Where 子句。

  3. 选择“运行”。 你会看到日志。 有关详细信息,请参阅 Azure Monitor 日志查询入门

    Azure 门户的屏幕截图,其中显示了 Log Analytics 查询结果。

  4. 若要详细了解 Log Analytics 中使用的查询语言,请参阅 Azure Monitor 日志查询。 要从一个集中的客户端查询所有 Log Analytics 日志,请查看 Azure 数据资源管理器

指标

  1. 在 Azure 门户中转到“服务 | 概述”页,然后在“监视”部分中选择“指标” 。 添加第一个指标(方法是:在“性能(.NET)”或“请求(.NET)”下的“指标”下拉框中选择 .NET 指标之一,并为“聚合”选择“平均”)以查看该指标的时间线

    Azure 门户的屏幕截图,其中显示了“指标”页以及可用的筛选器。

  2. 选择工具栏中的“添加筛选器”,选择 App=solar-system-weather,以仅查看“solar-system-weather”应用的 CPU 使用情况 。

    Azure 门户的屏幕截图,其中显示了“指标”页并突出显示了筛选器“属性”、“运算符”和“值”选项。

  3. 关闭在前一步中创建的筛选器,选择“应用拆分”,然后为“值”选择“应用”以查看不同应用的 CPU 使用情况

    Azure 门户的屏幕截图,其中显示了“指标”页并突出显示了拆分“值”、“限制”和“排序”选项。

分布式跟踪

  1. 在Azure 门户中转到“服务 | 概述”页,然后在“监视”部分中选择“分布式跟踪” 。 然后选择右侧的“查看应用程序映射”选项卡。

    Azure 门户的屏幕截图,其中显示了“分布式跟踪”页。

  2. 现在可以查看应用间的调用状态。

    Azure 门户的屏幕截图,其中显示了“应用程序映射”页。

  3. 选择“solar-system-weather”和“planet-weather-provider”之间的链接,查看更多详细信息,如最慢的 HTTP 方法调用。

    Azure 门户的屏幕截图,其中显示了“应用程序映射”详细信息。

  4. 最后,选择“调查性能”以探索更强大的内置性能分析。

    Azure 门户的屏幕截图,其中显示了“性能”页。

使用 Azure Spring Apps 中的内置监视功能,可以调试和监视复杂问题。 Azure Spring Apps 将 Spring Cloud Sleuth 与 Azure 的 Application Insights 集成。 这种集成可以通过 Azure 门户提供强大的日志、指标和分布式跟踪功能。 以下过程说明如何通过已部署的 PetClinic 应用使用日志流式处理、Log Analytics、指标和分布式跟踪。

先决条件

日志

可通过两种方式在 Azure Spring Apps 上查看日志:每个应用实例的实时日志的日志流式处理或具有高级查询功能的聚合日志的 Log Analytics。

日志流式处理

使用以下步骤在 Azure 门户中流式传输日志:

  1. 转到 Azure Spring Apps 服务实例的“概述”页面,然后在导航窗格中选择“应用”

  2. 找到目标应用,然后选择上下文菜单。

  3. 在弹出的上下文菜单中,选择“查看日志流”

    Azure 门户的屏幕截图,其中显示了“应用”页面,并突出显示了“查看日志流”上下文菜单项。

默认情况下,日志会从随机选择的应用实例开始流式传输。 之后可以选择自己的应用实例。

Azure 门户的屏幕截图,其中显示了“日志流”页面。

为了方便,有许多入口点可用于流式传输日志。 可以在以下窗格中找到它们:

  • “应用列表”窗格
  • “部署列表”窗格
  • “应用实例列表”窗格

Log Analytics

  1. 转到“服务 | 概述”页,然后在“监视”部分中选择“日志” 。 选择 Azure Spring Apps 的一个示例查询上的“运行”。

    Azure 门户的屏幕截图,其中显示了“查询”页并突出显示了“运行”。

  2. 然后,你会看到筛选出的日志。 有关详细信息,请参阅 Azure Monitor 日志查询入门

    Azure 门户的屏幕截图,其中显示了已筛选日志的查询结果。

指标

导航到“Application insights”页,然后导航到“指标”页。 可以看到由 Spring Boot 应用、Spring 模块和依赖项提供的指标。

下图显示 gateway_requests(Spring Cloud 网关)、hikaricp_connections(JDBC 连接)和 http_client_requests

Azure 门户 Application Insights 的屏幕截图,其中显示了“指标”页以及所选值的图表。

Spring Boot 注册多个核心指标,包括 JVM、CPU、Tomcat 和 Logback。 Spring Boot 自动配置可用于检测由 Spring MVC 处理的请求。 所有三个 REST 控制器(OwnerResourcePetResourceVisitResource)都将由类级别的 @Timed Micrometer 注释进行检测。

customers-service 应用程序启用了下列自定义指标:

  • @Timed: petclinic.owner
  • @Timed: petclinic.pet

visits-service 应用程序启用了下列自定义指标:

  • @Timed: petclinic.visit

可以在“指标”页中查看这些自定义指标:

Azure 门户 Application Insights 的屏幕截图,其中显示了“指标”页以及自定义指标。

可以使用 Application Insights 中的可用性测试功能并监视应用程序的可用性:

Azure 门户 Application Insights 的屏幕截图,其中显示了“可用性”页并突出显示了“可用性测试”部分。

导航到“实时指标”页可查看低延迟(小于 1 秒)的实时指标

Azure 门户 Application Insights 的屏幕截图,其中显示了“实时指标”页的低延迟图表。

跟踪

打开 Azure Spring Apps 创建的 Application Insights,并开始监视 Spring 应用程序。

导航到“应用程序映射”页:

Azure 门户 Application Insights 的屏幕截图,其中显示了“应用程序映射”页以及映射组件。

导航到“性能”页

Azure 门户 Application Insights 的屏幕截图,其中显示了“性能”页以及“操作”详细信息。

导航到“依赖项”选项卡,从中可以查看依赖项的性能数,尤其是 SQL 调用:

Azure 门户 Application Insights 的屏幕截图,其中显示了“性能”页并突出显示了“依赖项”表。

选择 SQL 调用,查看上下文中的端到端事务:

Azure 门户的屏幕截图,其中显示了端到端事务详细信息页。

导航到“失败”页的“异常”选项卡,从中可以看到异常的集合:

Azure 门户 Application Insights 的屏幕截图,其中显示了“失败”页。

选择一个异常以查看上下文中的端到端事务和堆栈跟踪:

Azure 门户的屏幕截图,其中显示了端到端事务详细信息页以及异常详细信息和调用堆栈。

清理资源

如果打算继续使用后续的快速入门和教程,则可能需要保留这些资源。 如果不再需要资源组,可以将其删除,这将删除资源组中的资源。 若要使用 Azure CLI 删除资源组,请使用以下命令:

echo "Enter the Resource Group name:" &&
read resourceGroupName &&
az group delete --name $resourceGroupName &&
echo "Press [ENTER] to continue ..."

在前面的快速入门中,你还设置了默认资源组名称。 如果不打算继续学习下一个快速入门,请通过运行以下 CLI 命令清除该默认名称:

az config set defaults.group=

后续步骤

若要了解 Azure Spring Apps 的更多监视功能,请参阅: