MinBox Logging

MinBoxLogging是一款分布式、零侵入式的链路日志分析框架，支持 SpringCloud微服务架构下配置使用，内部封装了 RestTemplate、 OpenFeign两种方式透传链路信息。

零侵入式

MinBoxLogging无需使用注解配置采集链路日志，只需要添加 依赖后简单配置 MinboxLogginAdmin的相关 地址或 服务名称即可，每次在收到请求时就会把请求对应的链路日志详细信息自动上报到 MinBoxLoggingAdmin进行后续分析、告警通知等。

链路日志分析图

日志客户端

链路日志的采集端，也就是具体的业务服务，只需要添加 minbox-logging-client客户端进行简单的配置就可以实现日志的采集以及日志的异步上报。

日志管理端

对外提供 安全的日志上报功能，通过整合 SpringSecurity来完成 BasicAuth基础认证，管理端接收到采集端上报的日志后会自动将日志存储到数据库，考虑到扩展方便，同样也提供监听 日志上报事件(ReportLogEvent)的方式来自定义存储日志到 消息队列、 logstash、 文件等存储介质。

日志管理界面

MinBoxLoggingAdmin提供了界面管理应用程序，通过 VUE前端框架进行编写界面与管理端的接口通讯，实时展示 链路日志、 日志采集服务列表等信息，可查看每条链路日志的详细信息（包含：请求头、请求参数、响应内容、响应头、状态码、异常堆栈信息等）。

初版更新内容

1. 完成https://gitee.com/minbox-projects/minbox-logging/issues/I10UR2特性
2. 完成https://gitee.com/minbox-projects/minbox-logging/issues/I111N0特性
3. 完成https://gitee.com/minbox-projects/minbox-logging/issues/I11L13特性
4. 完成https://gitee.com/minbox-projects/minbox-logging/issues/I11NPP特性
5. 修复https://gitee.com/minbox-projects/minbox-logging/issues/I11NPT
6. 支持SpringCloud服务注册中心获取logging-admin管理端地址上报日志
7. 支持RestTemplate透传链路信息
8. 支持OpenFeign透传链路信息
9. 支持SpringSecurity安全上报请求日志
10. 支持指定logging-admin管理地址上报日志
11. 支持数据库存储日志信息、采集日志服务基本信息
12. 支持自定义存储方式
13. 支持自定义生成traceId
14. 支持自定义生成spanId
15. 支持控制台打印日志信息
16. 支持控制台格式化日志信息
17. 支持随机权重负载均衡上报日志到logging-admin
18. 支持平滑轮询权重负载均衡上报日志到logging-admin
19. 提供logging-admin-ui界面查看日志信息、上报日志服务信息
20. 支持定时上报日志

源码地址

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。