用途：在 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/181-java-observability-logging.md，评估框架使用、日志级别、敏感数据处理与配置缺口，再实施所选改动。
适用场景：改进日志、应用日志、重构日志、添加日志支持、审查 Java 代码中的 SLF4J 结构化日志。
限制：资料未提供具体价格、平台支持范围或效果保证；具体示例与约束以参考文件为准。