Visual Studio 接続済みサービスを使用して Azure Application Insights を追加する

Visual Studio では、接続済みサービスの 機能を使用して、次のいずれかを Azure Application Insights に接続できます。

• .NET Framework コンソール アプリ
• ASP.NET モデル-View-Controller (MVC) (.NET Framework)
• ASP.NET Core
• .NET Core (コンソール アプリ、WPF、Windows フォーム、クラス ライブラリを含む)
• .NET Core Worker ロール
• Azure Functions
• ユニバーサル Windows プラットフォーム アプリ
• Xamarin
• コルドバ

接続されたサービス機能により、必要なすべての参照と接続コードがプロジェクトに追加され、構成ファイルが適切に変更されます。

前提 条件

• Azure ワークロードがインストールされている Visual Studio。
• サポートされている種類の 1 つのプロジェクト
• Azure アカウント。 Azure アカウントがない場合は、Visual Studio サブスクライバー向けの Azure の特典を有効にするか、無料試用版にサインアップします。

接続済みサービスを使用して Azure Application Insights に接続する

手記

.NET Framework プロジェクトの場合、接続済みサービス UI は若干異なります。 違いを確認するには、このページの Visual Studio 2019 バージョンと比較してください。

1. Visual Studio でプロジェクトを開きます。

2. ソリューション エクスプローラー で、接続済みサービス ノード 右クリックし、コンテキスト メニューから [の追加] 選択して、使用可能なサービスのメニューを開きます。

   

   [接続済みサービス] ノードが表示されない場合は、[プロジェクト]>[接続済みサービス]>[追加] を選択します。

3. [Azure Application Insights] を選びます。 [依存関係に接続する] ページが表示されます。 2 つのオプションが表示されます。1 つはローカル エミュレーター用、Application Insights Sdk (ローカル)、1 つはライブ Azure Application Insights サービスに接続するためのオプションです。 ローカル エミュレーターから始めることで、コストを削減し、早期開発を簡略化できます。 後でこれらの手順を繰り返し、もう一方のオプションを選択することで、ライブ サービスに移行できます。

   

   Application Insights SDK をローカルで使用する場合は、[次へ] をクリック して、プロジェクトがどのように変更されるかを示す 変更の概要 画面を表示します。 NuGet パッケージ参照がプロジェクトに追加され、ローカル エミュレーターの接続コードがプロジェクトに追加されます。

   Azure サービスに接続する場合は、次の手順に進みます。まだサインインしていない場合は、続行する前に Azure アカウントにサインインします。 Azure アカウントをお持ちでない場合は、無料試用版にサインアップできます。

4. Azure Application Insights の構成画面で、既存の Azure Application Insights コンポーネントを選択し、[次へ]を選択します。

   新しいコンポーネントを作成する必要がある場合は、次の手順に進みます。 それ以外の場合は、手順 7 に進みます。

   

5. Application Insights コンポーネントを作成するには:

   1. 画面の下部にある [新しい Application Insights コンポーネントの作成] を選択します。

   2. [Application Insights: 新規作成] 画面に入力し、[作成] を選択します。

      

   3. [Azure Application Insights の構成] 画面が表示されると、新しいコンポーネントが一覧に表示されます。 一覧で新しいコンポーネントを選択し、[次へ] 選択します。

6. 接続設定の名前とインストルメンテーション キー名を入力するか、既定値をそのまま使用します。

   

   手記

   セキュリティを強化するために、Visual Studio 17.12 以降では、この手順によって接続設定名が作成されます。以前のバージョンでは接続文字列が作成されます。 ローカル ファイルシステムに格納されている接続文字列は、誤って公開された場合にセキュリティ 上のリスクにつながる可能性があります。

7. [追加の設定 ] をクリックし、接続文字列をローカル シークレット ファイルに格納するか、Azure Key Vault 保存するかを選択します。

   

8. 変更の概要 画面には、プロセスを完了した場合にプロジェクトに加えられるすべての変更が表示されます。 変更が [OK] に見える場合は、[完了 ] を選択します。

   

9. ソリューション エクスプローラーで、接続済みサービス ノードをダブルクリックして、[接続済みサービスの ] タブ 開きます。サービス依存関係の セクションに接続が表示されます。

   

   追加した依存関係の横にある 3 つの点をクリックすると、接続 などのさまざまなオプションが表示され、ウィザードを再度開いて接続を変更できます。 また、ウィンドウの右上にある 3 つのドットをクリックして、ローカルの依存関係を開始したり、設定を変更したりするためのオプションを表示することもできます。

10. スタートアップ コード ファイル (テンプレートでProgram.cs) を開き、次のような行が追加されたことを確認します。

    builder.Services.AddApplicationInsightsTelemetry(builder.Configuration["APPLICATIONINSIGHTS_CONNECTION_STRING"]);
    

次の手順

ASP.NET Core プロジェクトの場合は、Application Insights for ASP.NET Core アプリケーションでアプリの監視を有効にする方法について説明します。

ASP.NET プロジェクトについては、「ASP.NET Web サイト の Application Insights の構成」を参照してください。

リンクをクリックすると、初期セットアップ手順の後の記事のセクションが表示されます。この手順は既に完了しています。

関連コンテンツ

• Azure Monitor 製品ページ
• Azure App Insights のドキュメント