Windows 用 Azure Performance Diagnostics (PerfInsights) VM 拡張機能

[アーティクル]
08/02/2024

適用対象: ✔️ Windows VM

Azure パフォーマンス診断 VM 拡張機能は、Windows VM からパフォーマンス診断データを収集するのに役立ちます。この拡張機能では、分析を実行し、仮想マシンでのパフォーマンスの問題を特定して解決するための結果と推奨事項のレポートを提供します。この拡張機能では、PerfInsights と呼ばれるトラブルシューティングツールがインストールされます。

Note

クラシックではない VM に対して Azure portal から VM の診断を実行する場合は、新しいエクスペリエンスを使用することをお勧めします。詳細については、「Azure 仮想マシンのパフォーマンス診断」を参照してください。

前提条件

この拡張機能は、次にインストールできます。

Windows Server 2019
Windows Server 2016
Windows Server 2012 R2
Windows Server 2012
Windows Server 2008 R2
Windows 10
Windows 8.1
Windows 8

拡張機能のスキーマ

次に示す JSON は、Azure パフォーマンス診断 VM 拡張機能のスキーマです。この拡張機能では、診断の出力とレポートを保存するために、ストレージアカウントの名前とキーが必要です。これらは機密性の高い値です。ストレージアカウントキーは、保護された設定構成内に格納する必要があります。 Azure VM 拡張機能の保護された設定データは暗号化され、ターゲットの仮想マシンでのみ、暗号化が解除されます。 storageAccountName と storageAccountKey は大文字と小文字が区別されることに注意してください。他の必要なパラメーターについては、以下のセクションで示します。

{
     "name": "[concat(parameters('vmName'),'/AzurePerformanceDiagnostics')]",
     "type": "Microsoft.Compute/virtualMachines/extensions",
     "location": "[parameters('location')]",
     "apiVersion": "2015-06-15",
     "properties": {
       "publisher": "Microsoft.Azure.Performance.Diagnostics",
       "type": "AzurePerformanceDiagnostics",
       "typeHandlerVersion": "1.0",
       "autoUpgradeMinorVersion": true,
       "settings": {
         "storageAccountName": "[parameters('storageAccountName')]",
         "performanceScenario": "[parameters('performanceScenario')]",
         "enableContinuousDiagnostics": "[parameters('enableContinuousDiagnostics')]",
         "traceDurationInSeconds": "[parameter('traceDurationInSeconds')]",
         "perfCounterTrace": "[parameters('perfCounterTrace')]",
         "networkTrace": "[parameters('networkTrace')]",
         "xperfTrace": "[parameters('xperfTrace')]",
         "storPortTrace": "[parameters('storPortTrace')]",         
         "requestTimeUtc":  "[parameters('requestTimeUtc')]",
         "resourceId": "[resourceId('Microsoft.Compute/virtualMachines', parameters('vmName'))]"
       },
       "protectedSettings": {
           "storageAccountKey": "[parameters('storageAccountKey')]"       
       }
     }
   }

プロパティ値

名前	値/例	説明
apiVersion	2015-06-15	API のバージョン。
publisher	Microsoft.Azure.Performance.Diagnostics	拡張機能の発行元名前空間。
type	AzurePerformanceDiagnostics	VM 拡張機能の種類。
typeHandlerVersion	1.0	拡張機能ハンドラーのバージョン。
performanceScenario	基本	データをキャプチャするパフォーマンスシナリオ。有効な値: basic、vmslow、azurefiles、custom。
enableContinuousDiagnostics	はい	継続的診断を有効にします。有効な値は、true または falseです。継続的パフォーマンス診断を有効にするには、このプロパティを指定する必要があります。
traceDurationInSeconds	300	いずれかのトレースオプションを選択した場合、トレースの期間。
perfCounterTrace	P	パフォーマンスカウンターのトレースを有効にするオプション。有効な値: p、または空の値。このトレースをキャプチャしない場合は、値を空のままにします。
networkTrace	n	ネットワークトレースを有効にするオプション。有効な値は、n または空の値です。このトレースをキャプチャしない場合は、値を空のままにします。
xperfTrace	x	XPerf のトレースを有効にするオプション。有効な値: x、または空の値。このトレースをキャプチャしない場合は、値を空のままにします。
storPortTrace	s	StorPort のトレースを有効にするオプション。有効な値は、s または空の値です。このトレースをキャプチャしない場合は、値を空のままにします。
srNumber	123452016365929	サポートチケット番号 (ある場合)。値がない場合は、値を空のままにします。
requestTimeUtc	2017-09-28T22:08:53.736Z	現在の日時 (UTC)。ポータルを使ってこの拡張機能をインストールしている場合は、この値を指定する必要はありません。
resourceId	/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}	VM の一意の識別子。
storageAccountName	mystorageaccount	診断ログと結果を格納するストレージアカウントの名前。
storageAccountKey	lDuVvxuZB28NNP…hAiRF3voADxLBTcc==	ストレージアカウントのキー。

