追加のAPMブラウザ・エージェント・注入設定の構成

APMブラウザ・エージェント機能を有効にすると、要件に応じてデフォルト設定をカスタマイズして追加できます。

要件に応じて、次の環境変数を追加または変更できます。

構成を変更した場合は、対応する WindowsサービスまたはIISを再起動する必要があります。

構成として、次の環境変数を追加または変更できます。構成を変更した場合は、対応する WindowsサービスまたはIISを再起動する必要があります。

環境変数 説明 デフォルトの値 サンプル値
OTEL_BA_DEBUG デバッグ・ログ・レベルを有効にするかどうかを指定します。デバッグ・ログ・レベルを有効にするには、trueに設定します。 false  
OTEL_BA_UPLOAD_ENDPOINT ブラウザ・エージェントがデータをアップロードするAPMサービスのエンドポイントを指定します。 この環境変数が指定されていない場合、アップロード・エンドポイントは接尾辞"/20200101/opentelemetry"なしでOTEL_EXPORTER_OTLP_ENDPOINTから取得されます。 https://aaaac6h5n3jn6aaaaaaaaaacqe.apm-agt.us-phoenix-1.oci.oraclecloud.com
OTEL_BA_SERVICE_NAME ブラウザ・エージェントのサービス名を指定します。 この環境変数が指定されていない場合、サービス名はOTEL_SERVICE_NAMEから取得されます。  
OTEL_BA_WEB_APPLICATION Webアプリケーション名を指定します。 IISのWebサーバー名またはアセンブリ名。  
OTEL_INJECT_LOCATION_TAG HTML内のブラウザ・エージェントが注入される場所を指定します。 <head </スクリプト
OTEL_INJECT_BEFORE 指定されたOTEL_INJECT_LOCATION_TAGの前後に注入するかどうかを指定します。 false  
OTEL_INJECT_MODE ブラウザ・エージェントの注入方法を指定します。
以下の値を指定できます。
  • InjectIfTagExists: 指定したOTEL_INJECT_LOCATION_TAGが存在する場合は、その前にブラウザ・エージェントを注入します。それ以外の場合は、何もしません。
  • AppendIfNoTag: 指定したOTEL_INJECT_LOCATION_TAGが存在しない場合は、最後にブラウザ・エージェントを追加します。これはデフォルト値です。
  • AppendOnly: HTMLページの最後に常にブラウザ・エージェントを追加します。
AppendIfNoTag  
OTEL_BA_DISABLE_URLS ブラウザ・エージェント・インジェクションから無効にする必要があるURLに一致する正規表現を指定します。 "" (空)は、URLが無効にならないことを意味します。 .*WaimaiUiMvc\/Home\/Cart.*|.*waimaiwasm\/cart.*
OTEL_BA_TEMPLATE 注入されるブラウザ・エージェント・テンプレートを指定します。

@@で囲まれた値は、インジェクションが発生する前に置換され、APM Dotnetエージェントによって取得される値です。

このテンプレートは、次のようなこのドキュメントの他のセクションに記載されているブラウザ・エージェント側の構成を考慮して調整できます。
window.apmrum.rewriteRules
。詳細は、「個人識別可能情報の非表示」を参照してください。
<script type="application/javascript">window.apmrum = (window.apmrum || {});
window.apmrum.serviceName='@@SERVICE_NAME@@';
window.apmrum.webApplication='@@WEB_APPLICATION@@';
window.apmrum.ociDataUploadEndpoint='@@UPLOAD_ENDPOINT@@';
window.apmrum.OracleAPMPublicDataKey='@@PUBLIC_KEY@@';
window.apmrum.username='@@USER_NAME@@';
window.apmrum.traceSupportingEndpoints = [ { hostPattern: '.*', headers: ['W3C']},];
</script>
<script type="application/javascript"  crossorigin="anonymous"
src="@@UPLOAD_ENDPOINT@@/static/jslib/apmrum.min.js"></script>