project-observability-analyzer

Project Observability Analyzer 用于分析项目结构，并为应用程序推荐可观测性策略。根据资料，它适用于为 Claude Code 所处理的项目添加可观测性。

用途 该工具的核心用途是扫描项目并给出可观测性集成建议，帮助开发者在现有项目中引入日志、指标和追踪等可观测性能力。

主要能力 工作流程包括以下步骤：

1. 扫描项目结构，包括文件、依赖和框架。
2. 检测框架，例如 Express、Next.js、FastAPI、Spring Boot 等。
3. 识别现有日志方案，例如 Winston、Pino、Python logging 等。
4. 检测已有可观测性组件，例如 Prometheus exporter、OTEL、APM agent。
5. 如果检测到 Web 框架，则分析 API 端点。
6. 生成建议，包括 OTEL 埋点位置、日志库配置、需添加的 Prometheus 指标、Docker Compose 集成。
7. 生成集成文件，包括更新后的 docker-compose.yml（应用与可观测性）、OTEL 埋点代码、日志配置、含设置说明的 README。

示例输出 资料给出的示例输出如下： 项目：Express.js REST API 框架：Express.js 4.18.2 日志：Winston（JSON 格式）✅ 可观测性：无 ❌ 建议：

1. 添加 express-prom-bundle 以获取 Prometheus 指标
2. 配置 Winston → Loki（通过 Alloy）
3. 添加 OTEL 自动埋点以进行追踪
4. 与 LGTM 栈集成 生成的文件：

• docker-compose-with-app.yml
• otel-instrumentation.js
• winston-loki-config.js

框架模板 该工具提供以下框架的集成模板：

• Express.js 集成
• Next.js 集成
• FastAPI 集成
• Spring Boot 集成

使用方式 资料未提供具体的安装命令、调用方式或配置步骤，暂未提供。

适用场景 适用于需要为已有项目评估并添加可观测性能力的开发场景，尤其是使用 Express、Next.js、FastAPI、Spring Boot 等框架的项目，以及希望整合 OTEL、Prometheus、Loki、LGTM 栈等可观测性组件的场景。

限制 资料未说明该工具支持的平台、收费方式、价格、具体效果或性能指标，暂未提供。