ASP.NET Web サイトに Application Insights を設定するSet up Application Insights for your ASP.NET website

この手順では、Azure Application Insights サービスにテレメトリを送信するように ASP.NET Web アプリを構成します。This procedure configures your ASP.NET web app to send telemetry to the Azure Application Insights service. このサービスは、オンプレミスの IIS サーバーまたはクラウドでホストされる ASP.NET アプリに対して機能します。It works for ASP.NET apps that are hosted either in your own IIS server on-premises or in the Cloud. アプリのパフォーマンスと利用状況の把握に役立つグラフと強力なクエリ言語が提供され、エラーやパフォーマンスの問題に対する自動アラート機能も備えられています。You get charts and a powerful query language that help you understand the performance of your app and how people are using it, plus automatic alerts on failures or performance issues. 多くの開発者にとって、これらの機能はそのままでも便利ですが、必要に応じてテレメトリを拡張したりカスタマイズしたりすることもできます。Many developers find these features great as they are, but you can also extend and customize the telemetry if you need to.

セットアップは、Visual Studio でクリック操作を数回行うだけで済みます。Setup takes just a few clicks in Visual Studio. テレメトリの量を制限して、課金を回避するオプションもあります。You have the option to avoid charges by limiting the volume of telemetry. この機能により、ユーザーがそれほど多くないサイトを実験してデバッグしたり、監視したりすることができます。This functionality allows you to experiment and debug, or to monitor a site with not many users. 運用サイトに移行し、監視することに決定した場合は、後で制限を簡単に引き上げることができます。When you decide you want to go ahead and monitor your production site, it's easy to raise the limit later.

前提条件Prerequisites

ASP.NET Web サイトに Application Insights を追加するうえで必要なことは次のとおりです。To add Application Insights to your ASP.NET website, you need to:

  • 次のワークロードを使って、Windows 用の Visual Studio 2019 をインストールします。Install Visual Studio 2019 for Windows with the following workloads:
    • ASP.NET と Web 開発 (オプションのコンポーネントをオフにしないでください)ASP.NET and web development (Do not uncheck the optional components)
    • Azure の開発Azure development

Azure サブスクリプションをお持ちでない場合は、開始する前に無料アカウントを作成してください。If you don't have an Azure subscription, create a free account before you begin.

手順 1: Application Insights SDK を追加するStep 1: Add the Application Insights SDK

重要

このサンプルのスクリーンショットは、Visual Studio 2017 バージョン 15.9.9 以降に基づきます。The screenshots in this example are based on Visual Studio 2017 version 15.9.9 and later. Application Insights に追加する経験は、Visual Studio のバージョンや ASP.NET テンプレート タイプによって異なります。The experience to add Application Insights varies across versions of Visual Studio as well as by ASP.NET template type. 旧バージョンでは、「Application Insights の構成」といった代替テキストがない場合があります。Older versions may have alternate text such as "Configure Application Insights".

ソリューション エクスプローラーで Web アプリ名を右クリックし、 [追加] > [Application Insights Telemetry] を選択します。Right-click your web app name in the Solution Explorer, and choose Add > Application Insights Telemetry

[Application Insights の構成] が強調表示された、ソリューション エクスプローラーのスクリーンショット

(Application Insights SDK のバージョンに応じて、最新の SDK リリースへのアップグレードを促すメッセージが表示されることがあります。(Depending on your Application Insights SDK version you may be prompted to upgrade to the latest SDK release. メッセージが表示されたら、 [SDK の更新] を選択します。)If prompted, select Update SDK.)

スクリーンショット: Microsoft Application Insights SDK の新しいバージョンがあります。

Application Insights の構成画面:Application Insights Configuration screen:

[開始] を選択します。Select Get Started.

[アプリを Application Insights に登録します] ページのスクリーンショット

データを格納するリソース グループまたは場所を設定するには、 [設定の構成] をクリックします。If you want to set the resource group or the location where your data is stored, click Configure settings. リソース グループは、データへのアクセスの制御に使用されます。Resource groups are used to control access to data. たとえば、同じシステムの一部を構成する複数のアプリがある場合、そのアプリに関する Application Insights のデータを同じリソース グループ内に配置することができます。For example, if you have several apps that form part of the same system, you might put their Application Insights data in the same resource group.

