JavaScript ソース・マップのアップロード
Instana SaaS を使用して非公開のウェブサイトを監視しているお客様の場合、非公開ウェブサイトのソースマップは一般に公開されていないため、 JavaScript のソースマップの自動取得は機能しません。 ここでは、 Instana が、 Instana SaaS を利用して、非公開のウェブサイト向けに JavaScript のソースマッピングファイルをアップロードする方法を提供しています。
前提条件
- Webサイト監視の設定権限を有効にした API トークンを作成します。 詳細については、 「 API トークン」 を参照してください。
- 外部ストレージを設定することで、 セルフホスト型カスタムエディション( Kubernetes または Red Hat OpenShift Container Platform ) のソースマップを保存します。
手順
Instana アップロードされた JavaScript ソースマップファイルを整理するために使用される「 ファイルアップロード設定 」を作成するためのユーザーインターフェースを提供します。 Instana UIのウェブサイトの「 設定 」タブで、 「JSスタックトレースの変換 」をクリックし、次に「 ファイルダウンロードの設定」 をクリックします。 ここで構成を追加できます。

新しい ファイル・アップロード構成を作成した後、以下の Web REST API を使用して、 JavaScript ソース・マップ・ファイルをアップロードまたは削除できます。
Web 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 は、複数のソースマップファイルのアップロードに対応していません。 Rest API CLI では、最初の URL および最初のソースマップファイルのみが受け入れられます。
ソースマップファイルのサイズが 10 MB を超える場合、この Web REST API では「リクエストエンティティが大きすぎます」というエラーが発生します。 圧縮されたソースマップファイル(.zip または.tar.
tgzgz 形式)を使用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'