SuperAPI AI 工具集

langfuse-prod-checklist

部署与运维

查看项目

更新于 10-15 23:27

技能介绍

用途:在将 Langfuse 可观测性部署到生产前,按清单核对生产配置、错误处理、优雅关闭与监控,并运行预部署验证脚本,输出生产就绪回执。

主要能力:提供 SDK 生产配置建议(v4+ 使用 LangfuseSpanProcessor,exportIntervalMillis 5000、maxExportBatchSize 50、maxQueueSize 2048;v3 使用 flushAt 25、flushInterval 5000、requestTimeout 15000);优雅关闭处理 SIGTERM/SIGINT/SIGUSR2;用 observe/startActiveObservation 包裹追踪操作并捕获追踪错误,避免追踪失败影响应用;验证脚本检查环境变量、密钥格式(pk-lf-/sk-lf-)、API 连通性与 trace 创建。

使用方式:先完成开发与预发测试,创建独立生产项目与 API 密钥并存入密钥管理;按清单逐项核对认证安全、SDK 配置、可靠性、监控与运维;运行 scripts/verify-langfuse-prod.ts 并将输出附到部署记录;对失败项修复或记录带负责人与回滚计划的限时例外;变更 SDK 配置、密钥或部署拓扑后重跑。

适用场景:生产发布前验证、生产配置审计、部署后追踪健康检查。

限制:资料未提供具体收费、价格、平台支持范围与效果数据;清单项需结合自身环境判断,密钥与 trace 内容不得打印。