通过诊断设置分析日志和指标

本文介绍如何在 Azure Spring Apps 中分析诊断数据。

使用 Azure Spring Apps 的诊断功能，可以通过以下任何服务分析日志和指标：

• 使用 Azure Log Analytics。 将日志导出到 Log Analytics 时存在延迟。
• 将日志保存到存储帐户进行审核或手动检查。 可以指定保留时间（天）。
• 将日志流式传输到事件中心，供第三方服务或自定义分析解决方案引入。

选择要监视的日志类别和指标类别。

日志

日志	说明
ApplicationConsole	所有客户应用程序的控制台日志。
SystemLogs	可用的 LogType 值是 ConfigServer（仅限基本/标准）、ServiceRegistry（所有计划）
IngressLogs	客户的所有应用程序的入口日志（仅访问日志）。
BuildLogs	每个生成阶段的所有客户应用程序的生成日志。

指标

有关指标的完整列表，请参阅 Azure Spring Apps 指标的用户指标选项部分。

若要开始，请启用其中一项服务来接收数据。 若要了解如何配置 Log Analytics，请参阅开始在 Azure Monitor 中使用 Log Analytics。

配置诊断设置

1. 在 Azure 门户中，请转到 Azure Spring Apps 实例。

2. 选择“诊断设置”选项，然后选择“添加诊断设置” 。

3. 输入设置的名称，然后选择要将日志发送到的位置。 可以选择以下选项的任意组合：

   • 存档到存储帐户
   • 流式传输到事件中心
   • 发送到 Log Analytics
   • 发送到合作伙伴解决方案

4. 选择要监视的日志类别和指标类别，并指定保留时间（天）。 保留时间仅适用于存储帐户。

5. 选择“保存”。

查看日志和指标

有多种方法可以查看日志和指标，如以下标题中所述。

使用“日志”窗格

1. 在 Azure 门户中，请转到 Azure Spring Apps 实例。

2. 要打开“日志搜索”窗格，请选择“日志” 。

3. 在“表”搜索框中，使用以下查询之一：

   • 若要查看日志，请输入查询，如以下示例所示：

     AppPlatformLogsforSpring
     | limit 50
     

   • 若要查看指标，请输入查询，如以下示例所示：

     AzureMetrics
     | limit 50
     

4. 若要查看搜索结果，请选择“运行”。

使用 Log Analytics

1. 在 Azure 门户的左窗格中选择“Log Analytics”。

2. 选择添加诊断设置时选择的 Log Analytics 工作区。

3. 要打开“日志搜索”窗格，请选择“日志” 。

4. 在“表”搜索框中，使用以下查询之一：

   • 若要查看日志，请输入查询，如以下示例所示：

     AppPlatformLogsforSpring
     | limit 50
     

   • 若要查看指标，请输入查询，如以下示例所示：

   AzureMetrics
   | limit 50
   

5. 若要查看搜索结果，请选择“运行”。

6. 可以通过设置筛选条件来搜索特定应用程序或实例的日志，如以下示例所示：

   AppPlatformLogsforSpring
   | where ServiceName == "YourServiceName" and AppName == "YourAppName" and InstanceName == "YourInstanceName"
   | limit 50
   

   注意

   == 区分大小写，但 =~ 不区分大小写。

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

使用存储帐户

1. 在 Azure 门户中，在左侧导航面板或搜索框中查找“存储帐户”。
2. 选择添加诊断设置时选择的存储帐户。
3. 若要打开“Blob 容器”窗格，请选择“Blob” 。
4. 若要查看应用程序日志，请搜索名为 insights-logs-applicationconsole 的容器。
5. 若要查看应用程序指标，请搜索名为 insights-metrics-pt1m 的容器。

若要了解有关将诊断信息发送到存储帐户的详细信息，请参阅在 Azure 存储中存储和查看诊断数据。

使用事件中心

1. 在 Azure 门户中，在左侧导航面板或搜索框中查找“事件中心”。

2. 搜索并选择添加诊断设置时选择的事件中心。

3. 若要打开“事件中心列表”窗格，请选择“事件中心” 。

4. 若要查看应用程序日志，请搜索名为 insights-logs-applicationconsole 的事件中心。

5. 若要查看应用程序指标，请搜索名为 insights-metrics-pt1m 的事件中心。

若要了解有关将诊断信息发送到事件中心的详细信息，请参阅使用事件中心流式处理热路径中的 Azure 诊断数据。

分析日志

Azure Log Analytics 与 Kusto 引擎一起运行，因此，你可以查询日志以进行分析。 有关使用 Kusto 查询日志的快速简介，请查看 Log Analytics 教程。

