SuperAPI AI 工具集

temps-best-practices

通用与其它

查看项目

更新于 10-15 21:54

技能介绍

用途:这是 Temps 平台应用侧的运行时契约与可观测性最佳实践参考,面向需要在 Temps 上部署并正确埋点的应用;平台操作类事宜应改用 temps-cli 技能。

主要能力:定义 Web 应用需暴露专用健康端点,仓库构建在 .temps.yaml 配置 health.path(如 /healthz),镜像/静态部署则通过部署的 health_check_path 或 CLI --health-check-path 覆盖;说明启用 OpenTelemetry 服务端追踪时应将健康路径从入站 span、访问日志和请求指标噪声中排除,并保持路由、配置与过滤同步。同时要求应用读取 PORT、绑定 HOST/0.0.0.0、对齐 EXPOSE、处理 SIGTERM、刷新遥测并在 10 秒关闭窗口内退出。

可观测性:Temps 以统一入口替代 Sentry + Datadog/Honeycomb + PostHog,覆盖错误追踪、链路(OTLP)、指标(OTLP)、日志(OTLP)、分析五大支柱,按用途选择信号归属,避免把异常写成日志、把计数写成 span。

使用方式:先读取运行时契约与遥测卫生参考,再按范围读取对应支柱参考。Temps 仅自动注入导出目标与凭证(如 SENTRY_DSN、OTEL_EXPORTER_OTLP_ENDPOINT、OTEL_EXPORTER_OTLP_HEADERS、OTEL_SERVICE_NAME),不会安装或初始化 SDK,应用仍需自行安装、初始化、过滤并验证。OTLP 鉴权支持 Authorization: Bearer <token> 或 X-Temps-Api-Key: <token>;速率默认每令牌 60 秒 1000 请求。

限制:.temps.yaml 中的 status、interval、timeout、retries 等字段当前已解析但未生效,不要依赖;镜像与静态部署无法读取 .temps.yaml。禁止将 OTEL_EXPORTER_OTLP_HEADERS、TEMPS_API_TOKEN、dt_、tk_ 放入公开前缀变量或客户端产物,浏览器/移动端 OTLP 须经认证后端或收集器。自动注入仅限通过 Temps 部署的应用,其他场景需从控制台获取真实凭据。部署、数据库、域名、备份与 CI/CD 等未在此展开,相关内容暂未提供。