パケットキャプチャを使用する Azure Functions とアラートでネットワークをプロアクティブに監視する

[アーティクル]
03/10/2024

Azure Network Watcher のパケットキャプチャ機能は、仮想マシン (VM) との間のトラフィックを追跡するためのキャプチャセッションを作成します。キャプチャファイルには、監視するトラフィックのみを追跡するために定義したフィルターを設定できます。このデータは、ストレージ BLOB に格納されるか、ローカルのゲストマシンに格納されます。

この機能は、Azure Functions などの他の自動化シナリオからリモートで開始できます。定義済みのネットワーク異常に基づいてプロアクティブキャプチャを実行できます。その他の用途には、ネットワーク統計の収集、ネットワークへの侵入に関する情報を取得、クライアントサーバー間の通信のデバッグがあります。

Azure でデプロイされたリソースは、継続的に実行されます。すべてのリソースの状態を四六時中監視することは困難です。たとえば、午前 2 時に問題が発生した場合はどうなるでしょうか?

Azure エコシステム内部から Network Watcher のアラートと関数を使うことにより、データとツールでプロアクティブに対応してネットワークの問題を解決できます。

前提条件

最新バージョンの Azure PowerShell。
Network Watcher の既存インスタンス。まだない場合は、Network Watcher のインスタンスを作成します。
Windows 拡張機能または Linux 仮想マシン拡張機能を備えた、Network Watcher と同じリージョン内の既存の仮想マシン。

シナリオ

この例は、仮想マシン (VM) の送信トラフィックが通常よりも多く、アラートを受け取る必要がある場合です。同様のプロセスを使用して、任意の条件のアラートを作成できます。

インシデントによってアラートがトリガーされると、パケットレベルのデータは、送信トラフィックが増加した理由を分析するのに役立ちます。仮想マシンを元の状態に戻すための手順を実行できます。

このシナリオでは、Network Watcher の既存のインスタンスと、有効な仮想マシンが含まれるリソースグループがあることを前提としています。

パケットキャプチャのワークフローを次に示します。

インシデントによってお使いの VM でアラートがトリガーされます。
アラートが Azure 関数を呼び出す。
Azure 関数がアラートを処理し、Network Watcher のパケットキャプチャセッションを開始する。
パケットキャプチャが VM で実行され、データが収集される。
パケットキャプチャファイルが確認と診断のためにストレージアカウントにアップロードされる。

このプロセスを自動化するには、インシデントが発生したときにトリガーされるアラートをお使いの VM で作成して接続します。また、Network Watcher を呼び出す関数も作成します。

このシナリオは次のとおりです。

パケットキャプチャを開始する Azure 関数を作成する。
仮想マシンでアラートルールを作成し、Azure 関数を呼び出すようにアラートルールを構成する。

Azure 関数の作成

アラートを処理してパケットキャプチャを作成する Azure 関数を作成するには、まず関数アプリを作成する必要があります。

Azure portal にサインインします。
ポータルの上部にある検索ボックスに、「関数アプリ」と入力します。検索結果から [関数アプリ] を選択します。
[+ 作成] を選択します。
[関数アプリの作成] の [基本] タブで、次の設定の値を入力または選択します。
- [プロジェクトの詳細] で、関数アプリを作成するサブスクリプションと、そのアプリを含むリソースグループを選択します。
- [インスタンスの詳細] で:
  - [関数アプリ名] に、関数アプリの名前を入力します。この名前には .azurewebsites.net が追加されます。
  - [コードまたはコンテナーイメージをデプロイしますか?] では、発行モード ([コード] または [コンテナーイメージ]) を選択します。
  - ランタイムスタックの場合は、ランタイムスタックを選択します。
  - [バージョン] では、ランタイムスタックのバージョンを選択します。
  - [リージョン] では、関数アプリを作成するリージョンを選択します。
- [オペレーティングシステム] で、現在使用しているオペレーティングシステムの種類を選択します。 Azure により、ランタイムスタックの選択に基づいて、オペレーティングシステムの種類が提案されます。
- [ホスティング] で、関数アプリに使用するプランの種類を選択します。次のオプションから選択します。
  - 従量課金 (サーバーレス): 最小コストでイベント駆動型のスケーリングを行う場合。
  - Functions Premium: イベントベースのスケーリングとネットワークの分離を備えた、エンタープライズレベルのサーバーレスアプリケーションの場合。
  - App Service プラン: 既存の Azure App Service プランからコンピューティングを再利用する場合。