[登録] を選択します。Select Register.

[アプリを Application Insights に登録します] ページのスクリーンショット

[プロジェクト] > [NuGet パッケージの管理] > [パッケージ ソース: nuget.org] の順に選択して、Application Insights SDK の最新の安定版リリースであることを確認します。Select Project > Manage NuGet Packages > Package source: nuget.org > Confirm that you have the latest stable release of the Application Insights SDK.

デバッグ時と、アプリを発行した後に、Azure Portal にテレメトリが送信されます。Telemetry will be sent to the Azure portal, both during debugging and after you have published your app.

注意

デバッグ中はポータルにテレメトリを送信しない場合は、Application Insights SDK をアプリに追加するだけにして、ポータルのリソースの構成は行いません。If you don't want to send telemetry to the portal while you're debugging, just add the Application Insights SDK to your app but don't configure a resource in the portal. デバッグ中は、Visual Studio でテレメトリを表示することができます。You are able to see telemetry in Visual Studio while you are debugging. この構成ページには後で戻ってくることができます。また、アプリがデプロイされ、実行時のテレメトリが有効にされるまで待つこともできます。Later, you can return to this configuration page, or you could wait until after you have deployed your app and switch on telemetry at run time.

手順 2: アプリケーションを実行するStep 2: Run your app

F5 キーを押して、アプリを実行します。Run your app with F5. ある程度のテレメトリを生成するために、複数のページを開きます。Open different pages to generate some telemetry.

Visual Studio で、ログに記録されたイベント数が表示されます。In Visual Studio, you will see a count of the events that have been logged.

Visual Studio のスクリーンショット。

手順 3: テレメトリを確認するStep 3: See your telemetry

Visual Studio または Application Insights Web ポータルで、テレメトリを確認できます。You can see your telemetry either in Visual Studio or in the Application Insights web portal. Visual Studio でテレメトリを検索し、アプリのデバッグに役立てます。Search telemetry in Visual Studio to help you debug your app. システムを稼働させたら、Web ポータルでパフォーマンスと使用状況を監視します。Monitor performance and usage in the web portal when your system is live.

Visual Studio でのテレメトリの表示See your telemetry in Visual Studio

Visual Studio で Application Insights のデータを表示するには、In Visual Studio, to view Application Insights data. [ソリューション エクスプローラー] > [接続済みサービス] の順に選択してから [Application Insights] を右クリックし、続いて [ライブ テレメトリの検索] をクリックします。Select Solution Explorer > Connected Services > right-click Application Insights, and then click Search Live Telemetry.

Visual Studio の [Application Insights の検索] ウィンドウに、アプリのサーバー側で生成されたテレメトリについて、アプリケーションのデータが表示されます。In the Visual Studio Application Insights Search window, you will see the data from your application for telemetry generated in the server side of your app. フィルターを試したり、任意のイベントをクリックして詳細を表示したりしてみましょう。Experiment with the filters, and click any event to see more detail.

[Application Insights] ウィンドウの [Data from Debug session (デバッグ セッションからのデータ)] ビューのスクリーンショット。

ヒント

データが何も表示されない場合は、時間の範囲が正しいかどうかを確認し、検索アイコンをクリックします。If you don't see any data, make sure the time range is correct, and click the Search icon.

Visual Studio の Application Insights ツールの詳細については、こちらを参照してくださいLearn more about Application Insights tools in Visual Studio.

Web ポータルでのテレメトリの表示See telemetry in web portal

Application Insights Web ポータルでもテレメトリを確認できます (SDK のみをインストールする場合を除く)。You can also see telemetry in the Application Insights web portal (unless you chose to install only the SDK). ポータルには、Visual Studio より多くのグラフ、分析ツール、クロスコンポーネント ビューが用意されています。The portal has more charts, analytic tools, and cross-component views than Visual Studio. ポータルには、アラートも用意されています。The portal also provides alerts.

Application Insights リソースを開きます。Open your Application Insights resource. Azure Portal にサインインするか、ソリューション エクスプローラー > [接続済みサービス] > [Application Insights] を右クリック > [Application Insights ポータルを開く] の順に選択すると、そこに表示されます。Either sign into the Azure portal and find it there, or select Solution Explorer > Connected Services > right-click Application Insights > Open Application Insights Portal and let it take you there.

