// Use file-based span/log export for AI consumption. Where it lives, how to enable/clear, record format for Node and Web. Use when enabling span file dump, debugging traces for AI, or configuring local observability.
| name | span-file-export |
| description | Use file-based span/log export for AI consumption. Where it lives, how to enable/clear, record format for Node and Web. Use when enabling span file dump, debugging traces for AI, or configuring local observability. |
Local OTLP export to ~/.sf/vscode-spans/ for AI consumers. Spans and log records interleaved in one JSONL file.
| Setting | Default | Purpose |
|---|---|---|
salesforcedx-vscode-salesforcedx.enableFileTraces | false | Enables file capture (spans + logs) |
salesforcedx-vscode-salesforcedx.logLevel | error | Minimum log level for exported records. Set to info or debug to see most logs. |
SF_LOG_LEVEL env var | — | Fallback when VS Code setting unset (fatal maps to error) |
Reload the window after changing — the SDK layer is built at activation time.
All records in one directory: ~/.sf/vscode-spans/
Filename pattern: {ISO-timestamp}.jsonl (e.g., 2026-05-22T15-33-01-398Z.jsonl)
Find latest: ls -lt ~/.sf/vscode-spans/ | head -1
Each line is independent JSON. Discriminate on "kind" field.
kind: "span"){"kind":"span","traceId":"abc123","spanId":"def456","parentSpanId":"","name":"ConnectionService.getConnection","spanKind":1,"startTimeUnixNano":"1779461510277547833","endTimeUnixNano":"1779461510278117291","attributes":{"orgId":"00D..."},"events":[],"links":[],"status":{"code":1,"message":""},"resource":{"attributes":{"extension.name":"salesforcedx-vscode-core","service.name":"salesforcedx-vscode-core"}},"instrumentationScope":{"name":"salesforcedx-vscode-core","version":"2026-03-02T01:00.304Z"}}
| Field | Notes |
|---|---|
parentSpanId: "" | Root span (top of trace tree) |
status.code | 1=OK, 2=ERROR |
spanKind | OTEL SpanKind enum +1 (1=INTERNAL, 2=SERVER, 3=CLIENT) |
resource.attributes["extension.name"] | Which extension emitted it |
| Duration (ms) | (endTimeUnixNano - startTimeUnixNano) / 1_000_000 |
kind: "log"){"kind":"log","timestamp":"1779463981397000000","severityText":"WARN","severityNumber":30000,"body":"UserIdNotFoundError: Could not determine user ID","traceId":"b4d710...","spanId":"706dfc...","attributes":{"fiberId":"#295"}}
| Field | Notes |
|---|---|
traceId + spanId | Correlates to parent span active when log was emitted |
severityText | INFO, WARN, ERROR (filtered by logLevel setting) |
body | String or array (multiple log args) |
timestamp | Nanoseconds since epoch |
Only log records at or above the configured logLevel are emitted.
{
"salesforcedx-vscode-salesforcedx.enableFileTraces": true,
"salesforcedx-vscode-salesforcedx.logLevel": "info"
}
Web POSTs to local span file server (port 3003). Server must be running.
npm run spans:server -w salesforcedx-vscode-services.esbuild-web-extra-settings.json at repo root (gitignored):
{ "salesforcedx-vscode-salesforcedx.enableFileTraces": true }
npm run run:web -w packages/<extension>rm ~/.sf/vscode-spans/*
Logs reference the span that was active when they were emitted via traceId + spanId. To reconstruct an operation:
traceIdparentSpanId → childrentraceId — they belong to the span matching their spanIdPolish the automated CHANGELOG for a release branch. Removes GUS refs, categorizes under-the-cover changes, improves customer-facing descriptions. Use when preparing/reviewing the changelog on a release branch, or when user mentions changelog quality.
Run the VS Code extension release workflow end-to-end. Use when publishing a release, running prerelease, verifying the release branch, polishing changelog for release, or installing release vsixes for verification.
Find open GitHub issues whose linked GUS work item is closed AND whose issue number appears in CHANGELOG.md, then close them. Use when user invokes /shipped-issues or asks to clean up shipped issues.
writing, running, and debugging Playwright tests; creating and recreating scratch orgs (Dreamhouse, minimal, non-tracking); working with their output from github actions
Author and use Wireit scripts for npm. Use when working with Wireit configuration, npm scripts, build pipelines, or when the user mentions Wireit.
Public API exported by salesforcedx-vscode-core activate(). Use when modifying SalesforceVSCodeCoreApi, the api object in activate(), exports from core index.ts, services sub-object, or evaluating whether a change to core is breaking. Also use when someone asks "does anything use X" for a core export.