[確認および作成] を選択してアプリを作成します。

これで、関数を作成できます。

作成した関数アプリで [関数]、[作成] の順に選び、[関数の作成] ペインを開きます。
[開発環境] で、[Develop in portal](ポータルで開発) を選択します。
[テンプレートの選択] で、[HTTP トリガー] を選択します。
[テンプレートの詳細] セクションで、次の操作を行います。
- [新しい関数] には、関数の名前を入力します。
- [認証レベル] では [関数] を選びます。
［作成］ を選択します
作成した関数に移動し、[コード + テスト ] を選択します。
スクリプトを更新し、[保存] を選択します。

認証を構成する

PowerShell コマンドレットを使用するには、関数アプリで認証を構成する必要があります。認証を構成するには、環境変数を構成して、暗号化されたキーファイルを Function App にアップロードする必要があります。

注意

このシナリオでは、Azure Functions を使った認証の実装方法を一例として取り上げます。同じアクションを実行する方法は他にもあります。

次の PowerShell スクリプトは、PassEncryptKey.key という名前のキーファイルを作成します。これにより、指定されているパスワードの暗号化バージョンも提供されます。このパスワードは、認証に使用される Microsoft Entra アプリケーションに定義されているパスワードと同じです。

#Variables
$keypath = "C:\temp\PassEncryptKey.key"
$AESKey = New-Object Byte[] 32
$Password = "<insert a password here>"

#Keys
[Security.Cryptography.RNGCryptoServiceProvider]::Create().GetBytes($AESKey) 
Set-Content $keypath $AESKey

#Get encrypted password
$secPw = ConvertTo-SecureString -AsPlainText $Password -Force
$AESKey = Get-content $KeyPath
$Encryptedpassword = $secPw | ConvertFrom-SecureString -Key $AESKey
$Encryptedpassword

環境変数の値を取得する

次の環境変数を設定します。これらは認証の値にアクセスするのに必要です。

AzureClientID
AzureTenant
AzureCredPassword

既にアプリケーション ID がある場合は、そのアプリケーションの AzureClientID、AzureTenant、AzureCredPassword の値を使用します。これがない場合は、「環境変数を格納する」セクションに進みます。

AzureClientID

クライアント ID は、Microsoft Entra ID のアプリケーションの ID です。クライアント ID を取得するには:

使うアプリケーションがまだない場合は、次のコマンドレットを実行してアプリケーションを作成します。

$app = New-AzADApplication -DisplayName "ExampleAutomationAccount_MF" -HomePage "https://exampleapp.com" -IdentifierUris "https://exampleapp1.com/ExampleFunctionsAccount" -Password "<same password as defined earlier>"
New-AzADServicePrincipal -ApplicationId $app.ApplicationId
Start-Sleep 15]
New-AzRoleAssignment -RoleDefinitionName Contributor -ServicePrincipalName $app.ApplicationId

Note

アプリケーション作成時に使うパスワードは、前にキーファイルを保存したときに作成したものと同じパスワードにする必要があります。

Azure Portal で、 [サブスクリプション] を選びます。使うサブスクリプションを選び、[アクセス制御 (IAM)] を選びます。
使うアカウントを選び、[プロパティ] を選びます。アプリケーション ID をコピーします。

AzureTenant

次の PowerShell コマンドレットを実行して、テナント ID を取得します。

(Get-AzSubscription -SubscriptionName "<subscriptionName>").TenantId

AzureCredPassword

AzureCredPassword 環境変数の値は、次の PowerShell サンプルを実行して得られる値です。このサンプルは、前の「認証の構成」セクションに示したものと同じです。必要な値は $Encryptedpassword 変数の出力です。この出力は、PowerShell スクリプトを使って暗号化したサービスプリンシパルパスワードです。

#Variables
$keypath = "C:\temp\PassEncryptKey.key"
$AESKey = New-Object Byte[] 32
$Password = "<insert a password here>"

#Keys
[Security.Cryptography.RNGCryptoServiceProvider]::Create().GetBytes($AESKey) 
Set-Content $keypath $AESKey

#Get encrypted password
$secPw = ConvertTo-SecureString -AsPlainText $Password -Force
$AESKey = Get-content $KeyPath
$Encryptedpassword = $secPw | ConvertFrom-SecureString -Key $AESKey
$Encryptedpassword

環境変数を格納する

