技能概述
observability-lgtm是一款面向FastAPI开发者的本地化全栈可观测性解决方案，将Loki（日志）、Grafana（可视化）、Tempo（链路追踪）、Prometheus（指标）和Alloy（数据采集代理）五大组件整合为单一Docker Compose部署，实现"一键启动、一行代码接入"的开发体验。
核心用法
部署流程分为八个步骤：端口冲突检查、文件复制、服务启动、Python依赖安装、应用插桩、Prometheus注册、Grafana面板查看及可选的扩展面板导入。开发者仅需在FastAPI应用中添加setup_observability(app, service_name="xxx")即可自动暴露/metrics端点、输出结构化JSON日志并推送OTLP链路数据。
显著优点
1. 零配置开箱即用：预置Grafana数据源、告警规则及FastAPI专属仪表板，无需手动配置Prometheus scrape或Loki索引
2. 全链路关联能力：通过OpenTelemetry自动注入trace_id到日志，Grafana面板支持从日志行一键跳转至Tempo完整链路
3. 端口冲突规避：默认端口避开常见冲突（3100→3300避开Langfuse，9090→9091避开MinIO）
4. 开发友好设计：无认证本地模式、热重载Prometheus配置、Alloy可视化调试界面（:12345）
5. 数据主权保障：纯本地运行，默认标记data_classification: LOCAL_ONLY，敏感数据不出境
潜在局限与风险
| 维度 | 说明 |
|------|------|
| **生产适用性** | 明确标注仅用于本地开发，缺乏高可用、持久化集群、安全认证等企业级特性 |
| **语言绑定** | Python插桩库仅支持FastAPI，其他语言/框架需自行实现OTLP接入 |
| **资源占用** | 六容器并行运行需约2-4GB内存，低配设备可能吃紧 |
| **数据持久化** | 默认Docker volume存储，核选项`down -v`会清空所有历史数据 |
| **日志级别过滤** | Alloy默认丢弃DEBUG日志，需手动修改配置恢复 |
适合人群
- 正在构建FastAPI微服务的全栈开发者
- 需要快速验证"日志-指标-链路"三支柱关联的架构师
- 抗拒ELK重量级方案、寻求轻量级替代的团队
- 多应用并行开发、需要统一观测平面的本地环境
安全评估
该技能在设计上遵循安全优先原则：强制本地-only数据流、无敏感信息硬编码、依赖项均为CNCF毕业/孵化项目（Loki、Tempo、Prometheus）。但用户需注意：
- 开发模式Grafana无认证，公网暴露将导致完全开放访问
- 默认配置未启用TLS，跨主机传输存在中间人风险
- 需定期更新基础镜像以修复CVE漏洞
综合评级：适合作为开发/测试阶段的标准化可观测性基座，生产环境请迁移至Grafana Cloud或等效托管服务。