Network Watcher エージェントの仮想マシン拡張機能は、Azure 仮想マシン (VM) を診断および監視するためのネットワーク トラフィックをキャプチャする一部の Azure Network Watcher 機能の要件です。 詳細については、「Azure Network Watcher とは」を参照してください。
この記事では、WindowsおよびLinux向けのNetwork Watcher Agentのインストールとアンインストール方法を学びます。 エージェントのインストールによって、仮想マシンが中断されることも、再起動が必要になることもありません。 仮想マシンがAzureサービスによってデプロイされている場合は、サービスのドキュメントを確認し、そのサービスが仮想マシンに拡張機能のインストールを許可しているかどうかを確認してください。
Note
Network Watcher Agent拡張機能はAKSクラスターではサポートされていません。
前提条件
サポートされているオペレーティングシステムを実行するAzure仮想マシン(VM)。 詳細については、「 サポートされているオペレーティングシステム」をご覧ください。
169.254.169.254 を経由して port 80 へ、および 168.63.129.16 を経由して port 8037 への送信 TCP 接続です。 エージェントは、これらの IP アドレスを使用して Azure プラットフォームと通信します。
インターネット接続: 一部の機能が正常に機能するためには、Network Watcher エージェントにインターネット接続が必要です。 たとえば、パケット キャプチャをアップロードするには、ストレージ アカウントへの接続が必要です。
サポートされているオペレーティングシステムを実行するAzure仮想マシン(VM)。 詳細については、「 サポートされているオペレーティングシステム」をご覧ください。
169.254.169.254 を経由して port 80 へ、および 168.63.129.16 を経由して port 8037 への送信 TCP 接続です。 エージェントは、これらの IP アドレスを使用して Azure プラットフォームと通信します。
インターネット接続: 一部の機能が正常に機能するためには、Network Watcher エージェントにインターネット接続が必要です。 たとえば、パケット キャプチャをアップロードするには、ストレージ アカウントへの接続が必要です。
Azure Cloud Shell または Azure PowerShell。
この記事の手順では、Azure Cloud Shell で Azure PowerShell コマンドレットを対話型で実行します。 Cloud Shell でコマンドを実行するには、コード ブロックの右上隅にある [Cloud Shell を開く ] を選択します。
[コピー] を選択してコードをコピーし、続いて Cloud Shell に貼り付けて実行します。 Azure ポータル内からCloud Shellを実行することもできます。
Azure PowerShell をローカルにインストールしてコマンドレットを実行することもできます。 PowerShell をローカルで実行している場合は、Connect-AzAccount コマンドレットを使用して Azure にサインインします。
サポートされているオペレーティングシステムを実行するAzure仮想マシン(VM)。 詳細については、「 サポートされているオペレーティングシステム」をご覧ください。
169.254.169.254 を経由して port 80 へ、および 168.63.129.16 を経由して port 8037 への送信 TCP 接続です。 エージェントは、これらの IP アドレスを使用して Azure プラットフォームと通信します。
インターネット接続: 一部の機能が正常に機能するためには、Network Watcher エージェントにインターネット接続が必要です。 たとえば、パケット キャプチャをアップロードするには、ストレージ アカウントへの接続が必要です。
Azure Cloud Shell または Azure CLI。
この記事の手順では、Azure Cloud Shell で Azure CLI コマンドを対話型で実行します。 Cloud Shell でコマンドを実行するには、コード ブロックの右上隅にある [Cloud Shell を開く ] を選択します。
Copy を選択してコードをコピーし、Cloud Shellに貼り付けて実行します。 Azure ポータル内からCloud Shellを実行することもできます。
また、Azure CLI をローカルにインストールしてコマンドを実行することもできます。 Azure CLI をローカルで実行する場合は、 az login コマンドを使用して Azure にサインインします。
サポートされているオペレーティングシステムを実行するAzure仮想マシン(VM)。 詳細については、「 サポートされているオペレーティングシステム」をご覧ください。
169.254.169.254 を経由して port 80 へ、および 168.63.129.16 を経由して port 8037 への送信 TCP 接続です。 エージェントは、これらの IP アドレスを使用して Azure プラットフォームと通信します。
インターネット接続: 一部の機能が正常に機能するためには、Network Watcher エージェントにインターネット接続が必要です。 たとえば、パケット キャプチャをアップロードするには、ストレージ アカウントへの接続が必要です。
テンプレートをデプロイするためにローカルにインストールされた Azure PowerShell または Azure CLI です。
サポートされるオペレーティング システム
Windows 用の Network Watcher エージェント拡張機能は、次のものにインストールできます。
- Windows Server 2012、2012 R2、2016、2019、2022、2025 のリリース。
- Windows 10 および 11 リリース。
Note
現在、Nano Server はサポートされていません。
以下のLinuxディストリビューションでNetwork Watcher Agent for Linuxをインストールできます:
| Distribution |
バージョン |
| アルマリナックス |
9.2 |
| Azure Linux |
2.0 |
| CentOS 1 |
6.10、7 |
| Debian |
7、8 |
| openSUSE Leap |
42.3 以降 |
| Oracle Linux |
6.10 2、7、8、9+ |
| レッドハットエンタープライズLinux(RHEL) |
6.10 3、7、8、9.2 |
| ロッキー・リナックス |
9.1 |
| SUSE Linux Enterprise Server(SLES) |
12、15 (SP2、SP3、SP4) |
| Ubuntu |
16 以降 |
1 CentOS Linuxは2024年6月30日にサービス終了(EOL)を迎えました。 詳細については、「CentOS のサポート終了に関するガイダンス」を参照してください。
2 Oracle Linux バージョン 6.X の拡張ライフサイクル (ELS) サポートは、2024 年 7 月 1 日に終了しました。
3 Red Hat Enterprise Linux 6.X の拡張ライフサイクル (ELS) サポートは、2024 年 6 月 30 日に終了しました。
Note
インターネット制御メッセージプロトコル(ICMP)監視は、Oracle LinuxのNetwork Watcher Agentでは、ディストリビューション特有のカーネルレベルの制限があるため現在サポートされていません。
拡張機能のスキーマ
次の JSON は、Network Watcher Agent 拡張機能のスキーマを示しています。 この拡張機能はユーザーが指定した設定を必要とせず、サポートもしていません。既定の構成が使用されます。
{
"name": "[concat(parameters('vmName'), '/AzureNetworkWatcherExtension')]",
"type": "Microsoft.Compute/virtualMachines/extensions",
"apiVersion": "2023-03-01",
"location": "[resourceGroup().location]",
"dependsOn": [
"[concat('Microsoft.Compute/virtualMachines/', parameters('vmName'))]"
],
"properties": {
"autoUpgradeMinorVersion": true,
"publisher": "Microsoft.Azure.NetworkWatcher",
"type": "NetworkWatcherAgentWindows",
"typeHandlerVersion": "1.4"
}
}
{
"name": "[concat(parameters('vmName'), '/AzureNetworkWatcherExtension')]",
"type": "Microsoft.Compute/virtualMachines/extensions",
"apiVersion": "2023-03-01",
"location": "[resourceGroup().location]",
"dependsOn": [
"[concat('Microsoft.Compute/virtualMachines/', parameters('vmName'))]"
],
"properties": {
"autoUpgradeMinorVersion": true,
"publisher": "Microsoft.Azure.NetworkWatcher",
"type": "NetworkWatcherAgentLinux",
"typeHandlerVersion": "1.4"
}
}
インストールされている拡張機能を一覧表示する
Azureポータルの仮想マシンページから、以下の手順に従ってインストール済み拡張機能を確認できます:
[設定] で [拡張機能とアプリケーション] を選択します。
[拡張機能] タブには、仮想マシンにインストールされているすべての拡張機能が表示されます。 リストが長い場合は、検索ボックスを使用してリストをフィルター処理できます。
Get-AzVMExtension コマンドレットを使用して、仮想マシンにインストールされているすべての拡張機能を一覧表示します:
# List the installed extensions on the virtual machine.
Get-AzVMExtension -ResourceGroupName 'myResourceGroup' -VMName 'myVM' | format-table Name, Publisher, ExtensionType, AutoUpgradeMinorVersion, EnableAutomaticUpgrade
コマンドレットの出力には、インストールされている拡張機能が一覧表示されます:
Name Publisher ExtensionType AutoUpgradeMinorVersion EnableAutomaticUpgrade
---- --------- ------------- ----------------------- ----------------------
AzureNetworkWatcherExtension Microsoft.Azure.NetworkWatcher NetworkWatcherAgentWindows True True
Name Publisher ExtensionType AutoUpgradeMinorVersion EnableAutomaticUpgrade
---- --------- ------------- ----------------------- ----------------------
AzureNetworkWatcherExtension Microsoft.Azure.NetworkWatcher NetworkWatcherAgentLinux True True
az vm extension list コマンドを使用して、仮想マシンにインストールされているすべての拡張機能を一覧表示します:
# List the installed extensions on the virtual machine.
az vm extension list --resource-group 'myResourceGroup' --vm-name 'myVM' --out table
このコマンドの出力には、インストールされている拡張機能が一覧表示されます:
Name ProvisioningState Publisher Version AutoUpgradeMinorVersion
---------------------------- ------------------- ------------------------------ --------- -------------------------
AzureNetworkWatcherExtension Succeeded Microsoft.Azure.NetworkWatcher 1.4 True
Network Watcher Agent VM 拡張機能のインストール
Azure portal の仮想マシンに関するページから、次の手順に従って Network Watcher Agent VM 拡張機能をインストールできます:
[設定] で [拡張機能とアプリケーション] を選択します。
[+ 追加] を選択し、Network Watcher エージェントを検索してインストールします。 拡張機能が既にインストールされている場合は、拡張機能の一覧に表示されます。
「拡張機能をインストールする」の検索ボックスで「Network Watcher Agent」と入力し、リストからあなたのOSに対応する拡張機能を選択し、「次へ」を選択します。
[確認および作成] を選択し、次に [作成] を選択します。
Set-AzVMExtension コマンドレットを使用して、Network Watcher Agent VM 拡張機能を仮想マシンにインストールします:
# Install Network Watcher Agent for Windows on the virtual machine.
Set-AzVMExtension -Name 'AzureNetworkWatcherExtension' -Publisher 'Microsoft.Azure.NetworkWatcher' -ExtensionType 'NetworkWatcherAgentWindows' -EnableAutomaticUpgrade 1 -TypeHandlerVersion '1.4' -ResourceGroupName 'myResourceGroup' -VMName 'myVM'
# Install Network Watcher Agent for Linux on the virtual machine.
Set-AzVMExtension -Name 'AzureNetworkWatcherExtension' -Publisher 'Microsoft.Azure.NetworkWatcher' -ExtensionType 'NetworkWatcherAgentLinux' -EnableAutomaticUpgrade 1 -TypeHandlerVersion '1.4' -ResourceGroupName 'myResourceGroup' -VMName 'myVM'
インストールが正常に完了すると、次の出力が表示されます:
RequestId IsSuccessStatusCode StatusCode ReasonPhrase
--------- ------------------- ---------- ------------
True OK
az vm extension set コマンド 使用して、Network Watcher Agent VM 拡張機能を仮想マシンにインストールします:
# Install Network Watcher Agent for Windows on the virtual machine.
az vm extension set --name 'NetworkWatcherAgentWindows' --extension-instance-name 'AzureNetworkWatcherExtension' --publisher 'Microsoft.Azure.NetworkWatcher' --enable-auto-upgrade 'true' --version '1.4' --resource-group 'myResourceGroup' --vm-name 'myVM'
# Install Network Watcher Agent for Linux on the virtual machine.
az vm extension set --name 'NetworkWatcherAgentLinux' --extension-instance-name 'AzureNetworkWatcherExtension' --publisher 'Microsoft.Azure.NetworkWatcher' --enable-auto-upgrade 'true' --version '1.4' --resource-group 'myResourceGroup' --vm-name 'myVM'
以下のAzure Resource Managerテンプレート(ARMテンプレート)を使って、仮想マシンにNetwork Watcher Agent VM拡張機能をインストールしてください:
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"vmName": {
"type": "string"
}
},
"variables": {},
"resources": [
{
"name": "[parameters('vmName')]",
"type": "Microsoft.Compute/virtualMachines",
"apiVersion": "2023-03-01",
"location": "[resourceGroup().location]",
"properties": {
}
},
{
"name": "[concat(parameters('vmName'), '/AzureNetworkWatcherExtension')]",
"type": "Microsoft.Compute/virtualMachines/extensions",
"apiVersion": "2023-03-01",
"location": "[resourceGroup().location]",
"dependsOn": [
"[concat('Microsoft.Compute/virtualMachines/', parameters('vmName'))]"
],
"properties": {
"autoUpgradeMinorVersion": true,
"publisher": "Microsoft.Azure.NetworkWatcher",
"type": "NetworkWatcherAgentWindows",
"typeHandlerVersion": "1.4"
}
}
],
"outputs": {}
}
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"vmName": {
"type": "string"
}
},
"variables": {},
"resources": [
{
"name": "[parameters('vmName')]",
"type": "Microsoft.Compute/virtualMachines",
"apiVersion": "2023-03-01",
"location": "[resourceGroup().location]",
"properties": {
}
},
{
"name": "[concat(parameters('vmName'), '/AzureNetworkWatcherExtension')]",
"type": "Microsoft.Compute/virtualMachines/extensions",
"apiVersion": "2023-03-01",
"location": "[resourceGroup().location]",
"dependsOn": [
"[concat('Microsoft.Compute/virtualMachines/', parameters('vmName'))]"
],
"properties": {
"autoUpgradeMinorVersion": true,
"publisher": "Microsoft.Azure.NetworkWatcher",
"type": "NetworkWatcherAgentLinux",
"typeHandlerVersion": "1.4"
}
}
],
"outputs": {}
}
Azure PowerShell または Azure CLI を使用して、Resource Manager テンプレートをデプロイできます:
# Deploy the JSON template file using Azure PowerShell.
New-AzResourceGroupDeployment -ResourceGroupName 'myResourceGroup' -TemplateFile 'agent.json'
# Deploy the JSON template file using the Azure CLI.
az deployment group create --resource-group 'myResourceGroup' --template-file 'agent.json'
Network Watcher Agent VM 拡張機能のアンインストール
Azure portal の仮想マシンに関するページから、次の手順に従って Network Watcher Agent VM 拡張機能をアンインストールできます:
[設定] で [拡張機能とアプリケーション] を選択します。
拡張機能一覧から AzureNetworkWatcherExtension を選択し、[アンインストール] を選択します。
Note
AzureNetworkWatcherExtension とは異なる名前の Network Watcher Agent VM 拡張機能が表示される場合があります。
Remove-AzVMExtension コマンドレットを使用して、Network Watcher Agent VM 拡張機能を仮想マシンから削除します:
# Uninstall Network Watcher Agent VM extension.
Remove-AzVMExtension -Name 'AzureNetworkWatcherExtension' -ResourceGroupName 'myResourceGroup' -VMName 'myVM'
az vm extension delete コマンドを使用して、Network Watcher Agent VM 拡張機能を仮想マシンから削除します:
# Uninstall Network Watcher Agent VM extension.
az vm extension delete --name 'AzureNetworkWatcherExtension' --resource-group 'myResourceGroup' --vm-name 'myVM'
よく寄せられる質問 (FAQ)
Network Watcher エージェントに関してよく寄せられる質問に対する回答については、「Network Watcher エージェントに関する FAQ」を参照してください。
関連するコンテンツ