Ekstensi komputer virtual Dependensi Azure Monitor untuk Linux

Artikel
03/05/2024

Fitur Azure Monitor untuk VM Map mendapatkan datanya dari agen Dependensi Microsoft. Ekstensi komputer virtual agen Dependensi Azure VM untuk Linux 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

Karena agen Dependensi Azure VM berfungsi di tingkat kernel, dukungan sistem operasi juga bergantung pada versi kernel. Sesuai Agen dependensi versi 9.10.* agen mendukung * kernel. Tabel berikut mencantumkan rilis OS Linux utama dan minor serta versi kernel yang didukung untuk agen Dependensi.

Catatan

Dengan agen Dependensi 9.10.15 ke atas, penginstalan tidak diblokir untuk versi kernel yang tidak didukung, tetapi agen akan berjalan dalam mode terdegradasi. Dalam mode ini, koneksi dan data port yang disimpan dalam tabel VM Koneksi ion dan VMBoundport tidak dikumpulkan. Tabel VMProcess mungkin memiliki beberapa data, tetapi akan minimal.

Distribusi	Versi OS	Versi kernel
Red Hat Linux 8	8.6	4.18.0-372.el8.x86_64, 4.18.0-372.el8_6.x86_64
	8.5	4.18.0-348.el8_5.x86_644.18.0-348.el8.x86_64
	8.4	4.18.0-305.el8.x86_64, 4.18.0-305.el8_4.x86_64
	8.3	4.18.0-240.*el8_3.x86_64
	8.2	4.18.0-193.*el8_2.x86_64
	8.1	4.18.0-147.*el8_1.x86_64
	8.0	4.18.0-80.el8.x86_64 4.18.0-80.el8_0.x86_64
Red Hat Linux 7	7.9	3.10.0-1160
	7.8	3.10.0-1136
	7.7	3.10.0-1062
	7.6	3.10.0-957
	7.5	3.10.0-862
	7.4	3.10.0-693
Red Hat Linux 6	6.10	2.6.32-754
	6.9	2.6.32-696
CentOS Linux 8	8.6	4.18.0-372.el8.x86_64, 4.18.0-372.el8_6.x86_64
	8.5	4.18.0-348.el8_5.x86_644.18.0-348.el8.x86_64
	8.4	4.18.0-305.el8.x86_64, 4.18.0-305.el8_4.x86_64
	8.3	4.18.0-240.*el8_3.x86_64
	8.2	4.18.0-193.*el8_2.x86_64
	8.1	4.18.0-147.*el8_1.x86_64
	8.0	4.18.0-80.el8.x86_64 4.18.0-80.el8_0.x86_64
CentOS Linux 7	7.9	3.10.0-1160
	7.8	3.10.0-1136
	7.7	3.10.0-1062
CentOS Linux 6	6.10	2.6.32-754.3.5 2.6.32-696.30.1
	6.9	2.6.32-696.30.1 2.6.32-696.18.7
Ubuntu Server	20.04	5.8 5.4*
	18.04	5.3.0-1020 5.0 (termasuk kernel yang disetel Azure) 4.18* 4.15*
	16.04.3	4.15.*
	16.04	4.13.* 4.11.* 4.10.* 4.8.* 4.4.*
	14.04	3.13.-generic 4.4.-generic
SUSE Linux 12 Enterprise Server	12 SP5	4.12.14-122.-default, 4.12.14-16.-azure
	12 SP4	4.12.* (termasuk kernel yang disetel Azure)
	12 SP3	4.4.*
	12 SP2	4.4.*
SUSE Linux 15 Enterprise Server	15 SP1	4.12.14-197.-default, 4.12.14-8.-azure
	15	4.12.14-150.*-default
Debian	9	4.9

Catatan

Agen dependensi tidak didukung untuk Azure Virtual Machines dengan prosesor berbasis ARM Ampere Altra.

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

Nilai properti

Nama	Nilai/Contoh
apiVersion	2015-01-01
penerbit	Microsoft.Azure.Monitoring.DependencyAgent
jenis	DependencyAgentLinux
typeHandlerVersion	9,5
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 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 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": "DependencyAgentLinux",
        "typeHandlerVersion": "9.5",
        "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": "DependencyAgentLinux",
        "typeHandlerVersion": "9.5",
        "autoUpgradeMinorVersion": true,
        "settings": {
            "enableAMA": "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 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 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 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.

Share via