工程实践简报 · 2026-10-22 21:05 · Jay

作者:Jay|来源:work-guard 清单 job d87aa03c-5a96-401c-a9ff-ba497fea3831(仅 1 条 item、1 个保留来源;未开新检索,未回退扫描全库)

reproduction

n8n Observability with Parseable — https://github.com/parseablehq/n8n-observability/blob/main/README.md

  • 工程价值:给出可复现的部署契约——Compose 三件套(n8n + Parseable + PostgreSQL),自定义镜像内含 n8n-winston-logger.js、simple-winston-tracing.js 两个扩展点;OTel 经 OTLP 直推 OTEL_EXPORTER_OTLP_ENDPOINT,落地 n8n-logs、otel-traces、otel-metrics 三条 stream。插桩面到 workflow/node 级 span 与 HTTP/DB span;日志事件 API 覆盖 workflow.started/completed/failed、node.、http.;并附三条可直跑查询样例(按 time_unix_nano 取最近执行、severity_text='ERROR' 排错、span_name+duration_nanos 排性能)。这套「Winston 事件 → OTel span → 可查询 stream」的接法,对任何 Node 工作流服务的埋点分层设计有直接参照价值。
  • 证据边界:仅 n8n-observability 一条做过正文核查,其余条目只凭 excerpt 与来源类型判定;本实例容器内无 docker/docker-compose,Compose 栈无法直接拉起,Node 为 v24.14.0,故未实测启动与资源开销;README 未锁定 n8n 镜像版本;默认凭据 admin/admin 不可用于生产。
  • 待核查点:n8n 镜像版本锁定方式;实际 span 采样与日志量开销;PostgreSQL 侧存储与保留策略;替换默认凭据后的鉴权链路;Parseable 自建在无 docker 环境下的等价部署路径。

database / backend(丢弃)

archestra platform/backend 数据库迁移 README — https://github.com/archestra-ai/archestra/blob/platform-v1.3.74/platform/backend/src/database/migrations/README.md

  • 证据边界:excerpt 自陈关键结论未验证——check-migration-upgrades.py 是否仍在 release 分支 PR 流程启用、断言逻辑与文档是否一致均为「未执行、未运行」;且属单一产品内部流程文档,非可迁移的通用实践。判定须运行脚本,本批既无环境也无授权。
  • 待核查点:脚本启用状态与断言语义;与文档的一致性;是否存在通用可复用部分。

cloud-native(丢弃)

What's new with Google Cloud — https://cloud.google.com/blog/topics/inside-google-cloud/whats-new-google-cloud

  • 证据边界:泛资讯汇总页,唯一相关的 Firestore 新查询引擎条目企业版定价与实际可用范围未知,未取正文。
  • 待核查点:该查询引擎的 GA 状态、区域与企业版门槛。

观测选型(丢弃)

Best AI Observability Tools(Logz.io) — https://logz.io/blog/best-ai-observability-tools Top 7 LLM Observability Tools(Confident AI)

  • 证据边界:均为厂商自荐盘点且未取正文,入选清单与排序不可考,选型结论不可作证据,也不构成可执行动作。

结论:本批唯一可落地的引用是 n8n-observability 的 OTel 埋点分层范式,其余四条证据不足,按清单要求不补齐、不再检索。