第 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 配置属性
配置属性描述类型Default(默认)

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

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

字符串

 

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