プロキシエージェントコードと分析データ

重要

この機能は現在、コピー/ペーストまたは NPM ブラウザーのインストール方法を使用しているユーザーが利用できます。現在、利用可能な UI または NerdGraph 構成オプションはありません。私たちは、これらおよびその他の構成オプションへのアクセスを改善するために引き続き取り組んでいます。

ブラウザエージェントのプロキシ URL を設定すると、サードパーティドメインへのクライアントリクエストをブロックする広告ブロッカーやセキュリティ VPN を回避できるため、有益です。

広告ブロッカーとセキュリティ VPN は、Web 全体でユーザーを追跡するために使用できるため、サードパーティのドメインをブロックすることがよくあります。ファーストパーティのサブドメインを介してリクエストをプロキシすることで、これらのブロッカーをバイパスし、可観測性データが引き続き収集されるようにすることができます。

使い方

ブラウザエージェントバージョン 1.240.0以降では、転送するデータの種類に応じて 2 つの異なるタイプのプロキシを設定できます。ブラウザエージェントコードを取得するプロキシと、分析データを New に転送するプロキシです。遺物。

これらのプロキシを設定するには、次のブラウザエージェントプロパティを構成する必要があります。

init.proxy.assets ブラウザエージェントを取得する場所を決定します。
- コピー/ペーストのインストール方法を使用している場合は、JavaScript スニペットを手動で編集し、 assetsをドメイン URL に設定する必要があります。
- たとえば、ブラウザエージェント v1.240.0 を使用している場合Pro+SPA の場合、 init.proxy.assetsをassets.mydomain.comに設定すると、ブラウザエージェントはhttps://js-agent.newrelic.com/nr-spa.<hash>-1.240.0.min.jsではなくhttps://assets.mydomain.com/nr-spa.<hash>-1.240.0.min.jsからロードされます。
- NPM インストール方法を使用している場合、この構成は関係ありません。NPM にインストールされたブラウザーエージェントは、ホストアプリケーションと同じバンドルプロセスを経て、ホストアプリケーションと並んでoutputディレクトリにエージェントアセットが作成されます。ホストアプリケーションがデプロイされると、これらのエージェントアセットもデプロイされる必要があり、その結果、エージェントコードがサイトと同じドメインからすでに読み込まれます。
init.proxy.beacon 分析データの送信先を決定します。
- どちらのインストール方法でも、 beaconドメイン URL に設定する必要があります。
- たとえば、 beaconをbeacon.mydomain.comに設定すると、すべての可観測性データがhttps://beacon.mydomain.com/OBSERVABILITY_ENDPOINTに送信されます。

ユーザーのプライバシーが心配な場合は、クライアントの地理的位置を特定するために使用されるX-Forwarded-For HTTPヘッダーを除外できます。これを除外すると、New Relic は代わりにプロキシをクライアントとして位置特定します。

始めましょう

プロキシへのリクエストのリダイレクトを開始するには、ブラウザエージェントのインストールに使用した展開方法に基づいて、以下の手順を参照してください。

推奨事項

これらのプロパティを構成するときは、次のことをお勧めします。

ファーストパーティのサブドメインを使用します。技術的には別のサードパーティドメインを使用できますが、広告ブロッカーやセキュリティ VPN によってブロックされる可能性があります。
入力パターンは<domain>[:<port>][/<path>]です。プロトコル ( https://など) と終了スラッシュを必ず省略してください。portとpathはオプションであり、追加された場合は尊重されます。
assetsとbeaconの両方を構成している場合は、異なるサブドメインまたは異なるパスを使用して、プロキシごとに異なる値を設定します。これにより、プロキシサーバーの構成が非常に簡単になります。

コピー＆ペーストでインストール

コピー/ペーストのインストール方法を使用している場合は、エージェントローダーの前にブラウザの JavaScript 設定に次の設定を追加します。

window.NREUM.init = {
    ...<other init properties>,
    proxy: {
        assets: <URL string>
        beacon: <URL string>
    }
}

NPMのインストール

NPM ブラウザーのインストール方法を使用している場合は、ブラウザーエージェントの初期化時に次の構成を追加します。

new BrowserAgent({ 
  init: {
    ...<other init properties>,
    proxy: {
        beacon: <URL string>
    }
  }
})

プロキシの使用

New Relic はクラウドプロキシサービスを提供またはサポートしていないため、独自のプロキシサーバーを構成および管理する必要があります。完全な機能を保証するために、プロキシについて次のことを前提としています。

New Relic CDN からブラウザーエージェントコードをロードし、クライアントに返します。assetsフィールドを使用している場合、プロキシはブラウザエージェントコードをhttps://js-agent.newrelic.com/からロードし、クライアントに返す必要があります。たとえば、ブラウザエージェント v1.240.0 の場合、https://assets.mydomain.com/nr-spa.3b61d78f-1.240.0.min.jsへのリクエストは、上流のhttps://js-agent.newrelic.com/nr-spa.3b61d78f-1.240.0.min.jsからのレスポンスと同じレスポンスを返す必要があります。
クライアントのペイロードを New Relic に転送します。beaconプロキシはクライアントペイロードを New Relic に転送します。元のエンドポイントは、ブラウザのアプリケーション設定ページで見つけることができます。JavaScript スニペットで、 ;NREUM.info={beacon:"_____",...を探します。ほとんどのアプリでは、これは(https://)bam.nr-data.netになります。ただし、コンプライアンスや法的理由により異なる場合があります。たとえば、 https://yourproxy.com/1/asdf?a=123へのリクエストはhttps://bam.nr-data.net/1/asdf?a=123にパススルーされる必要があります。
リクエストとレスポンスは変更しないでください。プロキシサーバー経由のリクエストと応答は変更しないでください。
可観測性データの収集によって生成される帯域幅とトラフィックをサポートします。システムはプロキシ負荷をサポートできる必要がありますが、生成されるデータの量はサイトの使用状況によって異なります。

この機械翻訳は参考用に提供されます。

プロキシ エージェント コードと分析データ

重要