datadog-ci wasm-symbols upload adds beta WASM symbolication workflow

Introduced 2026-08-17 · score 0.98

HOW TO USE IT

When uploading WASM debug information for Browser SDK stack trace symbolication, provide a `.wasm` file or directory and enable the beta command. The command recursively scans directories and skips files without embedded DWARF sections or a `build_id` section.

WHY THIS HELPS

Upload WebAssembly debug information from a build output directory so Datadog can symbolicate Browser SDK WASM stack traces.

REQUIREMENTS AND LIMITATIONS

• Version: v5.23.0
• Availability: The `wasm-symbols upload` command is in beta and requires `DD_BETA_COMMANDS_ENABLED=1`.
• <file-or-directory> (required): File path uploads that file; directory path is scanned recursively for `.wasm` files.
• DD_BETA_COMMANDS_ENABLED=1 (required): Enables the beta `wasm-symbols upload` command.
• --dry-run: Skips the final upload step while performing other checks.
• --max-concurrency: Sets concurrent API uploads; defaults to 20.
• --disable-git: Prevents invoking Git and sending repository-related data to Datadog.
• --repository-url: Overrides the remote repository URL.
• --replace-existing: Replaces existing symbol information with the same build ID; by default, the first-seen file is kept and later files are skipped.
• Prerequisite: Set `DD_API_KEY` in the environment.
• Prerequisite: Set `DD_BETA_COMMANDS_ENABLED=1` to use the beta command.
• Prerequisite: For Datadog EU, set `DD_SITE=datadoghq.eu`; requests default to Datadog US.
• Prerequisite: The `.wasm` must contain embedded DWARF debug sections and a `build_id` custom section; files with only `external_debug_info` are skipped.
• A directory is scanned recursively for `.wasm` files; a file path uploads only that file.
• A `.wasm` file is uploaded only if it carries embedded DWARF debug sections, for example produced by `emcc -g` or `wasm-pack build --dev`.
• A file with only an `external_debug_info` section is skipped; the referenced separate debug artifact is not resolved or uploaded.
• A `.wasm` file without a `build_id` custom section is skipped.
• `--dry-run` omits the final upload step while still performing the other checks.
• Requests go to Datadog US by default; set `DD_SITE=datadoghq.eu` to use Datadog EU.
• The command requires `DD_API_KEY` in the environment.

FIRST-PARTY EVIDENCE

• https://github.com/DataDog/datadog-ci/releases/tag/v5.23.0
• https://github.com/DataDog/datadog-ci/pull/2398
• https://github.com/DataDog/datadog-ci/blob/v5.23.0/packages/base/src/commands/wasm-symbols/README.md

Check the installed version and the source before using it. Entry JSON

Report a problem with this card