第 4 章 配置 JSON 日志记录格式


您可以将控制台日志的输出格式更改为 JSON,以便更轻松地处理和存储日志信息以便稍后进行分析。

要配置 JSON 日志记录格式,您需要在 Quarkus 项目中添加 quarkus-logging-json 扩展。quarkus-logging-json 扩展替换了控制台配置中的输出格式配置。将忽略格式字符串和颜色设置等控制台配置项。其他控制台配置项,包括那些控制异步日志记录和日志记录级别,继续应用。

流程

  1. quarkus-logging-json 扩展添加到应用程序的 pom.xml 文件中:

    pom.xml

      <dependencies>
        <!-- ... your other dependencies are here ... -->
        <dependency>
          <groupId>io.quarkus</groupId>
          <artifactId>quarkus-logging-json</artifactId>
        </dependency>
      </dependencies>
    Copy to Clipboard Toggle word wrap

  2. (可选)在 application.properties 文件中为 JSON 日志记录设置配置集相关配置:

    src/main/resources/application.properties

    %<profile>.<configuration_key>=<value>
    Copy to Clipboard Toggle word wrap

    以下示例演示了如何为开发和测试配置集禁用 JSON 日志记录:

    src/main/resources/application.properties

    %dev.quarkus.log.console.json=false
    %test.quarkus.log.console.json=false
    Copy to Clipboard Toggle word wrap

4.1. JSON 日志记录配置属性

您可以使用以下配置属性配置 JSON 日志扩展:

Expand
表 4.1. JSON 配置属性
配置属性描述类型默认

quarkus.log.console.json

启用 JSON 控制台格式化扩展。

布尔值

true

quarkus.log.console.json.pretty-print

启用 JSON 记录的优质打印。[a]

布尔值

false

quarkus.log.console.json.date-format

日期的格式。默认 字符串设置要使用的默认格式。

字符串

default

quarkus.log.console.json.record-delimiter

特殊记录分隔符.默认情况下,换行符用作分隔符。

字符串

 

quarkus.log.console.json.zone-id

区的 ID。默认 字符串设置要使用的默认区。

字符串

default

quarkus.log.console.json.exception-output-type

例外的输出类型。

详细、格式化、详细格式

详细

quarkus.log.console.json.print-details

启用详细打印日志。详情包括源类名称、源文件名、源方法名称和源行号。[b]

布尔值

false

[a] 有些处理器和 JSON 解析器可能无法读取打印的输出。
[b] 在从调用者检索值时,打印详细信息可能非常昂贵。
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

Theme

© 2026 Red Hat
返回顶部