1.6. 日志处理程序
日志处理程序是一个日志组件,负责将日志事件提交到接收者。红帽构建的 Quarkus 包括几个不同的日志处理程序: console、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
quarkus.log.console.format=%d{yyyy-MM-dd HH:mm:ss} %-5p [%c] (%t) %s%e%n
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 每个类别配置示例:
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
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 Copied! Toggle word wrap Toggle overflow
有关其配置的详情,请查看 控制台日志记录配置 参考。
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.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 Copied! Toggle word wrap Toggle overflow 每个类别配置示例:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
有关其配置的详情,请查看 文件日志记录配置 参考。
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.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 Copied! Toggle word wrap Toggle overflow 每个类别配置示例:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
有关其配置的详情,请查看 Syslog 日志记录配置 参考。
1.6.4. 套接字日志处理程序 复制链接链接已复制到粘贴板!
此处理程序将日志发送到套接字。套接字日志处理程序默认为禁用;使其能够使用它。启用后,它会将所有日志事件发送到套接字,如 Logstash 服务器。
全局配置示例:
quarkus.log.socket.enable=true quarkus.log.socket.endpoint=localhost:4560
quarkus.log.socket.enable=true quarkus.log.socket.endpoint=localhost:4560
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
通常,此处理程序与 quarkus-logging-json
扩展一起使用,将 ECS 格式的日志发送到 Elasticsearch 实例。有关示例配置,请参阅 集中日志管理指南。