JAVA也能用上Seq啦

前言

在.NET生态中，Serilog 凭借其强大的结构化日志记录功能和与Seq的无缝集成，已经成为许多开发者的首选日志记录工具。Seq 作为一个日志检索和仪表板工具，能够将日志中的插值转换为结构化数据，极大地方便了开发者快速检索日志、定位问题并进行简单的统计分析。这种便捷性让人难以割舍。

背景

最近需要搞一个JAVA项目，当开发环境转移到Java生态，尤其是采用Spring Boot框架时，许多开发者发现自己不得不面对一个新的挑战。Spring Boot的默认日志框架Logback，在处理日志结构化方面并不如Serilog那样给人以深刻印象。习惯了Seq带来的便捷，我自然希望在Java环境中也能找到类似的解决方案。

幸运的是，Seq提供了通过GELF（GrayLog Extended Log Format）接收日志的能力，这为Java生态中的日志结构化提供了可能。在Spring Boot 3.2中，通过引入logback-gelf的JAR包，开发者可以实现将日志以GELF格式通过UDP发送到Seq，尽管这种方式对结构化支持并不是非常友好。

前置安装

• 安装Seq & GELF服务端

  version: '3'
  services:
    seq-input-gelf:
  	image: datalust/seq-input-gelf:latest
  	depends_on:
  	  - seq
  	ports:
  	  - "12201:12201/udp"
  	environment:
  	  SEQ_ADDRESS: "http://seq:5341"
  	restart: unless-stopped
    seq:
  	image: datalust/seq:latest
  	ports:
  	  - "5341:80"
  	environment:
  	  ACCEPT_EULA: Y
  	restart: unless-stopped
  	volumes:
  	  - ./seq-data:/data
  

• 安装Gelf Input

Spring boot 3 配置

• 安装logback-gelf包（gradle）

  implementation 'de.siegmar:logback-gelf:6.0.0'
  

• 在classpath处添加 logback-spring.xml

  
  	
  		
  		512
  		
  		0
  		
  		
  	
  	
  		
  			
  				[%white(%d{HH:mm:ss.SSS}) %highlight(%-5level)] [%blue(%t)] %yellow(%C{1}): %msg%n%throwable
  			
  		
  	
  	
  		
  		{{替换为Seq-Input-GELF的UDP的IP}}
  		12201
  		508
  		GZIP
  		
  		
  			false
  			true
  			false
  			true
  			false
  			false
  			false
  			
  				%msg%n
  			
  			
  				%msg%n
  			
  			false
  			
  			app_name:java-demo
  			
  			
  			
  		
  	
  
  	
  	
  		
  		
  	
  
  
  

完成上面简单配置，启动项目，如果配置没问题运气好的话在Seq上会看到日志，从配置上看GELF采用异步Appender写入，并有队列缓冲区限制，所以不用考虑性能问题，但存在一个问题，当你用插值写入时Seq并未将插值转化为K/V形式保存，解下来解决下这个。

实现插值格式化写入

熟悉Serilog的朋友们都知道，在.Net平台上记录日志是可以这样的

// Seq 会保存一个{"lang":'C#'}的 K/V
logger.LogInformation("Hello {lang}","C#");
// Serilog在格式化时会把config序列化
logger.LogInformation("Web config: {@config}",config);

这个还是很优雅的，反观slf4j ，只能使用{}，在Seq上怎么传入Key呢，笔者想到的是自己做个约定把。
可以在写日志时对于参数化format约定为"[边界][参数key]={}"。举个例子

Logger logger = LoggerFactory.getLogger(LogseqsampleApplication.class);

logger.info("Hello {}","World");
logger.info("Hello world={}","World");
logger.info("log config={}",Map.of("k1","v1"));
logger.info("log config={}",Map.of("key",new String[]{"value1","value2"}));
logger.info("log config={}",Map.of("key",Map.of("k1","v1")));

可以看出 config或者world参数前都有空格，即边界符。
边界符可以为以下字符

private static final char[] Delimiter = {',',' ','.','。'};

看起来还不错，既然我们定义了一些默认规则，那就只能自己写解析了，翻看下源码，发现可以在Encoder这里做重写，不错。

实现Encoder

直接给个传送门com.leesiper.logseqsample.utils.SeqEncoder中找到，可自行查看，有了Encoder，
替换下logback-spring.xml中的

替换为(可自行调整class)

再次启动项目，看看Seq中是不是写入了日志，展开后会看到参数化转换成了K/V，可直接进行检索了。Seq不像ELasticsearch,写入新的字段后需要重建索引，Seq是动态创建的，底层是自主研发的，有着简单易用易部署的特点，确实不错

这一发现对于习惯了.NET生态中Serilog和Seq搭配使用的开发者来说，无疑是一个好消息。它意味着，即使在转向Java生态时，也无需放弃熟悉的日志记录习惯和工具。通过适当的配置和一些定制化开发，开发者可以在Spring Boot项目中实现与.NET生态相似的日志记录体验，继续享受快速检索和日志问题定位的便利。

总之，通过探索和创新，Java生态中的开发者同样能够享受到Serilog和Seq带来的高效日志处理体验。这不仅展示了技术跨界整合的可能性，也再次证明了开发者社区在面对挑战时不断探索和创新的精神。

Git示例仓库
spring-logback-seq