这个项目能做什么

Pulse 是一个用于 Spring Boot 的生产级可观测性启动器,集成了默认技术栈中通常缺失的监控和可靠性功能。它仅需一个 Maven 依赖即可运行,无需任何代理、字节码织入或自定义运行时。 默认启用的核心功能包括:基数防火墙,限制每个指标的标签基数,防止指标成本爆炸;超时预算传播,在 HTTP 和 Kafka 调用中携带剩余截止时间;跨 @Async、@Scheduled 和 Kafka 消费者的自动上下文传播;跟踪上下文保护,检测上游 traceparent 剥离;与 OTel 对齐的结构化日志,包含部署、提交、Pod、区域元数据及 PII 掩码;以及稳定的 SHA-256 异常指纹,可在不同部署中分组同一缺陷。 额外的分布式系统功能包括:依赖健康映射、重试放大检测、多租户上下文、请求优先级、容器感知内存指标、Kafka 基于时间的滞后、请求扇出跟踪、SLO 即代码(支持 PrometheusRule 生成)、Resilience4j 自动插桩、后台任务可观测性、数据库 N+1 和慢查询检测、Caffeine 缓存绑定、OpenFeature 关联、持续分析关联、宽事件 API、优雅排空(含 OTel 刷新)、集群配置漂移检测、实时诊断 actuator UI 以及采样控制。 该库原生支持 Micrometer 和 OTLP,兼容 Java 21 和 25、Spring Boot 4.0+、Logback 和 Log4j2,以及 GraalVM 原生镜像(尽力支持)。它附带预构建的 Grafana 仪表板、告警和运行手册。性能开销已通过 JMH 基准测试:在 JDK 21 Apple M 系列硬件上,基数防火墙热路径约为 17 纳秒/操作,跨度事件发射约为 25 纳秒/操作。 构建质量包括 Error Prone、NullAway、Spotless、JaCoCo 覆盖率门禁、CodeQL 安全扫描、CycloneDX SBOM 生成、Sigstore 无密钥签名、多 JDK CI 和可复现构建。该项目采用 MIT 许可证,并作为 io.github.arun0009:pulse-spring-boot-starter 发布在 Maven Central 上。