ラボ 11: Azure にデプロイされたサービスを監視する

Microsoft Azure ユーザーインターフェイス

Microsoft クラウドツールの動的な性質を考慮すると、このトレーニングコンテンツの開発の後に発生する Azure UI の変更に気付くかもしれません。その結果、ラボの指示とラボの手順が正しく整合しなくなる可能性があります。

Microsoft は、コミュニティから必要な変更の通知があったときに、このトレーニングコースを更新します。ただし、クラウドの更新は頻繁に発生するため、このトレーニングコンテンツの更新の前に UI の変更に気付く可能性があります。 これが発生した場合は、その変更に適応し、ラボでは必要に応じてそれらに対応してください。

Instructions

開始する前に

ラボ環境にサインインする

次の資格情報を使用して Windows 11 仮想マシン (VM) にサインインします。

ユーザー名: Admin
パスワード: Pa55w.rd

注: 仮想ラボ環境に接続するための手順は、インストラクターから提供されます。

インストールされているアプリケーションを確認する

Windows 11 デスクトップでタスクバーを探します。タスクバーには、このラボで使用する次のようなアプリケーションのアイコンが含まれています。

Microsoft Edge
エクスプローラー
Visual Studio Code
Azure PowerShell

課題シナリオ

このラボでは、後で確認するために Application Insights データの監視とログ記録に使用する Application Insights リソースを Azure に作成します。 API は、需要が特定のしきい値まで増加した場合に自動的にスケーリングするように設定されます。データのログ記録は、サービスがどのように利用されているかを判断するのに役立ちます。

アーキテクチャの図

Azure にデプロイされたサービスの監視状態を示すアーキテクチャ図

演習 1: Azure リソースをデプロイして構成する

タスク 1: Azure portal を開く

