#952 alloy traces 配置 bake Dockerfile + 计划 (20260810-154537)

新增 alloy/Dockerfile + config.alloy + build.sh + README + docs/observability/alloy-bake-plan.md. 当前 bind mount /tmp/alloy 仍稳定,本会话仅交付可执行件,实际 build 待低峰期执行.
2026-08-10 15:45:37 +08:00
1 parent 7e002ac2b5
commit e50d006ef4
@@ -0,0 +1,37 @@
+# alloy traces 配置 bake 计划 (Task #952)
+
+## 必要性判断
+- **必要性**: 🟡 中等
+- **理由**: 当前 alloy 配置通过 bind mount 在 `/tmp/alloy/config.alloy`,在容器重启或宿主机 /tmp 清理时存在配置丢失风险。把配置 bake 进镜像让 alloy 容器自包含,符合容器 immutable 原则。
+- **风险**: 重建 alloy 镜像 + 重启容器期间,metrics 采集会中断 1-3 分钟,可能影响 Grafana 看板。
+- **冲突**: 与 P1-2 nginx / P1-1 测试无冲突,可独立执行。
+
+## 交付物(本会话已完成)
+- `alloy/Dockerfile`:基础 `grafana/alloy:latest` + COPY `config.alloy` 到 `/etc/alloy/config.alloy` + HEALTHCHECK
+- `alloy/config.alloy`:与宿主的 `/tmp/alloy/config.alloy` 同步(1705 bytes)
+- `alloy/build.sh`:自动 build + tag(产物:`qihuaiflow-alloy:verified-{TS}`)
+- `alloy/README.md`:使用说明 + 回滚指引
+
+## 实际 bake(待低峰期执行)
+1. `cd /www/wwwroot/qihuaiflow/alloy && ./build.sh`
+2. 修改 `docker-compose.yml` alloy 服务 image + 移除 bind mount
+3. `docker compose up -d alloy`
+4. 验证 alloy health:`docker exec qihu-aiflow-alloy wget -q -O- http://localhost:12345/-/ready`
+5. 验证 metrics 还在采集:Grafana → Explore → Prometheus → `up` 查询
+
+## 当前 traces 状态(已落地,不依赖本次 bake)
+- `otelcol.receiver.otlp "default"` 监听 4317/4318
+- receiver 实现 TraceService proto,应用 OTel SDK 不再 UNIMPLEMENTED
+- 故意不接 output 出口(等未来接 Tempo/Loki)
+- 已修#876 Grafana 双 Claw 看板(`qihuaiflow-dual-claw-876`)
+
+## 不 bake 也能正常工作的原因
+- 当前配置 bind mount 自 `/tmp/alloy/config.alloy`,只要宿主不删,容器每次启动都会拿到
+- `/tmp` 在阿里云 Ubuntu 24.04 宿主上**重启不清理**(systemd 默认)
+- bind mount 在 `docker-compose.yml` 里声明,容器启动时自动挂载
+
+## 总结
+- **现在做**:Dockerfile + config + build.sh + README(本会话已交付,commit 在下一行)
+- **不实际 build**:避免非预期中断 metrics 采集
+- **下次需要**:低峰期单独会话执行 `./build.sh` + docker-compose 切换
+