内容简介:MinBoxLogging是一款分布式、零侵入式的链路日志分析框架,支持 SpringCloud微服务架构下配置使用,内部封装了 RestTemplate、 OpenFeign两种方式透传链路信息。 1.0.2.RELEASE 更新内容 升级使用minbox-framewor...#########
MinBoxLogging
是一款分布式、零侵入式的链路日志分析框架,支持 SpringCloud
微服务架构下配置使用,内部封装了 RestTemplate
、 OpenFeign
两种方式透传链路信息。
1.0.2.RELEASE 更新内容
- 升级使用minbox-framework版本为1.0.2.RELEASE
- 添加GlobalLogging全局业务日志的概念
- 支持将GlobalLog日志保存到数据库
- 修改LocalNotice本次日志通知的优先级
- 修改AdminNotice上报日志到Admin的优先级
- 添加支持定时上报到Admin功能支持
- 添加支持debug、info、error等类型的GlobalLog上报
- 添加GlobalLoggingMemoryStorage用于内存临时存储一次请求的GlobalLog列表
- 修改日志上报到Admin时的Content-Type
- 添加logging_global_logs表结构
- 支持采集error等级的GlobalLog堆栈错误信息
文档
使用文档请访问:https://gitee.com/minbox-projects/minbox-logging/wikis
最佳集成实践源码
minbox-logging
与 ApiBoot
都是属于 minbox-projects
开源组织开源框架, ApiBoot
来统一做基础框架的集成,也不例外集成 minbox-logging
。
集成实践源码:ApiBoot Logging AutoConfiguration
实践系列文章
ApiBoot
对 minbox-logging
基于 SpringBoot
进行了封装,针对 client、admin
分别提供了对应的 Starter
,来快速集成。
集成后的实践文章,可以访问作者博客:https://blog.yuqiyu.com/apiboot-all-articles.html 了解详情。
零侵入式
MinBoxLogging
无需使用注解配置采集链路日志,只需要添加 依赖
后简单配置 MinboxLogginAdmin
的相关 地址
或 服务名称
即可,每次在收到请求时就会把请求对应的链路日志详细信息自动上报到 MinBoxLoggingAdmin
进行后续分析、告警通知等。
链路日志分析图
日志客户端
链路日志
的采集端,也就是具体的业务服务,只需要添加 minbox-logging-client
客户端进行简单的配置就可以实现日志的采集以及日志的异步上报。
日志管理端
对外提供 安全的日志上报
功能,通过整合 SpringSecurity
来完成 BasicAuth
基础认证,管理端接收到采集端上报的日志后会自动将日志存储到数据库,考虑到扩展方便,同样也提供监听 日志上报事件(ReportLogEvent)
的方式来自定义存储日志到 消息队列
、 logstash
、 文件
等存储介质。
日志管理界面
MinBoxLoggingAdmin
提供了界面管理应用程序,通过 VUE
前端框架进行编写界面与管理端的接口通讯,实时展示 链路日志
、 日志采集服务列表
等信息,可查看每条链路日志的详细信息(包含:请求头、请求参数、响应内容、响应头、状态码、异常堆栈信息等)。
整合Spring Security后的登录界面
可以直接整合 SpringSecurity
来完成 Basic
安全认证。
上报日志的服务列表
请求日志的采集服务在第一次上报时,会自动创建一条服务记录,服务的唯一性是根据: 服务ID
+ 服务IP
+ 服务端Port
来进行定义。
在每次上报日志成功后会修改服务的最后一次上报时间。
链路日志列表
链路日志是我们访问的入口服务生成,比如: bff-user
-> user-service
,链路日志产生的位置则是 bff-user
服务,链路日志是接口 请求的入口
也是做出 响应的结束位置
,因此我们可以在页面上查看接口的请求 参数详情
、 头信息
以及 响应的内容
,至于链路日志内的 日志单元
目前界面还未做展示,可以根据 traceId
链路日志编号自行去数据库查询。
链路日志详情
每一个请求的链路日志都会包含上图中的全部字段,从请求开始 -> 响应结束一条链路闭合记录。
安全性
MinBoxLoggingAdminUI
内部提供了 login.html
登录页面,可以整合 SpringSecurity
通过配置 loginPageUrl
登录跳转地址来使用内置的登录页面,当然也可以自定义登录页面。
可与 MinBoxLoggingAdmin
共同使用 SpringSecurity
的相同配置提升安全性。
文档
当前版本的文档,请访问Wikis
快速开始
请访问快速开始的 wikis
文档来查看并快速接入 MinBoxLogging
,快速接入文档
源码方式构建
MinBoxLogging
使用 Maven
进行构建项目。
先决条件
源码拉取需使用 Git
,具体使用方式详见安装 Git
源码采用 JDK1.8
版本进行编写,请注意修改使用项目的 JDK
版本,JDK 1.8下载地址
需本地安装 Maven
环境,Maven 下载地址
因 logging-admin-ui
所需 vue-cli-service
命令支持,本地需要安装 vue-cli
。
拉取源码到本地
git clone git@gitee.com:minbox-projects/minbox-logging.git
安装到本地Maven仓库
mvn install
编译 & 打包生成jar包
mvn clean package
Maven仓库依赖构建
MinBoxLogging
内的模块都已经上传到 ApacheMavenCenter
中央仓库,添加对应的依赖到 pom.xml
会自动下载到本地。
欢迎提交贡献代码
MinBoxLogging
欢迎广大开发者创建 PullRequest
来贡献代码,代码通过审核后会被合并到 master
主分支。
开源许可
MinBoxLogging
采用 Apache2
开源许可。
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持 码农网
猜你喜欢:- 聊聊分布式链路追踪
- 分布式集群环境下调用链路追踪
- 个推基于Zipkin的分布式链路追踪实践
- 蚂蚁金服分布式链路跟踪组件 SOFATracer 总览 | 剖析
- 在线业务问题分析定位利器:小米分布式链路追踪平台(二)
- 蚂蚁金服分布式链路跟踪组件 SOFATracer 总览 | 剖析
本站部分资源来源于网络,本站转载出于传递更多信息之目的,版权归原作者或者来源机构所有,如转载稿涉及版权问题,请联系我们。