• /
  • ログイン

Node.jsエージェントの設定

newrelic.js設定ファイルを編集するか、環境変数を設定することで、Node.jsエージェントをアプリケーションの要件に合わせて調整できます。設定ファイルは、アプリケーションのルートディレクトリに存在します。また、New Relicでいくつかのオプションを設定するか、Node.jsエージェントAPIを使用することもできます。

重要

license_keyの設定が必要です。当社では、アプリケーションにデフォルトのMy Applicationではなく意味のある名前app_nameに付けることを強く推奨しています。

設定方法と優先順位

Node.jsエージェントを設定する最初の方法は、エージェント設定ファイル (newrelic.js) です。また、ほとんどの設定は環境変数を使用して設定できます。さらに、サーバーサイドコンフィグレーションを使用して調整できる設定もあります。

Node.jsエージェントは、設定方法に下記の優先順位の順序を使用します:

Node.jsエージェントの設定の優先順位

Node.js設定階層: サーバーサイドコンフィグレーション設定は環境変数に優先します。環境変数はエージェント設定ファイルに優先します。設定ファイルはエージェントのデフォルト設定に優先します。

各設定方法の詳細な説明は、以下のとおりです。

エクスポート変数

このセクションでは、お使いのアプリケーションのnewrelic.js設定ファイルのexports.config = {セクションに通常表示される順序で、Node.jsエージェントの変数を定義します。

変数のロギング

このセクションでは、お使いのアプリケーションのnewrelic.js設定ファイルのlogging: {セクションに通常表示される順序で、Node.jsエージェントの変数を定義しています。

監査ログ

このセクションでは、お使いのアプリケーションのnewrelic.js設定ファイルのaudit_log: {セクションに通常表示される順序で、Node.jsエージェントの変数を定義します。

APIの設定

このセクションでは、有効にするAPIメソッドを選択できます。各設定オプションでは、New Relicにカスタム情報を送信する役割を果たすAPIメソッドをモジュール式に有効化できます。

重要

エージェントが高セキュリティモードの場合、これらすべてはfalseに設定されます。

属性

このセクションでは、お使いのアプリケーションのnewrelic.js設定ファイルのattributes: {セクションに通常表示される順序で、Node.jsエージェントの変数を定義します。

注意

すべてのヘッダー関連の追加/除外ルールは、フィルタリング用にキャメルケース形式にする必要があります。

エラーコレクター変数

New Relicでエラーの処理方法を管理できます。このセクションでは、お使いのアプリケーションのnewrelic.js設定ファイルのerror_collector: {セクションに通常表示される順序で、Node.jsエージェントの変数を定義します。

トランザクショントレーサーの変数

エージェントは、次の目的に、リクエストをトランザクションに分類します。

  • アプリケーションが時間を費やしている場所を可視化します(トランザクションの内訳)。
  • 遅いリクエストを特定します。
  • メトリクスをグループ化します。
  • 遅いデータベースパフォーマンスなど、他の問題を切り分けます。

このセクションは、お使いのアプリケーションのnewrelic.js設定ファイルのtransaction_tracer: {セクションに通常表示される順序で、Node.jsエージェントの変数を定義します。

重要

トランザクション名の末尾に角括弧 [suffix] を使わないでください。New Relicは名前から自動的に角括弧を除去します。代わりに、必要に応じて丸括弧 (suffix)、またはその他の記号を使ってください。

ルールの変数

本セクションは、ご利用のアプリケーションのnewrelic.js設定ファイルのrules: {セクションに通常表示される順序によって、Node.jsエージェントの変数を定義します。

トランザクションイベントの変数

このセクションは、ご利用のアプリケーションのnewrelic.js設定ファイルのtransaction_events: {セクションに通常表示される順序によって、Node.jsエージェントの変数を定義します。

ブラウザモニターの変数

このセクションは、ご利用のアプリケーションのnewrelic.js設定ファイルのbrowser_monitoring: {セクションに通常表示される順序によって、Node.jsエージェントの変数を定義します。

カスタムイベント変数

このセクションは、ご利用のアプリケーションのnewrelic.js設定ファイルのcustom_insights_events: {セクションに通常表示される順序によって、Node.jsエージェントの変数を定義します。現時点では、カスタムイベントに関する環境変数はありません。

スロークエリ変数

このセクションは、ご利用のアプリケーションのnewrelic.js設定ファイルのslow_sql: {セクションに通常表示される順序によって、Node.jsエージェントの変数を定義します。こうしたオプションは、スロークエリに関する行動を制御するものの、トランザクショントレースにおけるSQLノードには作用しません。

カスタムホスト名変数

このセクションは、ご利用のアプリケーションのnewrelic.js設定ファイルのprocess_host: {セクションに通常表示される順序によって、Node.jsエージェントの変数を定義します。こうしたオプションは、New Relic APM UIにおけるホストのディスプレイ名に関する行動を制御します。

環境変数のオーバーライド

このセクションでは、環境変数のみで利用できる2つの設定を定義します。こうしたオーバーライドは、大半の設定では使用されません。

データストアトレーサーの変数

このセクションは、ご利用のアプリケーションのnewrelic.js設定ファイルのdatastore_tracerセクションに通常表示される順序によって、Node.jsエージェントの変数を定義します。こうしたオプションは、データストアインスタンスのメトリクスの収集に関する行動を制御します。

クロスアプリケーショントレーシング

クロスアプリケーショントレーシングを制御するNode.jsエージェントの変数は、通常はご利用のアプリケーションのnewrelic.js設定ファイルのcross_application_tracerセクションに表示されます:

エラーメッセージ編集の変数

このNode.jsエージェントの変数は、ご利用のアプリケーションのnewrelic.js設定のallow_raw_exception_messagesセクションに表示される、エラーメッセージ編集を制御します:

ディストリビューティッド(分散)トレーシング

重要

ディストリビューティッド(分散)トレーシングを有効にすると、クロスアプリケーショントレーシングが無効になり、他のAPM機能に影響します。有効にする前に、移行ガイドを読んでください。Node.jsエージェントのバージョン4.7.0以降が必要です

ディストリビューティッド(分散)トレーシングでは、リクエストが経由する分散システムのパスを見ることができます。設定ファイルを介して設定する場合、以下のオプションをdistributed_tracingセクションに配置してください。

ディストリビューティッド(分散)トレーシングが有効になっているときは、スパンイベントを収集することができます。

スパンイベント

スパンイベントディストリビューティッド(分散)トレーシングに関してレポートされます。スパンイベントをレポートするには、ディストリビューティッド(分散)トレーシングが有効になっていなければなりません。スパン設定はspan_eventsスタンザに設定されます。オプションに含まれるもの:

Infinite Tracing

Infinite Tracing をオンにするには、ディストリビューティッド(分散)トレーシングを有効にして(distributed_tracingenabled:true に設定)、以下の追加設定を加えます。例えば、「言語エージェント:ディストリビューティッド(分散)トレーシングを構成する」をご覧ください。

その他のヘルプ

さらに支援が必要な場合は、これらのサポートと学習リソースを確認してください:

問題を作成するこのページを編集する
Copyright © 2020 New Relic Inc.