用途：为应用接入基于 OpenTelemetry 的追踪与可观测性，使用 TrueFoundry 追踪平台（底层为 Traceloop SDK），采集 LLM 调用、工作流与自定义 span。
使用前提：先运行 status 技能确认 TFY_BASE_URL 与 TFY_API_KEY 已设置且有效；使用直接 API 时需将 TFY_API_SH 指向本技能的 scripts/tfy-api.sh。
主要步骤：
- 建立追踪项目。列出已有项目：tfyl_tracing_list_projects()，或 $TFY_API_SH GET /api/svc/v1/tracing-projects。创建项目：tfy_tracing_create_project(name="my-tracing-project")，或 $TFY_API_SH PUT /api/svc/v1/tracing-projects '{"name": "my-tracing-project"}'，保存返回的 project id。再在其下创建应用：tfy_tracing_create_application(project_id="PROJECT_ID", name="my-app")，或 POST /api/svc/v1/tracing-applications。
- 识别应用类型：Python 查看 requirements.txt、pyproject.toml 等及 openai、anthropic、langchain 等库；TypeScript 查看 package.json 及其相关 SDK。
- 安装依赖：Python 用 pip install traceloop-sdk；TypeScript 用 npm install @traceloop/node-server-sdk，并写入依赖文件。
- 插桩：必须在入口文件最顶部、任何 LLM 库 import 之前调用 Traceloop.init()（Python）或 traceloop.initialize()（TypeScript），配置 app_name、api_endpoint 为 "<TFY_BASE_URL>/api/otel"，headers 含 Authorization 与 X-TFY-TRACING-PROJECT-FQN，建议从环境变量读取密钥。
- 可选：为多步骤应用添加 workflow、task、agent、tool 装饰器；高流量生产环境可配置采样，如 ParentBased(root=TraceIdRatioBased(0.1))。
限制与排错：未按顺序初始化、endpoint 写成 /api/otel/、FQN 不匹配会导致无追踪；401 需检查 API Key；ImportError 需确认安装与虚拟环境；追踪项目 API 返回 404 时可改用 TrueFoundry UI 创建项目。
成功标准：项目存在、SDK 已装、初始化置于 LLM import 前、认证头齐全、应用可运行、测试请求后仪表板出现追踪。