개요

WebAssembly(WASM)는 브라우저 애플리케이션의 일부로 실행됩니다. 별도의 Datadog 애플리케이션 유형이 아닙니다. Datadog Browser SDK는 주변 브라우저 컨텍스트와 함께 WASM 오류를 수집하며, Datadog Error Tracking은 업로드된 DWARF 디버그 정보를 사용하여 WASM 스택 프레임을 심볼화할 수 있습니다.

단일 오류에 JavaScript 프레임과 WASM 프레임이 모두 포함될 수 있습니다. JavaScript 프레임에 대해서는 JavaScript 소스 맵을, WASM 프레임에 대해서는 WASM 심볼을 업로드하세요.

WebAssembly 심볼화는 베타 버전입니다. 브라우저 SDK 플러그인과 datadog-ci wasm-symbols upload 명령어는 실험적 기능이며 변경될 수 있습니다.

전제 조건

심볼을 업로드하기 전에 다음 사항을 확인하세요.

  • RUM, 브라우저 로그 또는 둘 다를 사용하여 WASM 모듈 메타데이터를 수집하도록 구성된 브라우저 애플리케이션.
  • 임베디드 DWARF 디버그 섹션과 build_id 사용자 지정 섹션이 포함된 .wasm 심볼 파일.
  • @datadog/datadog-ci 버전 5.23.0 이상.

디버그 심볼 생성

다음 항목을 생성하도록 WASM 툴체인을 구성하세요.

  • .debug_info 및 .debug_line과 같은 임베디드 DWARF 섹션.
  • build_id 사용자 지정 섹션. 업로드된 심볼 파일의 빌드 ID는 브라우저에 의해 로드된 모듈의 빌드 ID와 일치해야 합니다.

예를 들어, Emscripten의 경우:

emcc -g -Wl,--build-id <SOURCES> -o <OUTPUT>.js

이 명령은 <OUTPUT>.js, JavaScript 로더, <OUTPUT>.wasm, 임베디드 DWARF 정보와 build_id 사용자 지정 섹션이 포함된 WebAssembly 바이너리를 생성합니다.

wasm-objdump를 사용하여 생성된 모듈을 검사할 수 있습니다.

wasm-objdump -h <OUTPUT>.wasm
wasm-objdump -j build_id -x <OUTPUT>.wasm

CI 파이프라인에서 업로드할 수 있도록 심볼 파일을 빌드 아티팩트로 보관하세요.

심볼 업로드

Datadog CLI를 설치하고 Datadog API 키와 사이트를 구성하세요.

npm install --save-dev @datadog/datadog-ci
export DATADOG_API_KEY=<DATADOG_API_KEY>
export DATADOG_SITE=

베타 명령어를 활성화하고 하나의 .wasm 파일 또는 디렉터리를 업로드하세요. 디렉터리가 지정되면 CLI는 해당 디렉터리에서 .wasm 파일을 재귀적으로 검색합니다.

DD_BETA_COMMANDS_ENABLED=1 datadog-ci wasm-symbols upload /path/to/build

이 명령은 임베디드 DWARF 정보와 build_id 사용자 지정 섹션을 모두 포함하지 않는 파일은 건너뜁니다. --dry-run을 사용하여 심볼 파일을 업로드하지 않고 유효성을 검사합니다.

DD_BETA_COMMANDS_ENABLED=1 datadog-ci wasm-symbols upload /path/to/build --dry-run

기본적으로 Datadog은 빌드 ID에 대해 처음 업로드된 심볼 파일을 유지합니다. 의도적으로 교체해야 할 경우 --replace-existing을 사용하세요.

업로더는 external_debug_info 참조를 확인하지 않습니다. 이 참조만 포함된 런타임 모듈은 건너뜁니다. 임베디드 DWARF 섹션이 포함되어 있고 런타임 모듈과 동일한 build_id 를 가진 심볼 파일을 업로드하세요.

심볼이 일치되는 방식

Datadog은 모듈 URL 메타데이터를 사용하여 각 WASM 스택 프레임을 모듈과 연결한 다음, build_id로 모듈을 업로드된 심볼과 일치시킵니다. JavaScript 소스 맵과 달리 service 및 version은 WASM 심볼 조회에 포함되지 않습니다.

RUM 디버그 심볼 페이지에서 업로드된 파일을 조회할 수 있습니다.

추가 자료