• English日本語한국어
  • ログイン今すぐ開始

この機械翻訳は参考用に提供されます。

英語版と翻訳版に矛盾がある場合は、英語版が優先されます。詳細については、こちらのページをご覧ください。

問題を作成する

Azure Web Appsへの.NETエージェントのインストール

このドキュメントでは、New Relic のアプリケーションパフォーマンス監視用 .NET エージェントを Azure Web App にインストールする方法を説明します。(これは、 Microsoft Azure のインフラストラクチャ モニタリング インテグレーションのインストールとは異なります。) 推奨: この手順に従う前に、 .NET エージェントのインストール概要 をお読みください。

インストールオプション

以下のいずれかの方法を使用して、New Relic .NET エージェントを Azure 展開された Web アプリに追加します。最適なオプションは、お客様の役割、環境、デプロイメントなどによって異なります。たとえば、以下のようになります。

アプリを監視する必要がある運用チームにとって、最も簡単で信頼性の高い選択肢は、一般に公開されているAzureサイト拡張機能を使用することです。

注意: Azure Site Extensionsは、現在、Windows App Serviceリソースでのみ利用可能です。

開発チームや、Linux App Service Resourceにエージェントを配置する必要がある場合は、nuget経由でインストールするのが最適です。

非Webアプリ(WebJobsを含む)または.NETFrameworkを対象とするASP.NETCoreアプリを監視するには、次の2つの方法のいずれかを使用して、そのアプリケーションの.exeプロセスに対してエージェントを明示的に有効にする必要があります。

さらに、WebJobsでは、トランザクションをAPMに表示するためのカスタムインストルメンテーションと、実行時間が1分未満の場合は 追加の構成が必要になる場合があります。

Application Insightsの無効化

NewRelicの.NETエージェントとMicrosoftApplicationInsightsはどちらもCLRプロファイラーに依存していますが、一度にアクティブにできるのは1つだけです。 .NETエージェントが正しく機能するには、ApplicationInsightsを無効にする必要があります。詳細については、 ApplicationInsightsのトラブルシューティング手順を参照してください。

New Relic Azure Site Extension を使用したインストール (Windows のみ)

New Relic Azure Site Extension を使用して Azure Web App 用の .NET エージェントをインストールするには、以下の手順に従います。

  1. New Relic Azure Site Extension をインストールする前に、Web アプリケーションをシャットダウンしてください。

  2. サイト拡張機能を追加しますhttps://[yoursitename].scm.azurewebsites.netに移動し、[サイト拡張機能]>[ギャラリー]を選択します。

  3. New Relic サイトエクステンションの横にあるプラス

    のアイコンを選択します。

  4. Azure portal で、New Relicアプリの設定を Azure App Service に追加します。これにより、最新の .NET エージェント バージョンがインストールされます。バージョン 10.x では、.NET Framework 4.6.1 以前および .NET Core 3.0 以前のサポートを終了しました (移行ガイドを参照してください)。より低いエージェント バージョンが必要な場合は、 NEWRELIC_AGENT_VERSION_OVERRIDE環境変数を使用してください。例: NEWRELIC_AGENT_VERSION_OVERRIDE=9.9.0

  5. Webアプリを再起動します。

ヒント

サイト拡張機能をすでにインストールし、バージョン オーバーライドを設定しているにもかかわらず、アプリケーションがレポートを行わない場合は、環境変数が認識され、正しいバージョンがインストールされるように、サイト拡張機能を削除して再インストールする必要がある場合があります。

このインストール プロセスに関連するいくつかの注意事項:

  • カスタム インストルメンテーション XML を追加するか、ベースnewrelic.configファイルを変更する必要がある場合は、.NET Framework 用の .NET エージェントが%HOME%\NewRelicAgent\Frameworkに、.NET Core 用のエージェントが%HOME%\NewRelicAgent\Coreにあります。

  • このインストール方法は、Azure Web Apps インスタンス上のすべての.NET Core アプリケーションを監視します。特定の .NET Core アプリケーションの監視を無効にする場合は、次のいずれかを実行できます。

New Relic Azure Site Extension でエージェントを更新する

New Relic Azure Site Extension を使用して Azure Web アプリの .NET エージェントを更新するには、インストール手順に従って次の手順を実行します。

  • New Relic Azure Site Extension の最新バージョンをインストールします。これにより、エージェント ファイルが最新バージョンに更新されます。
  • Web アプリを再起動して、更新されたエージェントを開始します。

NuGetによるインストール(.NET Framework)

NuGet のインストール方法では、New Relic エージェントがアプリケーションにパッケージ化され、Azure Web App Host で使用できるようになります。

この手順のNuGetパッケージは、古いpackages.configのみをサポートします。現在のPackageReference形式はサポートされていません。詳細については、 Microsoftのパッケージリファレンスドキュメントを参照してください。

マルチプロジェクトソリューションの場合、NuGetパッケージをインストールする前に、正しいプロジェクト(例えば、特定のWebアプリのプロジェクト)が選択されていることを確認してください。

NuGet を使用して .NET Framework エージェントをアップグレードする場合、 newrelic.configで行った変更はすべて上書きされます。変更を保持するには、 newrelic.configをプロジェクトの外に保存し、アップグレード後に復元してください。