環境変数を格納するには:

Function App に移動します。 [構成]>[アプリケーション設定] の順に選択します。
環境変数とその値をアプリの設定に追加し、[保存] を選びます。

関数への PowerShell の追加

ここで、Azure 関数の内部から Network Watcher を呼び出します。この関数の実装は、要件によって異なる場合があります。ただし、コードの一般的なフローは次のようになります。

入力パラメーターを処理します。
既存のパケットキャプチャの有無を照会し、制限を確認して、名前の競合を解決します。
適切なパラメーターを設定してパケットキャプチャを作成します。
完了するまでパケットキャプチャを定期的にポーリングします。
パケットキャプチャセッションの完了をユーザーに通知します。

次の例は、この関数で使用できる PowerShell コードです。 subscriptionId、resourceGroupName、storageAccountName の値を置き換える必要があります。

# Input bindings are passed in via parameter block 
param($Request, $TriggerMetadata) 

$essentials = $Request.body.data.essentials
$alertContext = $Request.body.data.alertContext 


# Storage account ID to save captures in 
$storageaccountid = "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{storageAccountName}" 

# Packet capture variables 
$packetCaptureName = "PSAzureFunction" 
$packetCaptureLimit = 100
$packetCaptureDuration = 30 

# Credentials 
# Set the credentials in the configurations
$tenant = $env:AzureTenant 
$pw = $env:AzureCredPassword 
$clientid = $env:AzureClientId 
$password = ConvertTo-SecureString $pw -AsPlainText -Force
$credential = New-Object System.Management.Automation.PSCredential ($clientid, $password)

Connect-AzAccount -ServicePrincipal -Tenant $tenant -Credential $credential #-WarningAction SilentlyContinue | out-null

if ($alertContext.condition.allOf.metricNamespace -eq "Microsoft.Compute/virtualMachines") { 

    # Get the VM firing this alert 
    $vm = Get-AzVM -ResourceId $essentials.alertTargetIDs[0] 

    # Get the Network Watcher instance in the VM's region 
    $networkWatcher = Get-AzNetworkWatcher -Location $vm.Location  

    # Get existing packet captures 
    $packetCaptures = Get-AzNetworkWatcherPacketCapture -NetworkWatcher $networkWatcher 

    # Remove an existing packet capture created by the function (if it exists) 
    $packetCaptures | ForEach-Object { if ($_.Name -eq $packetCaptureName) 
        {  
            Remove-AzNetworkWatcherPacketCapture -NetworkWatcher $networkWatcher -PacketCaptureName $packetCaptureName 
        } 
    } 
  
    # Initiate packet capture on the VM that fired the alert 
    if ($packetCaptures.Count -lt $packetCaptureLimit) { 
        Write-Output "Initiating Packet Capture" 
        New-AzNetworkWatcherPacketCapture -NetworkWatcher $networkWatcher -TargetVirtualMachineId $vm.Id -PacketCaptureName $packetCaptureName -StorageAccountId $storageaccountid -TimeLimitInSeconds $packetCaptureDuration 
    } 
}

古いスキーマを使用している場合は、次の PowerShell コードを使用します。

# Input bindings are passed in via parameter block 
param($Request, $TriggerMetadata)
$details = $Request.RawBody | ConvertFrom-Json


# Process alert request body 
$requestBody = $Request.Body.data

# Storage account ID to save captures in 
$storageaccountid = "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{storageAccountName}" 

# Packet capture variables 
$packetCaptureName = "PSAzureFunction" 
$packetCaptureLimit = 100
$packetCaptureDuration = 30 

# Credentials 
# Set the credentials in the configurations
$tenant = $env:AzureTenant 
$pw = $env:AzureCredPassword 
$clientid = $env:AzureClientId 

$password = ConvertTo-SecureString $pw -AsPlainText -Force
$credential = New-Object System.Management.Automation.PSCredential ($clientid, $password)

Connect-AzAccount -ServicePrincipal -Tenant $tenant -Credential $credential #-WarningAction SilentlyContinue | out-null

