APMエージェントの無効化

テストやトラブルシューティングなどの目的で、一時的にAPMエージェントを無効にしたい場合があります。本資料では、APMエージェントを一時的にオフにする手順を説明します。

APM エージェントを無効化またはオフにする

エージェントの種類を選択すると、説明が表示されます。

Goエージェントを無効にするには、主に2つの方法があります。

アプリケーションからgithub.com/newrelic/go-agentパッケージのインポートを削除し、 newrelic名前空間への呼び出しをすべて削除またはコメントアウトしてください。次に、アプリを再コンパイルして再起動します。
enabled構成設定を使用します。次に、アプリを再コンパイルして再起動します。(インストルメンテーションがまだ実行されているため、これによってオーバーヘッドが削減されることはありません。New Relic コレクターへのデータの送信が妨げられるだけです。)
ヒント
エージェントを無効にした後、データが表示されなくなるまで数分かかる場合があります。

Javaエージェントを無効にするには、主に3つの方法があります。

agent_enabledをfalseに設定してから、JVM を再始動してください。
JVMのコマンドラインフラグを使用します。
```
-Dnewrelic.config.agent_enabled=false
```
その後、JVMを再起動します。
newrelic.jarまたはnewrelic.ymlファイルを削除してから、JVM を再起動してください。
ヒント
エージェントを無効にした後、データが表示されなくなるまで数分かかる場合があります。

エージェントを無効にする方法は、FrameworkとCoreのどちらを使用しているかによって異なります。

.NET Framework: C:\ProgramData\New Relic\.NET Agent\ } にあるグローバルnewrelic.configファイルでagentEnabledをfalseに設定します。アプリケーションが IIS でホストされている場合は、IIS を再起動します。自己ホスト型 (非 IIS) の場合は、アプリケーションを再起動します。
.NET Core: Core エージェントのインストールディレクトリにあるnewrelic.configファイルでagentEnabledをfalseに設定します (Windows の場合はNewRelic.Profiler.dllと一緒に、Linux の場合はNewRelic.Profiler.soと一緒に)。ASP.NET Core モジュールを使用している場合は、IIS をリセットします。それ以外の場合は、コアアプリケーションを再起動します。
ヒント
エージェントを無効にした後、データが表示されなくなるまで数分かかる場合があります。

Node.jsエージェントを無効にするには、主に2つの方法があります。

エージェント構成ファイルでagent_enabledをfalseに設定し、アプリサーバーを再起動します。
NEW_RELIC_ENABLED環境変数をfalseに設定します。
ヒント
エージェントを無効にした後、データが表示されなくなるまで数分かかる場合があります。

Pythonエージェントを無効にするには、好みや設定に応じて、主に3つの方法があります。

標準インストール: monitor_mode構成設定を使用します。これは、構成ファイルを編集するか、環境変数を使用して行うことができます。
newrelic-adminスクリプトを使用した標準インストール: アプリケーションでそのスクリプトへの参照を削除します。
手動インストルメント: アプリケーションから初期化スクリプトを削除します。
ヒント
エージェントを無効にした後、データが表示されなくなるまで数分かかる場合があります。

Rubyエージェントを無効にするには、好みや設定に応じていくつかの方法があります。

これらの方法では、ほとんどの機器を取り除くことができますが、少量のアクティビティとオーバーヘッドが残ります。