NuGetを使用してAzure Web Appに.NETエージェントをインストールするには、以下の手順に従います。

  1. Azure ポータルで、Azure Platform(32 ビットまたは 64 ビット)を確認します。Azure サイドバーメニューから、 App Services> Your Application> Settings> Configuration> General settings.

  2. Visual Studio でアプリケーションを開き、 Package manager [パッケージ マネージャー]コンソールから適切なコマンドを実行して New Relic NuGet パッケージをインストールします。

    • 32ビットInstall-Package NewRelic.Azure.WebSites
    • 64ビットInstall-Package NewRelic.Azure.WebSites.x64
  3. アプリケーションを公開します。

  4. Azure ポータルで、監視したい Web アプリを開き、 設定> 構成 を選択します。

  5. [構成] から [ + 新しいアプリケーション設定]を選択し、これらのキーと値のペアを追加します。

重要

これらの例はすべて、AzureWebアプリがD:ファイルシステムルートを使用していることを前提としています。 Azure WebでC:ルートを使用する場合は、これらのパスを構成するときに正しいドライブ文字を使用する必要があります。

価値

COR_ENABLE_PROFILING

1

COR_PROFILER

{71DA0A04-7777-4EC6-9643-7D28B46A8A41}

COR_PROFILER_PATH

D:\Home\site\wwwroot\newrelic\NewRelic.Profiler.dll

NEWRELIC_HOME

D:\Home\site\wwwroot\newrelic

  1. Azureポータルで、New Relic app settings をAzure App Serviceに追加します。
  2. Webアプリを再起動します。

NuGetによるインストール(.NET Core)

NuGet のインストール方法では、New Relic エージェントがアプリケーションにパッケージ化され、Azure Web App Host で使用できるようになります。

当社の .NET エージェントは、Azure App Services 上の .NET Core Linux および Windows アプリケーションをサポートしています。Azure App Services のインストール プロセスは、Linux および Windows の.NET エージェントのインストール手順とは異なります。

NuGetを使用してAzure Web Appに.NETエージェントをインストールするには、以下の手順に従います。

  1. NewRelic.Agent NuGetパッケージをインストールします。

  2. newrelic.configファイルにディレクトリ属性を追加してログノードを変更します(注: Visual StudioでNuGetによってプロジェクトに追加されたnewrelic.configファイルを編集できない場合は、このファイルのローカルコピーを作成する必要があります。あなたの申請):

  3. アプリケーションを公開します。

  4. Azure ポータルで、監視したい Web アプリを開き、 設定> 構成 を選択します。

  5. [構成] から [ + 新しいアプリケーション設定]を選択し、これらのキーと値のペアを追加します。

重要

これらの例はすべて、AzureWebアプリがD:ファイルシステムルートを使用していることを前提としています。 Azure WebでC:ルートを使用する場合は、これらのパスを構成するときに正しいドライブ文字を使用する必要があります。

  1. Azureポータルで、New Relic app settings をAzure App Serviceに追加します。
  2. Webアプリを再起動します。

New Relicアプリの設定をAzure App Servicesに追加する

アプリの設定を追加するには

  1. あなたが持っていることを確認してください New Relic .NET エージェントのアプリ設定を追加する前に。

  2. Azure ポータルで、 App Services を検索して開き、監視する Web アプリに移動します。次に、 Configuration> Application settings を選択します。

  3. [アプリケーション設定] から [ + 新しいアプリケーション設定]を選択し、次のキーと値のペアを追加します。

    価値

    NEW_RELIC_LICENSE_KEY

    あなたのライセンスキー

    NEW_RELIC_APP_NAME

    お客様のアプリ名

    以前の .NET エージェント バージョンを使用する必要がある場合は、次のキーと値のペアを使用します。

    価値

    NEWRELIC_AGENT_VERSION_OVERRIDE

    DESIRED_AGENT_VERSION_NUMBER

  4. 保存してWebアプリを再起動します。

の設定 アプリケーション設定 のアプリ名はnewrelic.configをオーバーライドします。

アプリのKudu診断コンソールで、アプリの環境変数を確認するには、 環境> 環境変数 をご覧ください。

例えば:

https://myappname.scm.azurewebsites.net/Env.cshtml#envVariables

アプリのパフォーマンスを見る

New Relic でアプリケーションのパフォーマンスを表示するには、アプリケーションがトラフィックを受信する必要があります。データが表示され始めるまでに数分かかる場合があります。データが表示されない場合は、Azure Web Apps の トラブルシューティング手順を 参照してください。New Relic でアプリのパフォーマンスを表示するには: one.newrelic.com > All capabilities > APM & services > (アプリを選択)に移動します。APM Summary [概要] ページが 自動的に表示されます。

このドキュメントはインストールで役立ちましたか。

トラブルシューティング

エージェントをインストールしてアプリのトラフィックを生成し、数分待ってもデータが表示されない場合は、以下のトラブルシューティングをお試しください。

  • アプリのルートにあるnewrelicディレクトリ内のすべてのファイルがAzureに公開されていることを確認してください。
  • 環境変数が正しく設定されているか確認してください。
  • MicrosoftApplicationInsightsがアプリケーションにインストールおよび構成されていないことを確認してください。詳細については、 ApplicationInsightsのトラブルシューティング手順を参照してください。
  • 必要に応じて、追加の Azure トラブルシューティング手順 を参照してください。
Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.