PowerShell を使って Azure Network Watcher 接続モニターを作成する

[アーティクル]
06/01/2023

重要

2021 年 7 月 1 日以降、既存のワークスペースに新しいテストを追加したり、Network Performance Monitor で新しいワークスペースを有効にしたりできなくなります。接続モニター (クラシック) に新しい接続モニターを追加することもできなくなります。 2021 年 7 月 1 日より前に作成されたテストおよび接続モニターは引き続き使用することができます。現在のワークロードに対するサービスの中断を最小限に抑えるには、2024 年 2 月 29 日より前に、Network Performance Monitor からテストを移行するか、接続モニター (クラシック) から Azure Network Watcher の新しい接続モニターに移行します。

Azure Network Watcher の接続モニター機能を使用して、リソース間の通信を監視する方法について説明します。

開始する前に

接続モニターを使用して作成する接続モニターでは、オンプレミスのマシンと Azure 仮想マシン (VM) の両方をソースとして追加できます。これらの接続モニターでは、エンドポイントへの接続も監視できます。エンドポイントは、Azure または他の任意の URL や IP 上のどこにあってもかまいません。

接続モニターには、次のエンティティが含まれています。

接続モニターリソース:リージョン固有の Azure リソース。以下のすべてのエンティティが、接続モニターリソースのプロパティです。
エンドポイント: 接続チェックに含まれるソースまたはターゲット。エンドポイントの例としては、Azure VM、オンプレミスのエージェント、URL、IP などがあります。
テスト構成:テスト用のプロトコル固有の構成。選択したプロトコルに基づいて、ポート、しきい値、テストの頻度、その他のパラメーターを定義できます。
テストグループ:ソースエンドポイント、ターゲットエンドポイント、テスト構成が含まれるグループ。接続モニターには、複数のテストグループを含めることができます。
テスト:ソースエンドポイント、ターゲットエンドポイント、テスト構成の組み合わせ。テストは、監視データを入手できる最も小さいレベルです。監視データには、失敗したチェックの割合と、ラウンドトリップ時間 (RTT) が含まれます。

接続モニターを作成する手順

PowerShell を使用して接続モニターを作成するには、次のコマンドを使用します。


//Connect to your Azure account with the subscription
Connect-AzAccount
Select-AzSubscription -SubscriptionId <your-subscription>
//Select region
$nw = "NetworkWatcher_centraluseuap"
//Declare endpoints like Azure VM below. You can also give VNET,Subnet,Log Analytics workspace
$sourcevmid1 = New-AzNetworkWatcherConnectionMonitorEndpointObject -AzureVM -Name MyAzureVm -ResourceID /subscriptions/<your-subscription>/resourceGroups/<your resourceGroup>/providers/Microsoft.Compute/virtualMachines/<vm-name>
//Declare endpoints like URL, IPs
$bingEndpoint = New-AzNetworkWatcherConnectionMonitorEndpointObject -ExternalAddress -Name Bing -Address www.bing.com # Destination URL
//Create test configuration.Choose Protocol and parametersSample configs below.

$IcmpProtocolConfiguration = New-AzNetworkWatcherConnectionMonitorProtocolConfigurationObject -IcmpProtocol
$TcpProtocolConfiguration = New-AzNetworkWatcherConnectionMonitorProtocolConfigurationObject -TcpProtocol -Port 80
$httpProtocolConfiguration = New-AzNetworkWatcherConnectionMonitorProtocolConfigurationObject -HttpProtocol -Port 443 -Method GET -RequestHeader @{Allow = "GET"} -ValidStatusCodeRange 2xx, 300-308 -PreferHTTPS
$httpTestConfiguration = New-AzNetworkWatcherConnectionMonitorTestConfigurationObject -Name http-tc -TestFrequencySec 60 -ProtocolConfiguration $httpProtocolConfiguration -SuccessThresholdChecksFailedPercent 20 -SuccessThresholdRoundTripTimeMs 30
$icmpTestConfiguration = New-AzNetworkWatcherConnectionMonitorTestConfigurationObject -Name icmp-tc -TestFrequencySec 30 -ProtocolConfiguration $icmpProtocolConfiguration -SuccessThresholdChecksFailedPercent 5 -SuccessThresholdRoundTripTimeMs 500
$tcpTestConfiguration = New-AzNetworkWatcherConnectionMonitorTestConfigurationObject -Name tcp-tc -TestFrequencySec 60 -ProtocolConfiguration $TcpProtocolConfiguration -SuccessThresholdChecksFailedPercent 20 -SuccessThresholdRoundTripTimeMs 30
//Create Test Group
$testGroup1 = New-AzNetworkWatcherConnectionMonitorTestGroupObject -Name testGroup1 -TestConfiguration $httpTestConfiguration, $tcpTestConfiguration, $icmpTestConfiguration -Source $sourcevmid1 -Destination $bingEndpoint,
$testname = "cmtest9"
//Create Connection Monitor
New-AzNetworkWatcherConnectionMonitor -NetworkWatcherName $nw -ResourceGroupName NetworkWatcherRG -Name $testname -TestGroup $testGroup1

