APMエージェントの無効化

テストやトラブルシューティングのためにNew Relic APMエージェントを一時的に無効化したい場合があります。このドキュメントではAPMエージェントを一時的にオフにする手順を説明しています。

関連手順:

APMエージェントの無効化

その手順については、お使いのエージェントタイプを選択します。

C SDK

C SDKは直接オンやオフにすることはできません。しかし、簡単な再コンパイルとデプロイによりインストゥルメンテーションを有効化または無効化できるようにSDKのコードを書くことができます。C SDKを無効にする、またはアンインストールするには、標準的な手順に従います。

Go

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

  • アプリケーションからgithub.com/newrelic/go-agentパッケージのインポートを削除し、newrelicネームスペースへのあらゆる呼び出しを削除するか、コメントアウトします。その後、アプリケーションを再コンパイルして、再起動します。
  • enabled構成設定を使用します。その後、アプリケーションを再コンパイルして、再起動します。(これはインストゥルメンテーションがまだ動作しているのでオーバーヘッドは減らず、データがNew Relicコレクターに送信されることのみを抑止します。)

エージェントを無効化したら、データが表示されなくなるまで数分かかります。

Java

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

  • agent_enabledfalseに設定してから、JVMを再起動します。
  • 次のJVMコマンドラインフラグを使用します。

    -Dnewrelic.config.agent_enabled=false
    

    JVMを再起動します。

  • newrelic.jarまたはnewrelic.ymlファイルを削除してから、JVMを再起動します。

エージェントを無効化したら、データが表示されなくなるまで数分かかります。

.NET

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

  • .NET Frameworkを使用している場合:C:\ProgramData\New Relic\.NET Agent\にあるグローバルnewrelic.configファイルで、agentEnabledfalseに設定します。IISでホストされるアプリケーションの場合はIISを再起動します。セルフホストのアプリケーションの場合(IIS以外)は、そのアプリケーションを再起動します。
  • .NET Coreを使用している場合:Coreエージェントのインストレーションディレクトリ(WindowsではNewRelic.Profiler.dll、LinuxではNewRelic.Profiler.soと同位置)にあるnewrelic.configファイルで、agentEnabledfalseに設定します。ASP.NET Core Moduleを使用する場合は、IISを再起動します。上記以外は、Coreアプリケーションを再起動します。

エージェントを無効化したら、データが表示されなくなるまで数分かかります。

Node.js

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

  • エージェント設定ファイルでagent_enabledfalseに設定してから、アプリケーションサーバーを再起動します。
  • NEW_RELIC_ENABLED環境変数をfalseに設定します。

エージェントを無効化したら、データが表示されなくなるまで数分かかります。

PHP

PHPエージェントを無効にするには、enabled構成設定をfalseに設定してから、WebサーバーまたはPHPを再起動します。

エージェントを無効化したら、データが表示されなくなるまで数分かかります。

Python

Pythonエージェントを無効にするには、お使いの環境設定やセットアップによって、主に3つの方法があります。

エージェントを無効化したら、データが表示されなくなるまで数分かかります。

Ruby

お使いの環境設定やセットアップによって、Rubyエージェントを無効にする方法がいくつかあります。

これらの方法はほとんどのインストゥルメンテーションを削除しますが、少量のアクティビティやオーバーヘッドが残ります。

  • agent_enabled構成設定を使用します。これは設定ファイルで実行するか、環境当たりのスタンザで実行します。その後にアプリケーションサーバーを再起動します。
  • 環境変数を使って同じことを実行し、アプリケーションサーバーを再起動します。

以下の方法は全てのインストゥルメンテーションとオーバーヘッドを削除します。

  • newrelic_rpmをGemfileとbundle installから削除します。
  • 以下をGemfileとbundle installに設定します。

    gem 'newrelic_rpm', :require => false
    

    このオプションは、アプリケーションのどこかで必要であればgemが必ずインストールされているようにしますが、bundleしているときはインストールしません。

エージェントを無効化したら、データが表示されなくなるまで数分かかります。

その他のヘルプ

推奨する詳細情報: