日志

如果你的终端支持 ANSI，则使用彩色输出来提高可读性。 你可以将 spring.output.ansi.enabled 设置为 支持的值 来覆盖自动检测。

通过使用 %clr 转换字来配置颜色编码。 在最简单的形式中，转换器根据日志级别为输出着色，如下例所示：

下表描述了日志级别到颜色的映射：

或者，你可以通过将其作为转换的选项来指定应使用的颜色或样式。 例如，要使文本变为黄色，请使用以下设置：

支持以下颜色和样式：

Elastic Common Schema 是一种基于 JSON 的日志格式。

要启用 Elastic Common Schema 日志格式，请将相应的 format 属性设置为 ecs：

日志行看起来像这样：

此格式还会将 MDC 中包含的每个键值对添加到 JSON 对象中。 你还可以使用 SLF4J fluent logging API 通过 addKeyValue 方法将键值对添加到记录的 JSON 对象中。

可以使用 logging.structured.ecs.service 属性自定义 service 值：

Graylog Extended Log Format 是 Graylog 日志分析平台的基于 JSON 的日志格式。

要启用 Graylog Extended Log Format，请将相应的 format 属性设置为 gelf：

日志行看起来像这样：

此格式还会将 MDC 中包含的每个键值对添加到 JSON 对象中。 你还可以使用 SLF4J fluent logging API 通过 addKeyValue 方法将键值对添加到记录的 JSON 对象中。

可以使用 logging.structured.gelf 属性自定义多个字段：

Logstash JSON 格式 是一种基于 JSON 的日志格式。

要启用 Logstash JSON 日志格式，请将相应的 format 属性设置为 logstash：

日志行看起来像这样：

此格式还会将 MDC 中包含的每个键值对添加到 JSON 对象中。 你还可以使用 SLF4J fluent logging API 通过 addKeyValue 方法将键值对添加到记录的 JSON 对象中。

如果你添加 markers，这些将显示在 JSON 的 tags 字符串数组中。

Spring Boot 尝试为结构化日志输出的 JSON 名称和值选择合理的默认值。 但是，有时你可能需要根据自己的需求对 JSON 进行小的调整。 例如，你可能想要更改一些名称以匹配你的日志摄取系统的期望。 你可能还想过滤掉某些成员，因为你发现它们没有用。

以下属性允许你更改结构化日志 JSON 的写入方式：

例如，以下将排除 log.level，将 process.id 重命名为 procid 并添加固定的 corpname 字段：

每当使用异常记录消息时，完整的堆栈跟踪都会包含在 JSON 输出中。 这些信息量可能对你的日志摄取系统来说处理成本很高，因此你可能想要调整堆栈跟踪的打印方式。

为此，你可以使用以下一个或多个属性：

例如，以下将使用根优先堆栈跟踪，限制其长度，并包含哈希值。

Spring Boot 中的结构化日志支持是可扩展的，允许你定义自己的自定义格式。 为此，实现 StructuredLogFormatter 接口。使用 Logback 时，泛型类型参数必须是 ILoggingEvent，使用 Log4j2 时必须是 LogEvent（这意味着你的实现与特定的日志系统绑定）。 然后使用日志事件调用你的实现，并返回要记录的 String，如下例所示：

如你在示例中所见，你可以返回任何格式，不必是 JSON。

要启用你的自定义格式，请将 logging.structured.format.console 或 logging.structured.format.file 属性设置为你实现的完全限定类名。

你的实现可以使用一些构造函数参数，这些参数会自动注入。 有关更多详细信息，请参阅 StructuredLogFormatter 的 JavaDoc。

<springProfile> 标签允许你根据活动的 Spring profiles 选择性地包含或排除配置部分。 配置文件部分在 <configuration> 元素内的任何位置都受支持。 使用 name 属性指定哪个配置文件接受配置。 <springProfile> 标签可以包含配置文件名称（例如 staging）或配置文件表达式。 配置文件表达式允许表达更复杂的配置文件逻辑，例如 production & (eu-central | eu-west)。 有关更多详细信息，请查看 Spring Framework 参考指南。 以下列表显示了三个示例配置文件：

<springProperty> 标签允许你暴露 Spring Environment 中的属性以供 Logback 使用。 如果你想在 Logback 配置中访问 application.properties 文件中的值，这很有用。 该标签的工作方式与 Logback 的标准 <property> 标签类似。 但是，不是指定直接的 value，而是指定属性的 source（来自 Environment）。 如果你需要将属性存储在 local 作用域之外，可以使用 scope 属性。 如果你需要一个后备值（以防属性未在 Environment 中设置），可以使用 defaultValue 属性。 以下示例显示了如何暴露属性以供 Logback 使用：

<SpringProfile> 标签允许你根据活动的 Spring profiles 选择性地包含或排除配置部分。 配置文件部分在 <Configuration> 元素内的任何位置都受支持。 使用 name 属性指定哪个配置文件接受配置。 <SpringProfile> 标签可以包含配置文件名称（例如 staging）或配置文件表达式。 配置文件表达式允许表达更复杂的配置文件逻辑，例如 production & (eu-central | eu-west)。 有关更多详细信息，请查看 Spring Framework 参考指南。 以下列表显示了三个示例配置文件：

如果你想在 Log4j2 配置中引用 Spring Environment 中的属性，可以使用带有 spring: 前缀的 lookups。 如果你想在 Log4j2 配置中访问 application.properties 文件中的值，这很有用。

以下示例显示了如何设置名为 applicationName 和 applicationGroup 的 Log4j2 属性，这些属性从 Spring Environment 中读取 spring.application.name 和 spring.application.group：

Log4j2 支持许多 系统属性，可用于配置各种项目。 例如，log4j2.skipJansi 系统属性可用于配置 ConsoleAppender 是否尝试在 Windows 上使用 Jansi 输出流。

在 Log4j2 初始化之后加载的所有系统属性都可以从 Spring Environment 中获取。 例如，你可以在 application.properties 文件中添加 log4j2.skipJansi=false，以使 ConsoleAppender 在 Windows 上使用 Jansi。