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 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 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.

開始する前にBefore you start

必要なもの:You need:

  • Visual Studio 2013 Update 3 以降。Visual Studio 2013 update 3 or later. より新しいバージョンが適しています。Later is better.
  • Microsoft Azure サブスクリプション。A subscription to Microsoft Azure. チームまたは組織で Azure サブスクリプションを取得している場合、所有者は Microsoft アカウントを使用してあなたを追加できます。If your team or organization has an Azure subscription, the owner can add you to it, by using your Microsoft account.

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

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

ソリューション エクスプローラーで Web アプリのプロジェクトを右クリックし、[追加] > [Application Insights Telemetry...] または [Application Insights の構成] の順に選択します。Right-click your web app project in Solution Explorer, and choose Add > Application Insights Telemetry... or Configure Application Insights.

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

(Visual Studio 2015 でも、[新しいプロジェクト] ダイアログに、Application Insights を追加するオプションがあります。)(In Visual Studio 2015, there's also an option to add Application Insights in the New Project dialog.)

Application Insights の構成ページに進みます。Continue to the Application Insights configuration page:

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

a.a. Azure へのアクセスに使用するアカウントとサブスクリプションを選択します。Select the account and subscription that you use to access Azure.

b.b. Azure のリソースを選択します。このリソースのデータをアプリに表示します。Select the resource in Azure where you want to see the data from your app. 通常は、次のようにします。Usually:

データを格納するリソース グループまたは場所を設定するには、[設定の構成] をクリックします。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.

c.c. 課金を回避するために、無料のデータ ボリュームの範囲で上限を設定します。Set a cap at the free data volume limit, to avoid charges. Application Insights では、一定の量までのテレメトリが無料で提供されます。Application Insights is free up to a certain volume of telemetry. リソースが作成された後、ポータルで [機能と価格設定] > [データ管理] > [日次ボリューム上限] の順に開いて選択内容を変更することができます。After the resource is created, you can change your selection in the portal by opening Features + pricing > Data volume management > Daily volume cap.

d.d. [登録] をクリックして、Web アプリ向けに Application Insights を構成します。Click Register to go ahead and configure Application Insights for your web app. デバッグ時と、アプリを発行した後に、Azure Portal にテレメトリが送信されます。Telemetry will be sent to the Azure portal, both during debugging and after you have published your app.

e.e. デバッグ中はポータルにテレメトリを送信しない場合は、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 will be 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 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, open the Application Insights window. [Application Insights] ボタンをクリックするか、ソリューション エクスプローラーでプロジェクトを右クリックし、[Application Insights] を選択してから [ライブ テレメトリの検索] をクリックします。Either click the Application Insights button, or right-click your project in Solution Explorer, select Application Insights, and then click Search Live Telemetry.

Visual Studio の [Application Insights の検索] ウィンドウの [Data from Debug session (デバッグ セッションからのデータ)] ビューで、アプリのサーバー側で生成されたテレメトリを確認します。In the Visual Studio Application Insights Search window, see the Data from Debug session view 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 にサインインすると、そこに表示されます。または、Visual Studio でプロジェクトを右クリックし、メニューから表示します。Either sign in to the Azure portal and find it there, or right-click the project in Visual Studio, and let it take you there.

Application Insights ポータルを開く方法を示した Visual Studio のスクリーンショット

注意

アクセス エラーが発生した場合: Microsoft 資格情報のセットが複数あり、間違ったセットでサインインしていませんか。If you get an access error: Do you have more than one set of Microsoft credentials, and are you signed in with the wrong set? ポータルでサインアウトし、もう一度サインインしてください。In the portal, sign out and sign in again.

ポータルを開くと、アプリのテレメトリが表示されます。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.

Azure Portal での Application Insights の使用方法の詳細については、こちらを参照してくださいLearn more about using Application Insights in the Azure portal.

手順 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, and set up dashboards. 強力な Log Analytics クエリ言語を使って使用状況やパフォーマンスを分析したり、特定のイベントを見つけたりすることができます。You can also use the powerful Log Analytics 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 again, 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

テレメトリの追加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 these to warn you if a metric crosses a threshold. メトリック アラートはカスタム メトリックで設定し、コード化してアプリに組み込むことができます。You can set them on custom metrics that you code into your app.

AutomationAutomation