Ekstensi komputer virtual Dependensi Azure Monitor untuk Linux

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

Prasyarat

Sistem operasi

Ekstensi agen Dependensi Azure VM untuk Linux dapat dijalankan terhadap sistem operasi yang didukung yang tercantum di bagian Sistem operasi yang didukung dari artikel penyebaran Azure Monitor untuk VM.

Skema ekstensi

JSON berikut menunjukkan skema untuk ekstensi agen Dependensi Azure VM pada Azure Linux 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 Linux Azure VM."
      }
    }
  },
  "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": "DependencyAgentLinux",
        "typeHandlerVersion": "9.5",
        "autoUpgradeMinorVersion": true
      }
    }
  ],
    "outputs": {
    }
}

Nilai properti

Nama Nilai/Contoh
apiVersion 2015-01-01
penerbit Microsoft.Azure.Monitoring.DependencyAgent
jenis DependencyAgentLinux
typeHandlerVersion 9,5

Penyebaran templat

Anda dapat menyebarkan 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 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": "DependencyAgentLinux",
        "typeHandlerVersion": "9.5",
        "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": "DependencyAgentLinux",
        "typeHandlerVersion": "9.5",
        "autoUpgradeMinorVersion": true
	}
}

Penyebaran Azure CLI

Anda dapat menggunakan Azure CLI untuk menerapkan ekstensi VM agen Dependensi ke mesin virtual yang ada.


az vm extension set \
    --resource-group myResourceGroup \
    --vm-name myVM \
    --name DependencyAgentLinux \
    --publisher Microsoft.Azure.Monitoring.DependencyAgent \
    --version 9.5

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 kecil 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 Azure dan dengan menggunakan Azure CLI. Untuk melihat status penyebaran ekstensi untuk VM tertentu, jalankan perintah berikut ini dengan menggunakan Azure CLI:

az vm extension list --resource-group myResourceGroup --vm-name myVM -o table

Output eksekusi ekstensi dicatat ke file berikut:

/var/opt/microsoft/dependency-agent/log/install.log

Dukungan

Jika Anda memerlukan bantuan lebih lanjut kapan saja dalam artikel ini, hubungi pakar Azure di Forum MSDN Azure dan Stack Overflow. Atau, 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.