SuperAPI AI 工具集

span-file-export

通用与其它

查看项目

更新于 10-16 05:47

技能介绍

用途:为 AI 消费提供基于文件的 span/日志导出。将本地 OTLP 追踪与日志记录交错写入同一 JSONL 文件,便于离线分析扩展运行情况。

主要能力:spans 与 log records 交错存于一个 JSONL 文件,每行独立 JSON,用 kind 字段区分(span/log)。span 含 traceId、spanId、parentSpanId、name、spanKind、起止纳秒时间、attributes、events、links、status、resource、instrumentationScope;log 含 timestamp、severityText、severityNumber、body、traceId、spanId、attributes。身份属性(userId、cliId、webUserId、orgId、common.*)仅标记在根 span 上,子 span 为空属预期。

位置与设置:目录 ~/.sf/vscode-spans/,文件名 {ISO-timestamp}.jsonl。设置 salesforcedx-vscode-salesforcedx.enableFileTraces 默认 false,开启文件捕获;salesforcedx-vscode-salesforcedx.logLevel 默认 error,控制最低导出日志级别;SF_LOG_LEVEL 环境变量作为回退。修改后需重载窗口。

启用方式:桌面端在设置中开启 enableFileTraces 并设 logLevel。Web/run:web 需先启动本地 span 文件服务器:npm run spans:server -w salesforcedx-vscode-services,并在仓库根 .esbuild-web-extra-settings.json 中开启 enableFileTraces,再运行 npm run run:web -w packages/<extension>。

App Insights 遥测捕获:本地捕获各平台将发往 Azure 的遥测,输出到 ~/.sf/vscode-appinsights/,经同一服务器端口 3003。桌面端在开发/测试模式自动改道,可用 SF_OTEL_INGESTION_ENDPOINT 指定端口;Web 端由 ESBUILD_WEB_LOCAL=1 自动触发。

限制:身份属性仅落在根 span;userId 在组织未认证或过期时缺失;cliId/webUserId 需 seedTelemetryIdentities 运行后才出现;customEvents 路径当前无扩展启用,仅出现 dependencies 路径。清除可执行 rm ~/.sf/vscode-appinsights/*。