ポータルを開くと、アプリのテレメトリが表示されます。The portal opens on a view of the telemetry from your app.

Application Insights 概要ページのスクリーンショット

詳細を表示するには、ポータルで任意のタイルまたはグラフをクリックします。In the portal, click any tile or chart to see more detail.

手順 4:アプリケーションの発行Step 4: Publish your app

IIS サーバーまたは Azure にアプリを発行します。Publish your app to your IIS server or to Azure. ライブ メトリック ストリーム を観察して、必要な処理がすべて滞りなく実行されていることを確認してください。Watch Live Metrics Stream to make sure everything is running smoothly.

Application Insights ポータルにはテレメトリが蓄積されており、メトリックを監視したり、目的のテレメトリを検索したりすることができます。Your telemetry builds up in the Application Insights portal, where you can monitor metrics, search your telemetry. 強力な Kusto クエリ言語を使用して、使用状況やパフォーマンスを分析したり、特定のイベントを見つけたりすることができます。You can also use the powerful Kusto query language to analyze usage and performance, or to find specific events.

Visual Studio から各種ツール (診断検索、傾向など) を使って継続的にテレメトリを分析することもできます。You can also continue to analyze your telemetry in Visual Studio, with tools such as diagnostic search and trends.

注意

アプリから送信されたテレメトリの量がスロットル制限に近づくと、自動サンプリングがオンに変わります。If your app sends enough telemetry to approach the throttling limits, automatic sampling switches on. アプリから送信されるテレメトリの量をサンプリングによって抑えながら、診断に利用できる相関性のあるデータを維持することができます。Sampling reduces the quantity of telemetry sent from your app, while preserving correlated data for diagnostic purposes.

設定の完了You're all set

お疲れさまでした。Congratulations! Application Insights パッケージをアプリにインストールし、Azure の Application Insights サービスにテレメトリを送信するように構成しました。You installed the Application Insights package in your app, and configured it to send telemetry to the Application Insights service on Azure.

アプリのテレメトリを受信する Azure リソースは、インストルメンテーション キーによって識別されます。The Azure resource that receives your app's telemetry is identified by an instrumentation key. このキーは、ApplicationInsights.config ファイルにあります。You'll find this key in the ApplicationInsights.config file.

新しいバージョンの SDK にアップグレードするUpgrade to future SDK versions

SDK の新しいリリースにアップグレードするには、NuGet パッケージ マネージャーを開き、インストールされているパッケージに対してフィルターを実行します。To upgrade to a new release of the SDK, open the NuGet package manager, and filter on installed packages. [Microsoft.ApplicationInsights.Web][アップグレード] の順に選択します。Select Microsoft.ApplicationInsights.Web, and choose Upgrade.

ApplicationInsights.config をカスタマイズしている場合は、アップグレードする前にコピーを保存しておきます。If you made any customizations to ApplicationInsights.config, save a copy of it before you upgrade. その後、新しいバージョンに変更をマージします。Then, merge your changes into the new version.

ビデオVideo

次の手順Next steps

関心をお持ちの場合は、他にも次のようなトピックをご覧いただけます。There are alternative topics to look at if you are interested in:

テレメトリの追加More telemetry

分析Analysis

アラートAlerts

  • 可用性テスト: サイトが Web で表示できることを確認するためのテストを作成します。Availability tests: Create tests to make sure your site is visible on the web.
  • スマート診断: これらのテストは自動的に実行されます。セットアップするために何かをする必要はありません。Smart diagnostics: These tests run automatically, so you don't have to do anything to set them up. アプリの要求が失敗する割合が異常な場合に通知します。They tell you if your app has an unusual rate of failed requests.
  • メトリック アラート: メトリックがしきい値を超えた場合に警告するようにアラートを設定 します。Metric alerts: Set alerts to warn you if a metric crosses a threshold. メトリック アラートはカスタム メトリックで設定し、コード化してアプリに組み込むことができます。You can set them on custom metrics that you code into your app.

AutomationAutomation