MinBox Logging
MinBoxLogging
是一款分布式、零侵入式的链路日志分析框架,支持 SpringCloud
微服务架构下配置使用,内部封装了 RestTemplate
、 OpenFeign
两种方式透传链路信息。
零侵入式
MinBoxLogging
无需使用注解配置采集链路日志,只需要添加 依赖
后简单配置 MinboxLogginAdmin
的相关 地址
或 服务名称
即可,每次在收到请求时就会把请求对应的链路日志详细信息自动上报到 MinBoxLoggingAdmin
进行后续分析、告警通知等。
链路日志分析图
日志客户端
链路日志
的采集端,也就是具体的业务服务,只需要添加 minbox-logging-client
客户端进行简单的配置就可以实现日志的采集以及日志的异步上报。
日志管理端
对外提供 安全的日志上报
功能,通过整合 SpringSecurity
来完成 BasicAuth
基础认证,管理端接收到采集端上报的日志后会自动将日志存储到数据库,考虑到扩展方便,同样也提供监听 日志上报事件(ReportLogEvent)
的方式来自定义存储日志到 消息队列
、 logstash
、 文件
等存储介质。
日志管理界面
MinBoxLoggingAdmin
提供了界面管理应用程序,通过 VUE
前端框架进行编写界面与管理端的接口通讯,实时展示 链路日志
、 日志采集服务列表
等信息,可查看每条链路日志的详细信息(包含:请求头、请求参数、响应内容、响应头、状态码、异常堆栈信息等)。
初版更新内容
- 完成https://gitee.com/minbox-projects/minbox-logging/issues/I10UR2特性
- 完成https://gitee.com/minbox-projects/minbox-logging/issues/I111N0特性
- 完成https://gitee.com/minbox-projects/minbox-logging/issues/I11L13特性
- 完成https://gitee.com/minbox-projects/minbox-logging/issues/I11NPP特性
- 修复https://gitee.com/minbox-projects/minbox-logging/issues/I11NPT
- 支持SpringCloud服务注册中心获取logging-admin管理端地址上报日志
- 支持RestTemplate透传链路信息
- 支持OpenFeign透传链路信息
- 支持SpringSecurity安全上报请求日志
- 支持指定logging-admin管理地址上报日志
- 支持数据库存储日志信息、采集日志服务基本信息
- 支持自定义存储方式
- 支持自定义生成traceId
- 支持自定义生成spanId
- 支持控制台打印日志信息
- 支持控制台格式化日志信息
- 支持随机权重负载均衡上报日志到logging-admin
- 支持平滑轮询权重负载均衡上报日志到logging-admin
- 提供logging-admin-ui界面查看日志信息、上报日志服务信息
- 支持定时上报日志
源码地址
https://gitee.com/minbox-projects/minbox-logging
文档地址
https://gitee.com/minbox-projects/minbox-logging/wikis
提交使用中遇到的问题
遇到你在集成使用过程中遇到了问题,请提交issues,提交地址:创建Issues
ApiBoot集成实践示例
ApiBoot
作为 MinBox
开源组织的组件最佳集成方案,在第一时间会进行整合minbox-projects开源组织内新发布的组件, MinBoxLogging
整合实践请访问 ApiBoot
源码,整合源码详见 org.minbox.framework.api.boot.autoconfigure.logging
。