Ekstensi mesin virtual Dependensi Azure Monitor untuk Windows

Fitur Azure Monitor untuk Peta VM mendapatkan datanya dari agen Ketergantungan Microsoft. Ekstensi mesin virtual agen Ketergantungan Azure VM untuk Windows diterbitkan dan didukung oleh Microsoft. Ekstensi memasang agen Ketergantungan pada mesin 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 di bagian Sistem pengoperasian yang didukung dari artikel penyebaran Azure Monitor untuk VM.

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
      }
    }
  ],
    "outputs": {
    }
}

Nilai properti

Nama Nilai/Contoh
apiVersion 2015-01-01
penerbit Microsoft.Azure.Monitoring.DependencyAgent
jenis DependencyAgentWindows
typeHandlerVersion 9.10

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 penerapan 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 Mengatur nama dan jenis untuk sumber daya turunan.

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
	}
}

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
	}
}

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 otomatis untuk ekstensi, Anda harus memastikan bahwa properti enableAutomaticUpgrade diatur ke true dan ditambahkan ke templat ekstensi. Properti ini harus diaktifkan pada setiap skala mesin virtual atau penskalaan mesin virtual yang diatur secara individu. 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 mesin virtual atau penskalaan mesin virtual, ekstensi ditingkatkan secara otomatis setiap kali penerbit ekstensi merilis versi yang baru untuk ekstensi tersebut. Peningkatan diterapkan dengan aman dengan mengikuti prinsip-prinsip ketersediaan pertama seperti yang dijelaskan di sini.

Fungsionalitas atribut enableAutomaticUpgrade berbeda dari fungsi autoUpgradeMinorVersion. Atribut autoUpgradeMinorVersion tidak secara otomatis memicu pembaruan versi minor saat penerbit ekstensi merilis versi baru. Atribut autoUpgradeMinorVersion menunjukkan apakah ekstensinya harus menggunakan versi kecil yang lebih baru jika versi tersebut tersedia pada waktu penyebaran. Setelah disebarkan, bagaimanapun, ekstensi tidak akan meningkatkan versi kecil kecuali dipekerjakan kembali, bahkan jika properti ini diatur ke true.

Agar versi ekstensi Anda diperbarui, kami sarankan agar Anda menggunakan enableAutomaticUpgrade dengan penyebaran ekstensi Anda.

Penting

Jika Anda menambahkan enableAutomaticUpgrade ke templat, pastikan bahwa Anda menggunakan setidaknya API versi 2019-12-01 atau yang lebih baru.

Memecahkan 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 MSDN Azure 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.