用途：在 TrueFoundry 平台查看应用与任务日志，并为应用添加基于 OpenTelemetry 的链路追踪能力，便于调试部署、检查启动输出、定位错误及观测 LLM 调用。
主要能力：
- 日志：查看、下载、搜索应用和作业日志，支持按应用 ID/FQN、部署、作业运行、Pod、时间范围过滤，支持 contains 或 regex 搜索。
- 追踪：创建追踪项目和应用，安装 Traceloop SDK，为 Python 或 TypeScript 应用做自动埋点；多步骤应用可用 @workflow、@task、@agent、@tool 等装饰器组织 trace 结构；高流量生产环境可配置采样。
使用方式： 日志可通过工具调用或直接 API 下载，例如： $TFY_API_SH GET '/api/svc/v1/logs/WORKSPACE_ID/download?applicationFqn=APP_FQN&startTs=START&endTs=END' 追踪需先确认 TFY_BASE_URL 与 TFY_API_KEY 有效，再列出或创建追踪项目与应用；Python 安装 pip install traceloop-sdk，TypeScript 安装 npm install @traceloop/node-server-sdk；在入口文件最顶部、任何 LLM 库导入之前调用 Traceloop.init()，并配置 api_endpoint 为 <TFY_BASE_URL>/api/otel，请求头包含 Authorization 与 X-TFY-TRACING-PROJECT-FQN。
适用场景：部署后验证启动、下载日志排查失败、按错误关键字检索日志、为聊天机器人或 RAG 流水线等 LLM 应用接入追踪。
限制：日志可能含密钥、令牌或个人信息，转发或展示前需先审查；workspace_id 为必填；追踪 API 若返回 404 应改用 TrueFoundry UI 创建追踪项目；无追踪数据时优先检查 Traceloop.init() 是否位于 LLM 导入之前。具体收费、平台支持版本及配额暂未提供。