Ekstensi mesin virtual Dependensi Azure Monitor untuk Windows

Artikel
03/05/2024

Fitur Azure Monitor untuk VM Map mendapatkan datanya dari agen Dependensi Microsoft. Ekstensi komputer virtual agen Dependensi Azure VM untuk Windows menginstal agen Dependensi pada komputer virtual Azure. Dokumen ini merinci platform, konfigurasi, dan opsi penyebaran yang didukung untuk ekstensi mesin virtual agen Dependensi Azure VM untuk Windows.

Sistem operasi

Ekstensi agen Dependensi Azure VM untuk Windows dapat dijalankan terhadap sistem operasi yang didukung yang tercantum dalam tabel berikut. Semua sistem operasi dalam tabel berikut diasumsikan sebagai x64. x86 tidak didukung untuk sistem operasi apa pun.

Sistem operasi	Agen Dependensi Azure VM
Windows Server 2022	✓
Windows Server 2022 Core	✓
Server Windows 2019	✓
Windows Server 2019 Core	✓
Server Windows 2016	✓
Windows Server 2016 Core	✓
Windows Server 2012 R2	✓
Windows Server 2012	✓
Klien Windows 11 dan Pro	^✓1, ²
Windows 11 Enterprise (termasuk multi-sesi)	✓
Windows 10 1803 (RS4) dan yang lebih tinggi	^✓1
Windows 10 Enterprise (termasuk multi-sesi) dan Pro (Hanya skenario server)	✓
Windows 8 Enterprise dan Pro (Hanya skenario server)
Windows 7 SP1 (Hanya skenario server)
Azure Stack HCI
Windows IoT Enterprise	✓

¹ Menggunakan alat penginstal klien agen Azure Monitor.
² Juga didukung pada komputer berbasis Arm64.

Skema ekstensi

JSON berikut menunjukkan skema untuk ekstensi agen Dependensi Azure VM pada Azure Windows VM.

{
  "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "vmName": {
      "type": "string",
      "metadata": {
        "description": "The name of existing Azure VM. Supported Windows Server versions:  2008 R2 and above (x64)."
      }
    }
  },
  "variables": {
    "vmExtensionsApiVersion": "2017-03-30"
  },
  "resources": [
    {
      "type": "Microsoft.Compute/virtualMachines/extensions",
      "name": "[concat(parameters('vmName'),'/DAExtension')]",
      "apiVersion": "[variables('vmExtensionsApiVersion')]",
      "location": "[resourceGroup().location]",
      "dependsOn": [],
      "properties": {
          "publisher": "Microsoft.Azure.Monitoring.DependencyAgent",
          "type": "DependencyAgentWindows",
          "typeHandlerVersion": "9.10",
          "autoUpgradeMinorVersion": true,
          "settings": {
                "enableAMA": "true"
		    }
      }
    }
  ],
    "outputs": {
    }
}

Nilai properti

Nama	Nilai/Contoh
apiVersion	2015-01-01
penerbit	Microsoft.Azure.Monitoring.DependencyAgent
jenis	DependencyAgentWindows
typeHandlerVersion	9.10
autoUpgradeMinorVersion	benar
pengaturan	"enableAMA": "true"

Penting

Pastikan untuk menambahkan enableAMA ke templat jika Anda menggunakan Agen Azure Monitor; jika tidak, agen Dependensi mencoba mengirim data ke agen Analitik Log warisan.

Penyebaran templat

Anda dapat menerapkan ekstensi Azure VM dengan templat Azure Resource Manager. Anda dapat menggunakan skema JSON yang dirinci di bagian sebelumnya di templat Azure Resource Manager untuk menjalankan ekstensi agen Dependensi Azure VM selama penyebaran templat Azure Resource Manager.

JSON untuk ekstensi komputer virtual dapat disarangkan di dalam sumber daya komputer virtual. Atau, Anda dapat menempatkannya di akar atau tingkat atas templat JSON Resource Manager. Penempatan JSON memengaruhi nilai nama dan jenis sumber daya. Untuk informasi selengkapnya, lihat Set nama dan jenis untuk sumber daya elemen anak.

Contoh berikut mengasumsikan ekstensi agen Dependensi bersarang di dalam sumber daya komputer virtual. Saat Anda menyarangkan sumber daya ekstensi, JSON ditempatkan di objek "resources": [] dari komputer virtual.

{
	"type": "extensions",
	"name": "DAExtension",
	"apiVersion": "[variables('apiVersion')]",
	"location": "[resourceGroup().location]",
	"dependsOn": [
		"[concat('Microsoft.Compute/virtualMachines/', variables('vmName'))]"
	],
	"properties": {
      "publisher": "Microsoft.Azure.Monitoring.DependencyAgent",
      "type": "DependencyAgentWindows",
      "typeHandlerVersion": "9.10",
      "autoUpgradeMinorVersion": true,
      "settings": {
            "enableAMA": "true"
    		    }
    }
}

