browserログを自動検出
自動ログは、 browser console から発行されたログメッセージを収集し、フロントエンド アプリケーションの監視性を最大化するのに役立ちます。
Browserログは、デフォルトでは、 ProおよびPro+SPAエージェントのWARNレベルで追跡されますが、Lite ブラウザエージェントでは使用できません。 まず、 ProまたはPro + SPAブラウザ エージェントを使用していることを確認することをお勧めします。
重要
ブラウザーのログ収集の有効化または無効化、サンプル レートやログの冗長性の調整などの特定の設定は、サーバー側構成です。 エージェント スニペットをページに追加したら、これらの設定を変更するためにスクリプトを再デプロイする必要はありません。ただし、その機能がデプロイ スクリプトに含まれていない場合、サーバー側構成は効果がありません。 これは、BrowserAgent バージョン1.259.0以降に適用されます。
browser自動ログの仕組み
browserログの自動インストゥルメンテーションは、設定で設定されたログレベルとサンプリングレートに基づいて、次の方法でメッセージの収集を試みます。
方法 | レベル |
|---|---|
console.log |
|
console.error |
|
console.warn |
|
console.info |
|
console.debug |
|
console.trace |
|
デフォルトでは、ログデータは 30 日間保存されますが、実際のデータ保持期間はアカウントによって異なります。
前提条件
ProまたはPro + SPAブラウザ エージェント:
エージェントバージョン
設定動作
1.283.0 - 1.305.0アプリケーション設定はコンソールと手動ログの両方に適用されます
1.306.0以降コンソールログと手動ログには、詳細度、サンプリング、有効化/無効化コントロールの個別の設定があります。
重要
自動ログ検出は、Lite Browser エージェントでは利用できません。
自動ログ収集を有効にする（既存のブラウザアプリの場合）
これらの簡単なセットアップ手順に従って、アプリケーションの監視機能とデバッグ機能を強化します。
one.newrelic.com > All Capabilities > Browserに移動します。
ブラウザ アプリを選択します。
左側のメニューで、 Application settings [アプリケーション設定] をクリックします。
ProまたはPro + SPAブラウザ エージェントが選択されていることを確認します。
ブラウザのコンソールに送信されたメッセージを収集するには、 Automatically collect console logs [コンソール ログを自動的に収集する]をON [オン]に切り替えます。newrelic.log()またはnewrelic.wrapLogger()経由でプログラムによって送信されたログを収集するには、 Collect logs manually [ログを手動で収集]をON [オン]に切り替えます。
サンプリング レートを編集して、ログを収集するユーザー セッションの割合を指定します。0 から 100 までの値を入力できます。
重要
ブラウザ ログのデフォルトのサンプリング レートは、ユーザー セッションの 100% に設定されています。このセッションのサンプリング レートは、 0%から100%の間の任意の値に設定できます。たとえば、セッションのサンプリング レートを50%に設定すると、ランダムに選択されたユーザー セッションの約半数からログイベントが収集されます。
必要なブラウザ ログの詳細レベルを選択します。デフォルトの詳細レベルはWARNに設定されています。選択できるレベル:
ERROR-ERRORレベルのログを収集するWARN-WARNまたはERRORレベルのログを収集しますINFO-INFO、WARN、またはERRORレベルのログを収集しますDEBUG-DEBUG、INFO、WARN、またはERRORレベルのログを収集しますTRACE-TRACE、DEBUG、INFO、WARN、またはERRORレベルのログを収集します重要
コンソール メソッドを介して渡されるデータは、シリアル化および難読化される可能性があります。 サイズと頻度によっては、アプリケーションのパフォーマンスやデータコストに悪影響を及ぼす可能性があります。 一般に、大きなオブジェクトや大量のデータをコンソール メソッドに渡すことは推奨されません。
ブラウザログを無効にする
既存のブラウザ アプリのブラウザ ログを無効にするには:
one.newrelic.com > All Capabilities > Browserに移動します。
ブラウザ アプリを選択します。
左側のメニューで、 Application settings [アプリケーション設定] をクリックします。
Automatically collect console logs [コンソール ログを自動的に収集する]およびCollect logs manually [ログを手動で収集するを]OFF [オフ]に切り替えます。
データ消費
ログは、他のbrowserバイトと同じ消費価格設定に従います。 生成されるバイトの量は、メッセージの数と長さによって異なります。
自動ロギング機能により、ロギングイベントにカスタムアトリビュートを追加する場合を除き、newrelic.log または newrelic.wrapLogger browser API呼び出す必要がなくなります。