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

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

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

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

Note

このトピックは、Windows 上の Visual Studio に適用されます。 Visual Studio for Mac については、Visual Studio for Mac での接続済みサービスに関するページを参照してください。

必須コンポーネント

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

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

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

  3. [接続済みサービス] タブで、 [サービスの依存関係] の [+] アイコンを選択します。

    Screenshot showing

  4. [依存関係の追加] ページで、[Azure Application Insights] を選択します。

    Screenshot showing

    まだサインインしていない場合は、Azure アカウントにサインインします。 Azure アカウントを持っていない場合、無料試用版でサインアップできます。

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

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

    Screenshot showing

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

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

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

      Screenshot showing

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

  7. インストルメンテーション キー名を入力するか、既定値を選択し、接続文字列をローカル シークレット ファイルと Azure Key Vault のどちらに保存するかを選択します。

    Screenshot showing

  8. [変更の概要] 画面には、プロセスを完了した場合にプロジェクトに対して行われるすべての変更が表示されます。 変更が問題ない場合は、 [完了] を選択します。

    Screenshot showing

  9. 接続は、 [接続済みサービス] タブの [サービスの依存関係] セクションに表示されます。

    Screenshot showing

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

Note

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

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

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

    Screenshot showing Connected Services context menu options.

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

    Screenshot showing Application Insights choices.

    アプリケーション インサイト SDK をローカルで使用する場合は、[次へ] をクリックして変更の概要画面を表示します。プロジェクトの変更方法が示されます。 NuGet パッケージの参照と、ローカル エミュレーターの接続コードが、プロジェクトに追加されます。

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

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

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

    Screenshot showing

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

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

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

      Screenshot showing

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

  6. インストルメンテーション キー名を入力するか、既定値を選択し、接続文字列をローカル シークレット ファイルと Azure Key Vault のどちらに保存するかを選択します。

    Screenshot showing

  7. [変更の概要] 画面には、プロセスを完了した場合にプロジェクトに対して行われるすべての変更が表示されます。 変更が問題ない場合は、 [完了] を選択します。

    Screenshot showing

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

    Screenshot showing

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

  9. スタートアップ コード ファイル (テンプレート内の Program.cs) を開き、次のような行が追加されていることに注意してください。

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

次のステップ

ASP.NET Core プロジェクトの場合、ASP.NET Core アプリケーションの Application Insights に関する記事でアプリの監視を有効にする方法を参照してください。

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

リンクをクリックすると、記事の中の既に完了している初期設定手順の後のセクションに移動します。