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

重要

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

BrowserAgent のプロキシ URL を設定することは、パフォーマンスを目的として監視データが確実に収集されるようにするための貴重な方法となります。

プロキシ方式を使用する場合は、エンドユーザーおよび/またはサイト訪問者に対する契約上、規制上、またはその他の法的義務に基づいてプロキシ方式を使用する権利があることを確認することが重要です。この方法が組織にとって実行可能で準拠したソリューションであることが確認できた場合は、以下の設定手順を参照してください。

使い方

ブラウザエージェントバージョン 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 はクラウドプロキシサービスを提供またはサポートしていないため、独自のプロキシサーバーを構成および管理する必要があります。完全な機能を保証するために、プロキシについて次のことを前提としています。

Load the browser agent code from the New Relic CDN and pass it back to the client.
assetsフィールドを使用している場合、プロキシはhttps://js-agent.newrelic.com/からブラウザエージェントコードをロードし、それをクライアントに返す必要があります。たとえば、BrowserAgent 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からのレスポンスと同じレスポンスを返す必要があります。
Forward client payloads to 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にパススルーされる必要があります。
Do not modify requests and responses.
プロキシサーバー経由のリクエストと応答は変更しないでください。
Support the bandwidth and traffic generated by observability data collection.
システムはプロキシ負荷をサポートできる必要がありますが、生成されるデータの量はサイトの使用状況によって異なります。

この機械翻訳は、参考として提供されています。

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

重要