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

プライベートなウェブサイトを監視しているお客様の場合、 JavaScript ソースマップの自動取得は動作しません。プライベートなウェブサイトのソースマップは一般公開されていないためです。 SaaS ここで、Instanaは、Instana SaaS を使用してプライベートウェブサイト用の JavaScript ソースマッピングファイルをアップロードする方法を提供します。

前提条件

Web サイト・モニター構成許可を有効にして API トークンを作成します。詳細は、 APIトークンを参照してください。
外部ストレージを構成して、Self-Hosted Custom Edition (Kubernetes または Red Hat OpenShift Container Platform) のソース・マップを保管します。

手順

Instana は、 ファイル・アップロード構成を作成するためのユーザー・インターフェースを提供します。これらの構成は、アップロードされた JavaScript ソース・マップ・ファイルを編成するために使用されます。 Instana UI の Web サイトの 「構成」 タブで、 「JS スタック・トレース変換」をクリックし、 「ファイル・ダウンロード構成」をクリックします。ここで構成を追加できます。

JS ソースマップのアップロード設定を表示したスクリーンショット

新しい ファイル・アップロード構成を作成した後、以下の Web REST API を使用して、 JavaScript ソース・マップ・ファイルをアップロードまたは削除できます。

ウェブREST API

リリース 250 以降、 JavaScript ソース・マップ・ファイルをアップロードおよび削除するための Web REST API が変更されました。

JavaScript ソース・マップ・ファイルをアップロードするには、以下のコマンドを実行します。
```
curl -L -X PUT \
    'https://$UNIT-$TENANT.instana.io/api/website-monitoring/config/$WEBSITE_ID/sourcemap-upload/$UPLOAD_CONFIG_ID/form' \
    -H 'authorization: apiToken $API_TOKEN' \
    -F 'url="$JAVASCRIPT_URL"' \
    -F 'sourceMap=@"$LOCAL_MAPFILE_LOCATION"'
```
注:
- この Web REST API は、複数のソースマップファイルのアップロードには対応していません。 URL とRest API CLIの最初のソースマップファイルのみが受け付けられます。
- ソースマップファイルが10MBより大きい場合、このWeb Rest APIはリクエストエンティティが大きすぎるというエラーを報告します。 tgz または tar.gz の形式で圧縮されたソースマップファイルを使用することをお勧めします。そして、Web REST API CLIでパラメータ -F 'fileFormat="tgz"' を指定します。

JavaScript ソース・マップ・ファイルを削除するには、以下のコマンドを実行します。

curl -L -X PUT \
    'https://$UNIT-$TENANT.instana.io/api/website-monitoring/config/$WEBSITE_ID/sourcemap-upload/$UPLOAD_CONFIG_ID/clear' \
    -H 'authorization: apiToken $API_TOKEN'

ただし、リリース 249 の場合は、以下の Web REST API を使用します。

JavaScript ソース・マップ・ファイルをアップロードするには、以下のようにします。

curl -L -X PUT \
    'https://$UNIT-$TENANT.instana.io/api/website-monitoring/config/$WEBSITE_ID/sourceMapUpload/$UPLOAD_CONFIG_ID/form' \
    -H 'authorization: apiToken $API_TOKEN' \
    -F 'url="$JAVASCRIPT_URL"' \
    -F 'sourceMap=@"$LOCAL_MAPFILE_LOCATION"'

JavaScript ソース・マップ・ファイルを削除するには、以下のようにします。

curl -L -X PUT \
    'https://$UNIT-$TENANT.instana.io/api/website-monitoring/config/$WEBSITE_ID/sourceMapUpload/$UPLOAD_CONFIG_ID/clear' \
    -H 'authorization: apiToken $API_TOKEN'