if ($requestBody.context.resourceType -eq "Microsoft.Compute/virtualMachines") { 

    # Get the VM firing this alert 
    $vm = Get-AzVM -ResourceGroupName $requestBody.context.resourceGroupName -Name $requestBody.context.resourceName 

    # Get the Network Watcher instance in the VM's region 
    $networkWatcher = Get-AzNetworkWatcher -Location $vm.Location  

    # Get existing packet captures 
    packetCaptures = Get-AzNetworkWatcherPacketCapture -NetworkWatcher $networkWatcher 

    # Remove an existing packet capture created by the function (if it exists) 
    $packetCaptures | ForEach-Object { if ($_.Name -eq $packetCaptureName) 
        {  
            Remove-AzNetworkWatcherPacketCapture -NetworkWatcher $networkWatcher -PacketCaptureName $packetCaptureName 
        } 
    } 

    # Initiate packet capture on the VM that fired the alert 
    if ($packetCaptures.Count -lt $packetCaptureLimit) { 
        Write-Output "Initiating Packet Capture" 
        New-AzNetworkWatcherPacketCapture -NetworkWatcher $networkWatcher -TargetVirtualMachineId $requestBody.context.resourceId -PacketCaptureName $packetCaptureName -StorageAccountId $storageaccountid -TimeLimitInSeconds $packetCaptureDuration 
    } 
}

VM のアラートの構成

特定のメトリックが割り当てたしきい値を超えたときに個人に通知するようにアラートを構成できます。この例では、アラートは送信された Network Out Total メトリック上にありますが、他の多くのメトリックに対してアラートをトリガーできます。

アラートルールの作成

既存の仮想マシンに移動して、アラートルールを追加します。 [アラートルールの作成] ページで、次の手順を実行します。

[シグナルの選択] ペインで、シグナルの名前を検索して選択します。この例では、Network Out Total は選択されたシグナルです。これは、すべてのネットワークインターフェイスで仮想マシンが送信したバイト数を意味します。
[条件] タブで、次の値を設定し、[次へ: アクション] を選択します。

設定 Value

しきい値 スタティック

集計の種類 Average

[オペレーター] より大きい

しきい値 3

確認する間隔 1 分

ルックバック期間 5 分
[アクション] タブで、[アクショングループの作成] を選択します。
[アクショングループの作成] ページで、[サブスクリプション]、[リソースグループ]、[リージョン] の値を選択します。また、アクショングループ名と表示名を入力し、[次へ: 通知] を選択します。
[通知] タブの [アクションの種類] で、[Azure 関数] を選択します。
[Azure 関数] ペインで、[サブスクリプション]、[リソースグループ]、[関数アプリ]、[Azure 関数] の値を選択します。
[共通アラートスキーマの有効化] スライダーで、[いいえ] を選択します。 [OK] をクリックします。

設定	Value
しきい値	スタティック
集計の種類	Average
[オペレーター]	より大きい
しきい値	3
確認する間隔	1 分
ルックバック期間	5 分

結果の確認

条件によってアラートがトリガーされると、Network Watcher によってパケットキャプチャが作成されます。 Network Watcher に移動し、[パケットキャプチャ] を選びます。このページでは、パッケージキャプチャをダウンロードするファイルリンクを選択することができます。

キャプチャファイルはローカルに格納されていれば、仮想マシンにサインインして取得できます。

Azure ストレージアカウントからファイルをダウンロードする手順については、.NET 用 Azure Blob Storage クライアントライブラリのクイックスタートを参照してください。 Azure Storage Explorer ツールを使用することもできます。

キャプチャをダウンロードしたら、.cap ファイルを読み取ることができる Wireshark などのツールを使用して表示できます。

次のステップ

パケットキャプチャを表示する方法については、「Network Watcher パケットキャプチャファイルの検査と分析」を参照してください。

次の方法で共有

パケットキャプチャを使用する Azure Functions とアラートでネットワークをプロアクティブに監視する

前提条件

シナリオ

Azure 関数の作成

認証を構成する

環境変数の値を取得する

AzureClientID

AzureTenant

AzureCredPassword

環境変数を格納する

関数への PowerShell の追加

VM のアラートの構成

アラートルールの作成

結果の確認

次のステップ

フィードバック

その他のリソース

次の方法で共有

パケット キャプチャを使用する Azure Functions とアラートでネットワークをプロアクティブに監視する

前提条件

シナリオ

Azure 関数の作成

認証を構成する

環境変数の値を取得する

AzureClientID

AzureTenant

AzureCredPassword

環境変数を格納する

関数への PowerShell の追加

VM のアラートの構成

アラート ルールの作成

結果の確認

次のステップ

フィードバック

その他のリソース

パケットキャプチャを使用する Azure Functions とアラートでネットワークをプロアクティブに監視する

アラートルールの作成