プロパティの説明

ConnectionMonitorName:接続モニターリソースの名前です。
SUB:接続モニターの作成先となるサブスクリプションのサブサブスクリプション ID。
NW:接続モニターが作成される Network Watcher のリソース ID。
[場所] :接続モニターが作成されるリージョン。
エンドポイント
- [名前] : 各エンドポイントの一意の名前。
- [リソース ID] : Azure エンドポイントの場合、リソース ID は VM の Azure Resource Manager リソース ID を示します。 Azure 以外のエンドポイントの場合、リソース ID は、Azure 以外のエージェントにリンクされている Log Analytics ワークスペースの Azure Resource Manager リソース ID を示します。
- Address:リソース ID が指定されていない場合、またはリソース ID が Log Analytics ワークスペース内にある場合にのみ適用されます。リソース ID なしで使用する場合、これには任意のパブリックエンドポイントの URL または IP を指定できます。 Log Analytics リソース ID と共に使用する場合、これは監視エージェントの FQDN を示します。
- フィルター:Azure 以外のエンドポイントの場合は、フィルターを使用して、接続モニターリソースの Log Analytics ワークスペースから監視エージェントを選択します。フィルターが設定されていない場合、Log Analytics ワークスペースに属するすべてのエージェントを監視に使用できます。
  - [種類] :エージェントアドレスとして設定します。
  - Address:オンプレミスのエージェントの FQDN として設定します。
テストグループ
- [名前] :テストグループの名前を指定します。
- Sources:前に作成したエンドポイントから選択します。 Azure ベースのソースエンドポイントには Azure Network Watcher 拡張機能がインストールされている必要があり、Azure 以外をベースとしたソースエンドポイントには Azure Log Analytics エージェントがインストールされている必要があります。ソース用のエージェントをインストールするには、「監視エージェントをインストールする」を参照してください。
- 宛先: 前に作成したエンドポイントから選択します。 Azure VM または任意のエンドポイント (パブリック IP、URL、FQDN) をターゲットとして指定すると、それらへの接続を監視できます。 1 つのテストグループに、Azure VM、Office 365 URL、Dynamics 365 URL、カスタムエンドポイントを追加できます。
- Disable:テストグループで指定されているすべてのソースとターゲットに対する監視を無効します。
テスト構成
- [名前] : テスト構成に名前を指定します。
- TestFrequencySec:指定したプロトコルとポートでソースがターゲットに ping を実行する頻度を指定します。 30 秒、1 分、5 分、15 分、30 分のいずれかを選択できます。ソースでは、選択した値に基づいて、ターゲットへの接続がテストされます。たとえば、30 秒を選択すると、ソースにより、少なくとも 30 秒に 1 回、ターゲットへの接続が確認されます。
- プロトコル:TCP、ICMP、HTTP、または HTTPS を選択します。プロトコルによっては、次のプロトコル固有の構成を選択することもできます。
  - preferHTTPS:HTTP 経由で HTTPS を使用するかどうかを指定します。
  - port:任意の宛先ポートを指定します。
  - disableTraceRoute:ソースでのトポロジとホップバイホップ RTT の検出が停止します。これは、TCP または ICMP を使用したテストグループに適用されます。
  - method:HTTP 要求メソッド (GET または POST) を選択します。これは、HTTP を使用したテスト構成に適用されます。
  - path:URL に追加するパスパラメーターを指定します。
  - validStatusCodes:該当する状態コードを選択します。応答コードが一致しない場合は、診断メッセージが表示されます。
  - requestHeaders:宛先に渡されるカスタム要求ヘッダー文字列を指定します。
- Success threshold:以下のネットワークパラメーターにしきい値を設定します。
  - checksFailedPercent:指定した条件で行われるソースによるターゲットへの接続の確認で、失敗してもかまわないチェックの割合を設定します。 TCP または ICMP プロトコルでは、失敗したチェックの割合はパケット損失の割合と同等である可能性があります。 HTTP プロトコルでは、このフィールドは、応答を受け取らなかった HTTP 要求の割合を表します。
  - roundTripTimeMs:テスト構成でソースがターゲットに接続するのにかかる時間をミリ秒で設定します。

スケールの上限

接続モニターには、次のようなスケール制限があります。

1 つのリージョンの 1 つのサブスクリプションあたりの接続モニターの最大数: 100
接続モニターあたりのテストグループの最大数: 20
接続モニターあたりのソースとターゲットの最大数: 100
接続モニターあたりのテスト構成の最大数:

次のステップ

監視データを分析してアラートを設定する方法を確認する。
ネットワークの問題を診断する方法を確認する。