SuperAPI AI 工具集

truefoundry-logs

部署与运维

查看项目

更新于 10-16 06:43

技能介绍

用途:查看、下载和搜索 TrueFoundry 上的应用与任务日志,适用于调试部署、检查启动输出和查找错误。

主要能力:支持按时间范围(start_ts、end_ts,ISO 8601)、应用(application_id / application_fqn)、部署(deployment_id)、任务运行(job_run_name)、Pod(pod_name)过滤;支持在日志内搜索,search_type 可选 contains 或 regex。

使用方式:可通过工具调用 tfy_logs_download(payload={"workspace_id":"ws-id","application_fqn":"app-fqn","start_ts":"2026-02-10T00:00:00Z","end_ts":"2026-02-10T23:59:59Z"}),或使用直连 API:先设置 TFY_API_SH 为本技能 scripts/tfy-api.sh 的完整路径,然后执行 $TFY_API_SH GET '/api/svc/v1/logs/WORKSPACE_ID/download?applicationFqn=APP_FQN&startTs=START&endTs=END';带搜索过滤时使用 /api/svc/v1/logs/WORKSPACE_ID/download?applicationId=APP_ID&searchString=error&searchType=contains。workspace_id 为必填路径参数。展示日志时按时间顺序,长输出取最后 N 行或摘要错误。

适用场景与限制:部署后验证应用是否正常启动;用 searchString=error 调试失败。需先从 TrueFoundry 控制台取得应用 ID 或 FQN,并用 workspaces 技能获取工作区 ID。安全上,日志可能含敏感数据(密钥、令牌、PII),未经审查不要转发到外部服务或直接放入回复。缺失 workspace_id 会报错;无日志时需检查时间范围、应用标识及应用是否在该时段运行;无权限则需检查 API key 权限。