タスクバーで、Microsoft Edge アイコンを選択します。
ブラウザーウィンドウで、Azure portal (https://portal.azure.com) に移動してから、このラボで使用するアカウントでサインインします。

注:初めて Azure portal にサインインする場合は、このポータルのツアーが表示されます。 [はじめに] を選択してツアーをスキップし、ポータルの使用を開始します。

タスク 2: Application Insights リソースを作成する

Azure portal で、ページの上部にある [リソース、サービス、ドキュメントの検索] テキストボックスを使用して、「Application Insights」を検索してから、結果のリストで [Application Insights] を選択します。
[Application Insights] ブレードで、 [+ 作成] を選択します。

[Application Insights] ブレードの [基本] タブで、次のアクションを実行し、[確認および作成] を選択します。

設定	アクション
[サブスクリプション] ドロップダウンリスト	既定値のままにします
[リソースグループ] セクション	[新規作成] を選択して、「MonitoredAssets」と入力してから、 [OK] を選択します。
[名前] テキストボックス	instrm [ご自分の名前]
[リージョン] ドロップダウンリスト	Application Insights リソースをデプロイできる Azure リージョンを選択します。
[リソースモード] セクション	[ワークスペースベース] オプションを選択します。
[ワークスペースの詳細] セクション	[サブスクリプション] ドロップダウンリストと [Log Analytics ワークスペース] ドロップダウンリストの既定値をそのまま使用します。

次のスクリーンショットは、 [Application Insights] ブレードで構成された設定を示しています。

Azure Application Insights インスタンスブレードを作成する

[確認と作成] タブで、前の手順で選択したオプションを確認します。
[作成] を選択し、指定した構成を使用して Application Insights インスタンスを作成します。

注: 作成タスクが完了するのを待ってから、このラボを続行してください。
[Microsoft.AppInsights | 概要] ブレードで、 [リソースに移動] ボタンを選択し、新しく作成された Application Insights リソースのブレードに移動します。
[Application Insights] ブレードの [構成] セクションで、 [プロパティ] リンクを選択します。
[プロパティ] ブレードで、 [インストルメンテーションキー] エントリの横にある [クリップボードにコピー] ボタンを選択してから、コピーした値を記録します。この値は、このラボで後ほど使用します。

注: キーは、クライアントアプリケーションで特定の Application Insights リソースに接続するために使用されます。

タスク 3: Azure Web API リソースを作成する

Azure portal で、ページの上部にある [リソース、サービス、ドキュメントの検索] テキストボックスを使用して、「App Services」を検索し、結果のリストで [App Services] を選択します。
[App Services] ブレードで、 [+ 作成] を選択します。

[Web アプリの作成] ブレードの [基本] タブで、次のアクションを実行してから、 [監視] タブを選択します。

設定	アクション
[サブスクリプション] ドロップダウンリスト	既定値のままにします
[リソースグループ] ドロップダウンリスト	[MonitoredAssets] を選択します。
[名前] テキストボックス	「smpapi[ご自分の名前]」と入力します
[公開] セクション	[コード] を選択します
[ランタイムスタック] ドロップダウンリスト	[.NET 8 (LTS)] を選びます
[オペレーティングシステム] セクション	[Windows] を選択します
[リージョン] ドロップダウンリスト	Application Insights リソースの場所として選択したのと同じリージョンを選択します。
[Windows プラン (米国東部)] セクション	[新規作成] を選び、 [名前] テキストボックスに「MonitoredPlan」と入力してから、 [OK] を選択します
[価格プラン] セクション	既定値のままにします

[監視] タブで、次のアクションを実行してから、[確認と作成] を選択します。

設定	アクション
[Application Insights を有効にする] セクション	[はい] が選択されていることを確認します
[Application Insights] ドロップダウンリスト	このラボで前に作成した instrm [ご自分の名前] Application Insights リソースを選択します。

[確認と作成] タブで、前の手順で選択したオプションを確認します。
[作成] を選択し、指定した構成を使用して Web API を作成します。

注: 作成タスクが完了するのを待ってから、このラボを続行してください。
デプロイの [概要] ブレードで、 [リソースに移動] ボタンを選択して、新しく作成された Azure Web API のブレードに移動します。
[App Service] ブレードの [設定] セクションで、 [構成] リンクを選択します。
[構成] セクションで、次のアクションを実行します。

a. [アプリケーションの設定] タブで、 [値の表示] を選択して、Web API に関連付けられたシークレットを表示します。

b. APPLICATIONINSIGHTS_CONNECTION_STRING キーを表す値に注目してください。この値は、Web API リソースをビルドするときに自動的に設定されたものです。
[App Service] ブレードの [設定] セクションで、 [プロパティ] リンクを選択します。
[プロパティ] セクションで、 [URL] リンクの値を記録します。この値は、ラボの後半で Web API に要求を送信するために使用します。

タスク 4: Web API 自動スケーリングオプションを構成する

[App Service] ブレードの [設定] セクションで、 [スケールアウト (App Service プラン)] リンクを選択します。
[スケールアウト方法] が表示されるまで下にスクロールします。 [ルールベース] オプションをクリックし、[ルールベースのスケーリングの管理] を選択します。

スケールアウト方法の正しいオプションを選択する

[スケールアウト] セクションで、次のアクションを実行してから、 [保存] を選択します。

設定	アクション
[スケールアウト] セクション	[カスタム自動スケーリング] を選択します
[自動スケーリング設定の名前] テキストボックス	「ComputeScaler」と入力します
[リソースグループ] ドロップダウンリスト	[MonitoredAssets] を選択します。
[スケールモード] セクション	[メトリックに基づいてスケーリングする] を選択します
[インスタンスの制限] セクションの [最小値] テキストボックス	「1」と入力します
[インスタンスの制限] セクションの [最大値] テキストボックス	「8」と入力します
[インスタンスの制限] セクションの [既定値] テキストボックス	「3」と入力します

次のスクリーンショットは、 [App Service] ブレードの [スケールアウト] セクションで構成された設定を示しています。

Azure Web API ブレード上の既定のスケール条件

設定	アクション
[ルール] セクション	[ルールの追加] を選択します
[スケールルール] ブレード	すべての設定の既定値を保持したまま、 [追加] を選択します

次のスクリーンショットは、 [App Service] ブレードの [スケールアウト] セクションの追加の設定を示しています。

Azure Web API ブレード上の既定のスケール条件の [スケールルール] ブレード

注: 保存操作が完了するまで待ってから、このラボを続行してください。

確認

この演習では、ラボの残りの部分で使用する Azure リソースを作成しました。

演習 2: Application Insights を使用してローカル Web API を監視する

タスク 1: .NET Web API プロジェクトをビルドする

ラボコンピューターから、Visual Studio Code を起動します。
Visual Studio Code の [ファイル] メニューで、 [フォルダーを開く] を選択します。
[フォルダーを開く] ウィンドウで、Allfiles (F):\Allfiles\Labs\11\Starter\Api に移動してから、 [フォルダーの選択] を選択します。
Visual Studio Code ウィンドウのメニューバーで、[ターミナル] を選択し、新しいターミナル*を選択します。
ターミナルプロンプトで、次のコマンドを実行し、現在のディレクトリに SimpleApi という名前の新しい .NET Web API アプリケーションを作成します。
```
 dotnet new webapi --output . --name SimpleApi --framework net8.0
```
次のコマンドを実行して、バージョン 2.21.0 の Microsoft.ApplicationInsights を NuGet から現在のプロジェクトにインポートします。
```
 dotnet add package Microsoft.ApplicationInsights --version 2.21.0
```
注: dotnet add package コマンドは、NuGet から Microsoft.ApplicationInsights パッケージを追加します。詳細については、「Microsoft.ApplicationInsights」を参照してください。
次のコマンドを実行して、バージョン 2.21.0 の Microsoft.ApplicationInsights.AspNetCore を NuGet から現在のプロジェクトにインポートします。
```
 dotnet add package Microsoft.ApplicationInsights.AspNetCore --version 2.21.0
```
注: dotnet add package コマンドは、NuGet から Microsoft.ApplicationInsights.AspNetCore パッケージを追加します。詳細については、「Microsoft.ApplicationInsights.AspNetCore」を参照してください。
ターミナルプロンプトで、次のコマンドを実行し、バージョン 2.21.0 の Microsoft.ApplicationInsights.PerfCounterCollector を NuGet から現在のプロジェクトにインポートします。
```
 dotnet add package Microsoft.ApplicationInsights.PerfCounterCollector --version 2.21.0
```
注: dotnet add package コマンドは、NuGet から Microsoft.ApplicationInsights.PerfCounterCollector パッケージを追加します。詳細については、「Microsoft.ApplicationInsights.PerfCounterCollector」を参照してください。
ターミナルプロンプトで、次のコマンドを実行し、バージョン 2.4.0 の Microsoft.ApplicationInsights.Profiler.AspNetCore を NuGet から現在のプロジェクトにインポートします。
```
 dotnet add package Microsoft.ApplicationInsights.Profiler.AspNetCore --version 2.4.0
```
注: dotnet add package コマンドにより、NuGet から Microsoft.ApplicationInsights.Profiler.AspNetCore パッケージが追加されます。詳細については、「Microsoft.ApplicationInsights.Profiler.AspNetCore」を参照してください。
ターミナルプロンプトで、次のコマンドを実行して、.NET Web API をビルドします。
```
 dotnet build
```

タスク 2: HTTPS を無効にし、Application Insights を使用するようにアプリコードを更新する

[Visual Studio Code] ウィンドウの [エクスプローラー] ペインで、Program.cs ファイルを選択して、 [エディター] ペインでそのファイルを開きます。
[エディター] ペインで、次のコードを 17 行目で見つけて削除します。
```
 app.UseHttpsRedirection();
```
注: このコード行は、Web API に HTTPS の使用を強制します。このラボでは、この処理は必要がありません。
Program.cs ファイルで、次の 7 行目以降の 2 行を追加し、Application Insights と共に Service コレクションに登録して Profiler を有効にします。
```
 builder.Services.AddApplicationInsightsTelemetry();
 builder.Services.AddServiceProfiler();
```
Program.cs ファイルを保存して閉じます。
[Visual Studio Code] ウィンドウの [エクスプローラー] ペインで、appsettings.json ファイルを選択して、 [エディター] ペインでそのファイルを開きます。
appsettings.json ファイルに追加し、Logging 要素の直後に次の要素を追加し、instrumentation-key プレースホルダーを、このラボで前に記録した Application Insights リソースインストルメンテーションキーの値に置き換えます。
```
    "ApplicationInsights":
    {
       "InstrumentationKey": "instrumentation-key"
    },
```
注: 追加するセクションがファイルの最後の要素である場合は、末尾のコンマを削除します。
これで、appsettings.json ファイルの構造は次のようになります。

```json { “Logging”:{ “LogLevel”: { “Default”: “Information”, “Microsoft.AspNetCore”: “Warning” } }, “ApplicationInsights”: { “InstrumentationKey”: “instrumentation-key” }, “AllowedHosts”: “*” }

Note” Ensure you have replaced the placeholder with your own instrumentation key that you recorded earlier.
Save the changes to the appsettings.json file and close it.

At the terminal prompt, run the following command to build the .NET Web API.

 dotnet publish -c Release -r win-x86 --self-contained -p:PublishReadyToRun=true .\SimpleApi.csproj

Task 3: Test an API application locally

At the terminal prompt, run the following command to launch the .NET Web API.
```
 dotnet run
```
Review the output of the command and note the HTTP URL that the site is listening on.
From the taskbar, open the context menu for the Microsoft Edge icon, and then open a new browser window.

In the browser window that opens, navigate to the http://localhost URL and add the /weatherforecast relative path of your web API.

Note: The full URL is http://localhost:[port-number]/weatherforecast, where the [port-number] placeholder identifies the port number at which the web app is accessible via the HTTP protocol.

Note: The page should contain an output in the following format. The actual values will be different.

 [
     {
         "date": "2023-10-29",
         "temperatureC": -8,
         "summary": "Sweltering",
         "temperatureF": 18
     },
     {
         "date": "2023-10-30",
         "temperatureC": -12,
         "summary": "Hot",
         "temperatureF": 11
     },
     {
         "date": "2023-10-31",
         "temperatureC": 50,
         "summary": "Chilly",
         "temperatureF": 121
     },
     {
         "date": "2023-11-01",
         "temperatureC": 51,
         "summary": "Chilly",
         "temperatureF": 123
     },
     {
         "date": "2023-11-02",
         "temperatureC": 29,
         "summary": "Balmy",
         "temperatureF": 84
     }
 ]

ブラウザーページを何回か更新して、いくつかの応答をシミュレートします。
http://localhost:[port-number]/weatherforecast によって生成されたページを表示しているブラウザーウィンドウを閉じます。
Visual Studio Code で、 [ターミナルの強制終了] (ごみ箱 アイコン) を選択して、 [ターミナル] ペインと関連するプロセスを閉じます。

region タスク 4: Application Insights でメトリックを確認する

ラボコンピューターで、Azure portal が表示されている Microsoft Edge ブラウザーウィンドウに切り替えます。
Azure portal で、このラボで前に作成した instrm [yourname] Application Insights リソースのブレードに戻ります。
[Application Insights] ブレードの中央にあるタイルで、表示されたメトリックを探します。具体的には、発生したサーバー要求の数と平均サーバー応答時間を探します。

次のスクリーンショットは、ローカル Web アプリの Application Insights メトリックを示しています。

注: Application Insights メトリックグラフで要求を観察するには、最大で 5 分かかる場合があります。

確認

この演習では、ASP.NET を使用して API アプリを作成し、それを、アプリケーションメトリックを Application Insights にストリーム配信するように構成しました。その後で、Application Insights ダッシュボードを使用して、API に関するパフォーマンスの詳細を確認しました。

演習 3: Application Insights を使用して Web API を監視する

タスク 1: Web API にアプリケーションをデプロイする

ラボコンピューターで、Visual Studio Code に切り替えます。
Visual Studio Code ウィンドウのメニューバーで、 [ターミナル] を選択し、 [新しいターミナル] を選択します。
ターミナルプロンプトで、次のコマンドを実行して、現在のディレクトリが Allfiles (F):\Allfiles\Labs\11\Starter\Api\bin\Release\net8.0\net8.0\win-x86\publish に設定されていることを確認します。ここに、デプロイファイルが格納されています。
```
 cd F:\Allfiles\Labs\11\Starter\Api\bin\Release\net8.0\win-x86\publish\
```
次のコマンドを実行して、Azure Web API の横にデプロイするスタータープロジェクトを含む zip ファイルを作成します。
```
 Compress-Archive -Path * -DestinationPath api.zip
```
ターミナルプロンプトで、次のコマンドを実行し、Azure PowerShell を使用して Azure サブスクリプションにサインインします。
```
 Connect-AzAccount
```
メッセージが表示されたら、このラボで使用している Azure サブスクリプションにアクセスするための資格情報を入力して、認証を行います。

注: サインインプロセスが完了するまで待ちます。
次のコマンドを実行して、MonitoredAssets リソースグループ内のすべての Web アプリの一覧を表示します。
```
 Get-AzWebApp -ResourceGroupName MonitoredAssets
```
次のコマンドを実行して、MonitoredAssets リソースグループ内の Web アプリの一覧 (名前が smpapi* で始まる) を表示します。
```
 Get-AzWebApp -ResourceGroupName MonitoredAssets | Where-Object {$_.Name -like 'smpapi*'}
```

次のコマンドを実行して、前の手順で特定した最初の Web アプリの名前を表示し、 $webAppName という名前の変数に格納します。

 Get-AzWebApp -ResourceGroupName MonitoredAssets | Where-Object {$_.Name -like 'smpapi*'} | Select-Object -ExpandProperty Name
 $webAppName = (Get-AzWebApp -ResourceGroupName MonitoredAssets | Where-Object {$_.Name -like 'smpapi*'})[0] | Select-Object -ExpandProperty Name

次のコマンドを実行して、このタスクで前に作成した api.zip ファイルを前の手順で特定した名前の Web API にデプロイします。
```
 Publish-AzWebApp -ResourceGroupName MonitoredAssets -Name $webAppName -ArchivePath "F:\Allfiles\Labs\11\Starter\Api\bin\Release\net8.0\win-x86\publish\api.zip" -force
```
注: デプロイが完了するまで待ってから、このラボを続行してください。
ラボコンピューターで、別の Microsoft Edge ブラウザーウィンドウ起動します。
ブラウザーウィンドウで、このタスクで前に API アプリをデプロイした Azure Web API アプリの URL (このラボで前に記録した URL) にサフィックス /weatherforecast を付加し、そのアプリに移動します。

注: たとえば、URL が https://smpapianu.azurewebsites.net の場合、新しい URL は https://smpapianu.azurewebsites.net/weatherforecast のようになります。
API アプリをローカルで実行したときに生成された出力に似ていることを確認してください。

注: 値は違いますが、形式は同じはずです。

タスク 2: Web Apps の詳細なメトリックコレクションを構成する

ラボコンピューターで、Azure portal が表示されている Microsoft Edge ブラウザーウィンドウに切り替えます。
Azure portal で、このラボで前に作成した instrm [yourname] Web アプリリソースのブレードに戻ります。
[App Service] ブレードで [Application Insights] を選択します。

[Application Insights] ブレードで、次のアクションを実行し、 [適用] を選択してから、確認ダイアログで [はい] を選択します。

設定	アクション
[Application Insights] スライダー	[有効] に設定されていることを確認します
[アプリケーションのインストルメンテーション] セクション	[.NET] タブを選択します
[コレクションレベル] セクション	[推奨] を選択します
[プロファイラー] セクション	[オン] を選択します
[スナップショットデバッガー] セクション	[オフ] を選択します
[SQL コマンド] セクション	[オフ] を選択します

次のスクリーンショットは、Azure Web API の Application Insights 設定を示しています。

Azure Web API の Application Insights 設定

前のタスクで開いたブラウザータブに切り替えて、ターゲット Azure API アプリ (ターゲット URL 内の /weatherforecast 相対パスを含む) への API アプリのデプロイ結果を表示し、ブラウザーページを数回更新します。
API によって生成された JSON 形式の出力を確認します。
JSON 形式の出力へのアクセスに使用した URL を記録します。

注: smpapianu が前に作成したサイト名の場合、URL は https://smpapianu.azurewebsites.net/weatherforecast の形式になっているはずです。

タスク 3: Application Insights で更新されたメトリックを取得する

Azure portal に Azure Web アプリが表示されるブラウザーウィンドウに戻ります。
Web アプリの [Application Insights] ブレードで、 [Application Insights データの表示] リンクを選択します。
[Application Insights] ブレードの中央にあるタイルで、収集されたメトリック (発生したサーバー要求の数や平均サーバー応答時間など) を確認します。

次のスクリーンショットは、Azure portal での Azure Web アプリの Application Insights メトリックを示しています。

注: 更新されたメトリックが Application Insights メトリックグラフに表示されるまで、最大で 5 分かかる場合があります。

タスク 4: Application Insights でリアルタイムメトリックを表示する

[Application Insights] ブレードの [調査] セクションで、 [ライブメトリック] を選択します。
ターゲット Azure Web アプリ (ターゲット URL 内の /weatherforecast 相対パスを対象とする) で実行されているターゲット API アプリが表示されているブラウザーウィンドウに戻ってから、ブラウザーページを数回更新します。
[ライブメトリック] ブレードが表示されているブラウザーウィンドウに切り替えて、その内容を確認します。

注: [受信した要求] セクションが数秒以内に更新され、Web API に対して行われた要求が表示されるはずです。

確認

この演習では、Web API アプリの Application Insights ログを構成してテストしました。また、作成されている要求に関するライブ情報を表示しました。