拡張機能をインストールする

Note

VM でのパフォーマンス診断のインストールと実行に関するで説明されているように、パフォーマンス診断ブレードを使用して拡張機能をインストールすることをお勧めします。

Windows 仮想マシンにこの拡張機能をインストールするには、次の手順に従います。

Azure portal にサインインします。
この拡張機能をインストールする仮想マシンを選びます。
[拡張機能 + アプリケーション] ブレード、 [追加] の順に選択します。
[Azure パフォーマンス診断] を選択し、使用条件を確認して、 [次へ] を選択します。
インストールのパラメーター値を指定し、拡張機能をインストールします。サポートされるシナリオの詳細については、「PerfInsights を使用する方法」を参照してください。
インストールが成功すると、拡張機能の状態に「プロビジョニング成功」と表示されます。

Note

プロビジョニングが成功すると、拡張機能が実行されます。基本的なシナリオの場合、2 分以内で完了します。他のシナリオの場合は、インストール中に指定した期間だけ実行されます。

拡張機能を削除する

Note

パフォーマンス診断ブレードを使用して拡張機能をアンインストールすることをお勧めします( パフォーマンス診断のアンインストール。

仮想マシンから拡張機能を削除するには、以下の手順のようにします。

Azure portal にサインインし、この拡張機能を削除する仮想マシンを選択し、[拡張機能 + アプリケーション] ブレードを選択します。
パフォーマンス診断拡張機能を選択し、[アンインストール] を選択します。

テンプレートのデプロイ

Azure 仮想マシン拡張機能は、Azure Resource Manager テンプレートでデプロイできます。前のセクションで詳しく説明した JSON スキーマを Azure Resource Manager テンプレートで使用できます。その場合、Azure Resource Manager テンプレートのデプロイ時に Azure パフォーマンス診断 VM 拡張機能が実行されます。サンプルテンプレートを次に示します。

{
 "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
 "contentVersion": "1.0.0.0",
 "parameters": {
   "vmName": {
     "type": "string",
     "defaultValue": "yourVMName"
   },
   "location": {
     "type": "string",
     "defaultValue": "southcentralus"
   },
   "storageAccountName": {
     "type": "securestring",
     "defaultValue": "yourStorageAccount"
   },
   "storageAccountKey": {
     "type": "securestring",
     "defaultValue": "yourStorageAccountKey"
   },
   "performanceScenario": {
     "type": "string",
     "defaultValue": "basic"
   },
 
"enableContinuousDiagnostics": {
     "type": "boolean",
     "defaultValue": "false"
  },
  "traceDurationInSeconds": {
   "type": "int",
   "defaultValue": 300
 },
   "perfCounterTrace": {
     "type": "string",
     "defaultValue": "p"
   },
   "networkTrace": {
     "type": "string",
     "defaultValue": ""
   },
   "xperfTrace": {
     "type": "string",
     "defaultValue": ""
   },
   "storPortTrace": {
     "type": "string",
     "defaultValue": ""
   },
   "requestTimeUtc": {
     "type": "string",
     "defaultValue": "10/2/2017 11:06:00 PM"
   }       
 },
 "resources": [
   {
     "name": "[concat(parameters('vmName'),'/AzurePerformanceDiagnostics')]",
     "type": "Microsoft.Compute/virtualMachines/extensions",
     "location": "[parameters('location')]",
     "apiVersion": "2015-06-15",
     "properties": {
       "publisher": "Microsoft.Azure.Performance.Diagnostics",
       "type": "AzurePerformanceDiagnostics",
       "typeHandlerVersion": "1.0",
       "autoUpgradeMinorVersion": true,
       "settings": {
         "storageAccountName": "[parameters('storageAccountName')]",
         "performanceScenario": "[parameters('performanceScenario')]",
"enableContinuousDiagnostics" : "[parameters('enableContinuousDiagnostics')]",
         "traceDurationInSeconds": "[parameters('traceDurationInSeconds')]",
         "perfCounterTrace": "[parameters('perfCounterTrace')]",
         "networkTrace": "[parameters('networkTrace')]",
         "xperfTrace": "[parameters('xperfTrace')]",
         "storPortTrace": "[parameters('storPortTrace')]",         
         "requestTimeUtc":  "[parameters('requestTimeUtc')]",
         "resourceId": "[resourceId('Microsoft.Compute/virtualMachines', parameters('vmName'))]"
       },
       "protectedSettings": {
           "storageAccountKey": "[parameters('storageAccountKey')]"
       }
     }
   }
 ]
}

PowerShell でのデプロイ

Set-AzVMExtension コマンドを使用して、Azure Performance Diagnostics VM 拡張機能を既存の仮想マシンにデプロイします。

$PublicSettings = @{ "storageAccountName"="mystorageaccount";"performanceScenario"="basic"; "enableContinuousDiagnostics" : $False;"traceDurationInSeconds"=300;"perfCounterTrace"="p";"networkTrace"="";"xperfTrace"="";"storPortTrace"="";"srNumber"="";"requestTimeUtc"="2017-09-28T22:08:53.736Z";"resourceId"="VMResourceId" }
$ProtectedSettings = @{"storageAccountKey"="mystoragekey" }
 
Set-AzVMExtension -ExtensionName "AzurePerformanceDiagnostics" -ResourceGroupName "myResourceGroup" -VMName "myVM" -Publisher "Microsoft.Azure.Performance.Diagnostics" -ExtensionType "AzurePerformanceDiagnostics" -TypeHandlerVersion 1.0 -Settings $PublicSettings -ProtectedSettings $ProtectedSettings -Location WestUS

キャプチャされるデータについて

PerfInsights ツールは、選んだシナリオに応じて、さまざまなログ、構成、診断データを収集します。詳細については、PerfInsights のドキュメントをご覧ください。

拡張機能の出力は、インストール時に指定したストレージアカウントにアップロードした zip ファイルに含まれます。このファイルは Shared Access Signatures (SAS) を使用して 30 日間共有されます。この zip ファイルには、診断ログと、結果と推奨事項に関するレポートが含まれています。出力 zip ファイルへの SAS リンクは、 zipfilename_saslink.txtフォルダー C:\Packages\Plugins\Microsoft.Azure.Performance.Diagnostics.AzurePerformanceDiagnostics\<version> の下にあります。このリンクがあれば、誰でも zip ファイルをダウンロードできます。

サポートチケットの作業を行うサポートエンジニアを支援するために、Microsoft がこの SAS リンクを使って診断データをダウンロードする場合があります。

レポートを確認するには、zip ファイルを展開し、PerfInsights Report.html ファイルを開きます。

拡張機能を選んで、ポータルから zip ファイルを直接ダウンロードすることもできます。

Performance Diagnostics の詳細ステータスと拡張機能のダウンロードリンクのスクリーンショット。

Note

ポータルに表示されている SAS リンクが機能しない場合があります。原因として、エンコードおよびデコード操作中に URL が不正な形式になったことが考えられます。代わりに、VM の *_saslink.txt ファイルから直接リンクを取得できます。

トラブルシューティングとサポート

拡張機能が正常にプロビジョニングされていても、拡張機能のデプロイステータス (通知領域) に「デプロイは進行中です」と表示される場合があります。

拡張機能の状態で拡張機能が正常にプロビジョニングされたことが示されている限り、この問題は無視しても安全です。
インストール中の問題の一部は、拡張ログを使って対処できます。拡張機能の実行の出力は、次のディレクトリ内のファイルにログ記録されます。

C:\WindowsAzure\Logs\Plugins\Microsoft.Azure.Performance.Diagnostics.AzurePerformanceDiagnostics\<version>
Azure portal またはパフォーマンス診断拡張機能ログ (AzPerfDiagExtension.log または PerfInsights.log) に次のエラーが表示される場合、これは通常、HTTPS 証明書チェーンが壊れていることを意味します。
- プロビジョニングに失敗しました - メッセージ: PerfInsights の結果を Azure ストレージアカウントにアップロードできませんでした。
- PerfInsights プロセスがコード 1700 で終了しました。
- SSL/TLS のセキュリティで保護されているチャネルに対する信頼関係を確立できませんでした。検証プロシージャによると、リモート証明書が無効である
エラーを解決するには、ネットワークセキュリティグループ (NSG) が、この一覧で説明されている証明機関 URL へのアクセスをブロックしていないことを確認。または、ネットワーク仮想アプライアンスまたはファイアウォールに SSL 検査ツールがないことを確認します。

お問い合わせはこちらから

質問がある場合やヘルプが必要な場合は、サポート要求を作成するか、Azure コミュニティサポートにお問い合わせください。 Azure フィードバックコミュニティに製品フィードバックを送信することもできます。

次の方法で共有

Windows 用 Azure Performance Diagnostics (PerfInsights) VM 拡張機能

前提条件

拡張機能のスキーマ

プロパティ値

拡張機能をインストールする

拡張機能を削除する

テンプレートのデプロイ

PowerShell でのデプロイ

キャプチャされるデータについて

トラブルシューティングとサポート

お問い合わせはこちらから

フィードバック

その他のリソース

次の方法で共有

Windows 用 Azure Performance Diagnostics (PerfInsights) VM 拡張機能

前提条件

拡張機能のスキーマ

プロパティ値

拡張機能をインストールする

拡張機能を削除する

テンプレートのデプロイ

PowerShell でのデプロイ

キャプチャされるデータについて

結果を表示および共有する

トラブルシューティングとサポート

お問い合わせはこちらから

フィードバック

その他のリソース