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。