Saat Anda menempatkan ekstensi JSON di akar templat, nama sumber daya menyertakan referensi ke komputer virtual induk. Jenis mencerminkan konfigurasi bersarang.

{
	"type": "Microsoft.Compute/virtualMachines/extensions",
	"name": "<parentVmResource>/DAExtension",
	"apiVersion": "[variables('apiVersion')]",
	"location": "[resourceGroup().location]",
	"dependsOn": [
		"[concat('Microsoft.Compute/virtualMachines/', variables('vmName'))]"
	],
	"properties": {
      "publisher": "Microsoft.Azure.Monitoring.DependencyAgent",
      "type": "DependencyAgentWindows",
      "typeHandlerVersion": "9.10",
      "autoUpgradeMinorVersion": true,
      "settings": {
            "enableAMA": "true"
    		    }
	}
}

Penyebaran PowerShell

Anda dapat menggunakan perintah Set-AzVMExtension untuk menerapkan ekstensi mesin virtual agen Dependensi ke mesin virtual yang ada. Sebelum Anda menjalankan perintah, konfigurasi publik dan pribadi harus disimpan dalam tabel hash PowerShell.


Set-AzVMExtension -ExtensionName "Microsoft.Azure.Monitoring.DependencyAgent" `
    -ResourceGroupName "myResourceGroup" `
    -VMName "myVM" `
    -Publisher "Microsoft.Azure.Monitoring.DependencyAgent" `
    -ExtensionType "DependencyAgentWindows" `
    -TypeHandlerVersion 9.10 `
    -Location WestUS

Peningkatan ekstensi otomatis

Sebuah fitur baru untuk secara otomatis meningkatkan versi minor dari ekstensi Dependensi sekarang tersedia dalam pratinjau publik.

Untuk mengaktifkan peningkatan ekstensi secara otomatis untuk ekstensi, Anda harus memastikan properti enableAutomaticUpgrade diatur ke true dan ditambahkan ke template ekstensi. Properti ini harus diaktifkan pada setiap VM atau skala VM yang ditetapkan secara individual. Gunakan salah satu metode yang dijelaskan di bagian pengaktifan untuk mengaktifkan fitur untuk set skala mesin virtual atau penskalaan mesin virtual Anda.

Saat peningkatan ekstensi otomatis diaktifkan pada suatu komputer virtual atau set skala VM, ekstensi akan diperbarui secara otomatis setiap kali penerbit ekstensi merilis versi baru untuk ekstensi tersebut. Peningkatan diterapkan dengan aman mengikuti prinsip-prinsip ketersediaan seperti yang dijelaskan di sini.

Fungsi atribut enableAutomaticUpgrade berbeda dari autoUpgradeMinorVersion. Atribut autoUpgradeMinorVersion tidak secara otomatis memicu pembaruan versi minor saat penerbit ekstensi merilis versi baru. Atribut autoUpgradeMinorVersion menunjukkan apakah ekstensi harus menggunakan versi minor yang lebih baru jika tersedia pada waktu penyebaran. Namun, setelah disebarkan, ekstensi tidak akan meningkatkan versi minor kecuali disebarkan ulang, bahkan dengan properti ini diatur ke true.

Agar versi ekstensi Anda diperbarui, kami sarankan untuk menggunakan enableAutomaticUpgrade dengan penerapan ekstensi Anda.

Penting

Jika Anda menambahkan enableAutomaticUpgrade ke template, pastikan Anda menggunakan setidaknya API versi 2019-12-01 atau lebih tinggi.

Pemecahan masalah dan dukungan

Pecahkan masalah

Data tentang status penyebaran ekstensi dapat diambil dari portal Microsoft Azure dan dengan menggunakan modul Azure PowerShell. Untuk melihat status penyebaran ekstensi untuk VM tertentu, jalankan perintah berikut ini dengan menggunakan modul Azure PowerShell:

Get-AzVMExtension -ResourceGroupName myResourceGroup -VMName myVM -Name myExtensionName

Output eksekusi ekstensi dicatat ke file yang ditemukan di direktori berikut:

C:\WindowsAzure\Logs\Plugins\Microsoft.Azure.Monitoring.DependencyAgent\

Dukungan

Jika Anda memerlukan bantuan lebih lanjut kapan saja dalam artikel ini, Anda dapat menghubungi pakar Azure di forum Microsoft Q & A dan Stack Overflow. Alternatif lain, Anda dapat mengajukan insiden dukungan Azure. Buka situs dukungan Azure dan pilih Dapatkan dukungan. Untuk informasi tentang cara menggunakan Dukungan Azure, baca FAQ dukungan Microsoft Azure.