详解SpringBoot集成Hera日志管理新方案

<!-- Hera日志客户端依赖 -->
<dependency>
    <groupId>com.hera</groupId>
    <artifactId>hera-log-spring-boot-starter</artifactId>
    <version>2.5.3</version>
</dependency>
<!-- 可选：链路追踪依赖，实现跨服务日志串联 -->
<dependency>
    <groupId>com.hera</groupId>
    <artifactId>hera-trace-spring-boot-starter</artifactId>
    <version>2.5.3</version>
</dependency>

spring:
  application:
    name: order-service # 作为Hera日志的服务标签
hera:
  log:
    agent-address: 192.168.1.101:8888,192.168.1.102:8888 # Agent集群地址
    level: INFO # 生产环境建议设为WARN，减少日志量
    custom-fields: # 自定义业务字段，用于精准筛选
      - key: businessType
        value: ${spring.application.name}-order
      - key: env
        value: ${spring.profiles.active:dev}
      - key: userId # 从ThreadLocal获取用户ID，需自定义实现类
        value-provider: com.example.order.config.HeraUserIdProvider
  trace:
    enabled: true # 开启链路追踪
    sampling-rate: 1.0 # 生产高并发场景可设0.5，平衡性能与追踪效果
    trace-id-header: X-Hera-Trace-Id # 跨服务传递链路ID的请求头

@Component
public class HeraUserIdProvider implements HeraCustomFieldProvider {
    @Override
    public String getValue() {
        UserContext context = UserContextHolder.getCurrentContext();
        return context != null ? context.getUserId() : "unknown";
    }
}

@Service
public class OrderService {
    private static final Logger log = LoggerFactory.getLogger(OrderService.class);
    public Order createOrder(OrderCreateDTO dto) {
        Order order = new Order();
        order.setOrderNo(generateOrderNo());
        order.setUserId(dto.getUserId());
        // 日志自动携带businessType、env、userId、traceId
        log.info("创建订单成功，订单号：{}，用户ID：{}", order.getOrderNo(), order.getUserId());
        try {
            orderMapper.insert(order);
        } catch (Exception e) {
            log.error("创建订单失败，订单号：{}", order.getOrderNo(), e);
            throw new BusinessException("订单创建失败");
        }
        return order;
    }
}