用途：帮助在 Java 项目中实现或改进日志与可观测性实践，覆盖框架选型、日志级别、编码规范、配置、安全、监控告警与验证测试。
主要能力：选择 SLF4J 门面搭配 Logback 或 Log4j2；统一使用 ERROR、WARN、INFO、DEBUG、TRACE 级别；采用参数化日志、正确处理异常、避免记录敏感数据；按环境配置 logback.xml 或 log4j2.xml、输出格式与日志轮转；安全方面包括脱敏、访问控制、安全传输及 GDPR/HIPAA 合规；监控告警涉及 ELK、Splunk、Loki 等集中聚合与自动告警；通过测试断言日志消息、格式、级别并评估性能影响。
使用方式：参考按核心领域组织的好/坏代码示例，按适用示例应用建议。应用前须先确认项目可编译：执行 ./mvnw compile 或 mvn compile；若编译失败立即停止，解决后再继续。应用改进后执行 ./mvnw clean verify 或 mvn clean verify 进行完整验证；应用前先阅读 references/126-java-observability-logging.md 获取详细示例、约束与防护说明。
适用场景：Java 服务日志规范落地、日志级别与配置治理、敏感信息合规、集中式日志监控与告警、日志相关测试。
限制：编译失败为阻断条件，必须先解决；具体版本、依赖坐标、价格与平台支持等资料暂未提供。