1.6. 日志处理程序


日志处理程序是一个日志组件,负责将日志事件提交到接收者。红帽构建的 Quarkus 包括几个不同的日志处理程序: consolefilesyslog

功能示例使用 com.example 作为日志记录类别。

1.6.1. 控制台日志处理程序

控制台日志处理程序默认启用,它会将所有日志事件定向到应用的控制台,通常是系统的 stdout

  • 全局配置示例:

    quarkus.log.console.format=%d{yyyy-MM-dd HH:mm:ss} %-5p [%c] (%t) %s%e%n
    Copy to Clipboard Toggle word wrap
  • 每个类别配置示例:

    quarkus.log.handler.console.my-console-handler.format=%d{yyyy-MM-dd HH:mm:ss} [com.example] %s%e%n
    
    quarkus.log.category."com.example".handlers=my-console-handler
    quarkus.log.category."com.example".use-parent-handlers=false
    Copy to Clipboard Toggle word wrap

有关其配置的详情,请查看 控制台日志记录配置 参考。

1.6.2. 文件日志处理程序

要将事件记录到应用程序主机上的文件中,请使用 Quarkus 文件日志处理程序。文件日志处理程序默认为禁用,因此您必须首先启用它。

Quarkus 文件日志处理程序支持日志文件轮转。

日志文件轮转通过保留指定数量的备份文件来确保有效的日志管理,同时保持主日志文件更新,并以可管理的大小保持更新。

  • 全局配置示例:

    quarkus.log.file.enable=true
    quarkus.log.file.path=application.log
    quarkus.log.file.format=%d{yyyy-MM-dd HH:mm:ss} %-5p [%c] (%t) %s%e%n
    Copy to Clipboard Toggle word wrap
  • 每个类别配置示例:

    quarkus.log.handler.file.my-file-handler.enable=true
    quarkus.log.handler.file.my-file-handler.path=application.log
    quarkus.log.handler.file.my-file-handler.format=%d{yyyy-MM-dd HH:mm:ss} [com.example] %s%e%n
    
    quarkus.log.category."com.example".handlers=my-file-handler
    quarkus.log.category."com.example".use-parent-handlers=false
    Copy to Clipboard Toggle word wrap

有关其配置的详情,请查看 文件日志记录配置 参考。

1.6.3. syslog log handler

Quarkus 中的 syslog 处理程序遵循 Syslog 协议,该协议用于在类似 UNIX 的系统上发送日志消息。它使用 RFC 5424 中定义的协议。

默认情况下禁用 syslog 处理程序。启用后,它会将所有日志事件发送到 syslog 服务器,通常是应用程序的本地 syslog 服务器。

  • 全局配置示例:

    quarkus.log.syslog.enable=true
    quarkus.log.syslog.app-name=my-application
    quarkus.log.syslog.format=%d{yyyy-MM-dd HH:mm:ss} %-5p [%c] (%t) %s%e%n
    Copy to Clipboard Toggle word wrap
  • 每个类别配置示例:

    quarkus.log.handler.syslog.my-syslog-handler.enable=true
    quarkus.log.handler.syslog.my-syslog-handler.app-name=my-application
    quarkus.log.handler.syslog.my-syslog-handler.format=%d{yyyy-MM-dd HH:mm:ss} [com.example] %s%e%n
    
    quarkus.log.category."com.example".handlers=my-syslog-handler
    quarkus.log.category."com.example".use-parent-handlers=false
    Copy to Clipboard Toggle word wrap

有关其配置的详情,请查看 Syslog 日志记录配置 参考。

1.6.4. 套接字日志处理程序

此处理程序将日志发送到套接字。套接字日志处理程序默认为禁用;使其能够使用它。启用后,它会将所有日志事件发送到套接字,如 Logstash 服务器。

  • 全局配置示例:

    quarkus.log.socket.enable=true
    quarkus.log.socket.endpoint=localhost:4560
    Copy to Clipboard Toggle word wrap

通常,此处理程序与 quarkus-logging-json 扩展一起使用,将 ECS 格式的日志发送到 Elasticsearch 实例。有关示例配置,请参阅 集中日志管理指南

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

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

让开源更具包容性

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

關於紅帽

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

Theme

© 2025 Red Hat