应用程序日志提供有关应用程序的运行状况、性能等的关键信息和详细日志。 下一节将介绍一些简单的查询，帮助你理解应用程序的当前和过去状态。

显示 Azure Spring Apps 中的应用程序日志

若要查看中 Azure Spring Apps 的应用程序日志列表（按时间排序，首先显示最新日志），请运行以下查询：

AppPlatformLogsforSpring
| project TimeGenerated , ServiceName , AppName , InstanceName , Log
| sort by TimeGenerated desc

显示包含错误或异常的日志条目

若要查看提及错误或异常的未排序日志条目，请运行以下查询：

AppPlatformLogsforSpring
| project TimeGenerated , ServiceName , AppName , InstanceName , Log
| where Log contains "error" or Log contains "exception"

使用此查询查找错误，或修改查询词以查找特定的错误代码或异常。

显示应用程序在过去一小时内报告的错误和异常数

若要创建显示应用程序在过去一小时记录的错误和异常数的饼图，请运行以下查询：

AppPlatformLogsforSpring
| where TimeGenerated > ago(1h)
| where Log contains "error" or Log contains "exception"
| summarize count_per_app = count() by AppName
| sort by count_per_app desc
| render piechart

显示包含特定主机的入口日志条目

若要查看特定主机生成的日志条目，请运行以下查询：

AppPlatformIngressLogs
| where TimeGenerated > ago(1h) and Host == "ingress-asc.test.microservices.azure.cn"
| project TimeGenerated, RemoteIP, Host, Request, Status, BodyBytesSent, RequestTime, ReqId, RequestHeaders
| sort by TimeGenerated

使用此查询可查找此特定主机的入口日志的响应 Status、RequestTime 和其他属性。

显示特定 requestId 的入口日志条目

若要查看特定 requestId 值 <request_ID> 的日志条目，请运行以下查询：

AppPlatformIngressLogs
| where TimeGenerated > ago(1h) and ReqId == "<request_ID>"
| project TimeGenerated, RemoteIP, Host, Request, Status, BodyBytesSent, RequestTime, ReqId, RequestHeaders
| sort by TimeGenerated

显示某个特定应用的生成日志条目

若要在生成过程中查看特定应用的日志条目，请运行以下查询：

AppPlatformBuildLogs
| where TimeGenerated > ago(1h) and PodName contains "<app-name>"
| sort by TimeGenerated

在特定生成阶段显示特定应用的生成日志条目

若要查看某个特定生成阶段中某个特定应用的日志条目，请运行以下查询。 请将 <app-name> 占位符替换为应用程序名称。 将 <build-stage> 占位符替换为以下值之一，它们代表生成过程的各个阶段：prepare、detect、restore、analyze、build、export 或 completion。

AppPlatformBuildLogs
| where TimeGenerated > ago(1h) and PodName contains "<app-name>" and ContainerName == "<build-stage>"
| sort by TimeGenerated

详细了解查询应用程序日志

Azure Monitor 通过使用 Log Analytics 为查询应用程序日志提供了广泛的支持。 若要了解有关此服务的详细信息，请参阅 Azure Monitor 中的日志查询入门。 若要详细了解如何生成查询以分析应用程序日志，请参阅 Azure Monitor 中的日志查询概述。

Azure 门户中的便捷入口点

使用以下步骤导航到包含预定义查询的“Log Analytics”窗格：

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

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

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

   

   此操作将导航到包含预定义查询的“Log Analytics”窗格。

还有其他可以查看日志的入口点。 还可以找到托管组件（如生成服务和服务注册表）的“查看日志”按钮。

常见问题 (FAQ)

如何将多行 Java 堆栈跟踪转换为单行 Java 堆栈跟踪？

有一种变通方法可以将多行堆栈跟踪转换为单行堆栈跟踪。 可以修改 Java 日志输出，重新设置堆栈跟踪消息格式，从而将换行符替换为标记。 如果使用 Java Logback 库，可以通过添加 %replace(%ex){'[\r\n]+', '\\n'}%nopex 来重新设置堆栈跟踪消息格式，如下所示：

<configuration>
    <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
            <pattern>
                level: %level, message: "%logger{36}: %msg", exceptions: "%replace(%ex){'[\r\n]+', '\\n'}%nopex"%n
            </pattern>
        </encoder>
    </appender>
    <root level="INFO">
        <appender-ref ref="CONSOLE"/>
    </root>
</configuration>

然后，可以在 Log Analytics 中将令牌替换为换行符，如以下示例所示：

AppPlatformLogsforSpring
| extend Log = array_strcat(split(Log, '\\n'), '\n')

可以尝试对其他 Java 日志库使用相同的策略。

后续步骤

• 快速入门：在 Azure Spring Apps 中部署第一个 Spring Boot 应用