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
  • 每个类别配置示例:

    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

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

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
  • 每个类别配置示例:

    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

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

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
  • 每个类别配置示例:

    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

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

1.6.4. 套接字日志处理程序

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

  • 全局配置示例:

    quarkus.log.socket.enable=true
    quarkus.log.socket.endpoint=localhost:4560

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

Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

關於紅帽

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

让开源更具包容性

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

关于红帽文档

Legal Notice

Theme

© 2026 Red Hat
返回顶部