JavaScript ソースマップのアップロード

Docs > RUM & セッションリプレイ > リアルユーザーモニタリングおよびセッションリプレイについてのガイド > JavaScript ソースマップのアップロード

概要

フロントエンドの JavaScript ソースコードが縮小化されている場合、Datadog にソースマップをアップロードして、異なるスタックトレースの難読化を解除します。任意のエラーについて、関連するスタックトレースの各フレームのファイルパス、行番号、コードスニペットにアクセスすることができます。また、Datadog はスタックフレームをリポジトリ内のソースコードにリンクすることができます。

Real User Monitoring (RUM) で収集されたエラー、およびブラウザログ収集のログのみ、縮小化解除が可能です。

コードのインスツルメンテーション

JavaScript バンドルは、ソースコードを縮小化する際に、sourcesContent 属性に関連するソースコードを直接含むソースマップを生成するように構成します。また、各ソースマップのサイズと関連する縮小化ファイルのサイズを足したものが、US1 または EU1 のサイトでは 200 MB、その他のサイトでは 50 MB という制限を超えないことを確認してください。

一般的な JavaScript のバンドルソフトについては、以下の構成を参照してください。

SourceMapDevToolPlugin という名前の組み込みの Webpack プラグインを使用して、ソースマップを生成できます。

webpack.config.js ファイルにある構成例を参照してください。

// ...
const webpack = require('webpack');

module.exports = {
  mode: 'production',
  devtool: false,
  plugins: [
    new webpack.SourceMapDevToolPlugin({
      noSources: false,
      filename: '[file].map'
    }),
    // ...
  ],
  optimization: {
    minimize: true,
    // ...
  },
  // ...
};

注: TypeScript を使用している場合は、tsconfig.json ファイルで compilerOptions.sourceMap を true に設定してください。

Parcel は、ビルドコマンドを実行すると、デフォルトでソースマップを生成します: parcel build <entry file>。

アプリケーションをビルドした後、バンドラーは縮小化された JavaScript ファイルを、対応するソースマップと同じ場所に配置したディレクトリ (通常 dist という名前) を生成します。

次の例をご覧ください。

./dist
    javascript.364758.min.js
    javascript.364758.js.map
    ./subdirectory
        javascript.464388.min.js
        javascript.464388.js.map

javascript.364758.min.js と javascript.364758.js.map のファイルサイズの合計が US1 または EU1 サイトでは 200 MB (その他のサイトでは 50 MB) の制限を超える場合は、ソースコードを複数の小さな塊に分割するようにバンドラーを構成してファイルサイズを小さくしてください。詳しくは、WebpackJS によるコードの分割を参照してください。

ソースマップのアップロード

ソースマップをアップロードする最良の方法は、CI パイプラインに追加のステップを追加し、Datadog CLI から専用コマンドを実行することです。dist ディレクトリとそのサブディレクトリをスキャンして、関連する縮小ファイルを含むソースマップを自動的にアップロードします。

package.json ファイルに @datadog/datadog-ci を追加します (最新バージョンを使用していることを確認してください)。
専用の Datadog API キーを作成し、DATADOG_API_KEY という名前の環境変数としてエクスポートします。

RUM アプリケーションで、1 サービスにつき 1 回、以下のコマンドを実行します。

datadog-ci sourcemaps upload /path/to/dist \
  --service=my-service \
  --release-version=v35.2395005 \
  --minified-path-prefix=https://hostname.com/static/js

package.json ファイルに @datadog/datadog-ci を追加します (最新バージョンを使用していることを確認してください)。
専用の Datadog API キーを作成し、DATADOG_API_KEY という名前の環境変数としてエクスポートします。
以下の 2 つの環境変数をエクスポートして、サイトにファイルをアップロードするように CLI を構成します: export DATADOG_SITE= と export DATADOG_API_HOST=api.

RUM アプリケーションで、1 サービスにつき 1 回、以下のコマンドを実行します。

datadog-ci sourcemaps upload /path/to/dist \
  --service=my-service \
  --release-version=v35.2395005 \
  --minified-path-prefix=https://hostname.com/static/js

CI のパフォーマンスに対するオーバーヘッドを最小限に抑えるため、CLI は短時間 (通常数秒) で必要なだけのソースマップをアップロードできるように最適化されています。

注: バージョンに変更がない場合、ソースマップを再アップロードしても既存のものはオーバーライドされません。

service と --release-version パラメーターは、RUM イベントとブラウザログの service と version タグと一致する必要があります。これらのタグを設定する方法の詳細については、Browser RUM SDK 初期化ドキュメントまたはブラウザログ収集ドキュメントを参照してください。

RUM アプリケーションで複数のサービスを定義している場合、RUM アプリケーション全体のソースマップのセットが 1 つであっても、サービスの数だけ CI コマンドを実行します。

サンプルの dist ディレクトリに対してコマンドを実行すると、Datadog はサーバーまたは CDN が https://hostname.com/static/js/javascript.364758.min.js と https://hostname.com/static/js/subdirectory/javascript.464388.min.js に JavaScript ファイルを配信することを期待します。

スタックトレースを正しく非縮小するために機能するのは、拡張子が .js.map のソースマップのみです。.mjs.map など、他の拡張子のソースマップは許容されますが、スタックトレースを非縮小しません。

異なるサブドメインから同じ JavaScript ソースファイルを提供する場合、関連するソースマップを一度アップロードし、完全な URL の代わりに絶対プレフィックスパスを使用することで複数のサブドメインで動作するようにしてください。例えば、https://hostname.com/static/js の代わりに /static/js を指定します。

スタックフレームをソースコードにリンクする

Git の作業ディレクトリ内で datadog-ci sourcemaps upload を実行すると、Datadog はリポジトリのメタデータを収集します。datadog-ci コマンドは、リポジトリの URL、現在のコミットハッシュ、そしてソースマップに関連するリポジトリ内のファイルパスのリストを収集します。Git のメタデータ収集の詳細については、datadog-ci のドキュメントを参照してください。

Datadog は、縮小化を解除されたスタックフレームにソースコードへのリンクを表示します。