1.6. 日志处理程序
日志处理程序是一个日志记录组件,负责将日志事件委托给接收者。Quarkus 包括几个不同的日志处理程序: 控制台、file 和 syslog。
特色示例使用 com.example
作为日志记录类别。
1.6.1. 控制台日志处理程序
控制台日志处理程序默认为启用,它会将所有日志事件定向到应用程序的控制台,通常是系统的 stdout
。
全局配置示例:
quarkus.log.console.format=%d{yyyy-MM-dd HH:mm:ss} %-5p [%c] (%t) %s%e%n
每个category 配置示例:
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
每个category 配置示例:
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 日志处理程序
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
每个category 配置示例:
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 日志记录配置 参考。