Ekstensi mesin virtual Dependensi Azure Monitor untuk Linux

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

Note

Coba bantuan VM untuk diagnostik yang lebih cepat. Kami menyarankan agar Anda menjalankan VM assist untuk Windows atau VM assist untuk Linux. Alat diagnostik berbasis skrip ini membantu Anda mengidentifikasi masalah umum yang memengaruhi Agen Tamu Azure VM dan kesehatan VM secara keseluruhan.

Jika Anda mengalami masalah performa dengan komputer virtual, sebelum menghubungi dukungan, jalankan alat-alat ini.

Prerequisites

Sistem operasi

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

Note

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, data koneksi dan port yang disimpan dalam tabel VMConnection dan VMBoundport tidak dikumpulkan. Tabel VMProcess mungkin memiliki beberapa data, tetapi akan minimal.

Distribution 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 difokuskan untuk 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 disesuaikan oleh 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

Note

Agen dependensi tidak didukung untuk mesin virtual Azure dengan prosesor berbasis Ampere Altra ARM.

Skema ekstensi

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

{
    "$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

Name Value/Example
apiVersion 2015-01-01
penerbit Microsoft.Azure.Monitoring.DependencyAgent
jenis DependencyAgentLinux
typeHandlerVersion 9.5
pengaturan "enableAMA": "true"

Important

Pastikan untuk menambahkan enableAMA ke templat jika Anda menggunakan Azure Monitor Agent; jika tidak, Dependency agent mencoba mengirim data ke Log Analytics agent versi legacy.

Template deployment

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 tingkat akar atau 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 anak.

Contoh berikut mengasumsikan ekstensi agen Dependensi disarangkan di dalam sumber daya komputer virtual. Saat Anda menyisipkan sumber daya ekstensi, JSON ditempatkan di "resources": [] objek mesin 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 ini mencerminkan konfigurasi berlapis.

{
	"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 menyebarkan ekstensi VM agen Dependensi ke komputer virtual yang ada.

az vm extension set \
    --resource-group myResourceGroup \
    --vm-name myVM \
    --name DependencyAgentLinux \
    --publisher Microsoft.Azure.Monitoring.DependencyAgent \
    --version 9.10 \
    --settings '{"enableAMA": "true"}'

Peningkatan ekstensi otomatis

Fitur baru untuk meningkatkan ekstensi Dependensi versi minor secara otomatis sekarang tersedia.

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

Ketika peningkatan ekstensi otomatis diaktifkan pada VM atau kumpulan skala VM, ekstensi ditingkatkan secara otomatis setiap kali penerbit ekstensi merilis versi baru untuk ekstensi tersebut. Peningkatan diterapkan dengan aman mengikuti prinsip-prinsip ketersediaan-pertama seperti yang dijelaskan di sini.

Fungsionalitas enableAutomaticUpgrade atribut 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, meskipun properti ini diatur ke 'true'.

Agar versi ekstensi Anda tetap diperbarui, sebaiknya gunakan enableAutomaticUpgrade dengan penyebaran ekstensi Anda.

Important

Jika Anda menambahkan enableAutomaticUpgrade ke templat Anda, pastikan Anda menggunakan pada API versi 2019-12-01 atau yang lebih tinggi.

Pemecahan masalah dan dukungan

Troubleshoot

Data tentang status penyebaran ekstensi dapat diambil dari portal Microsoft Azure dan dengan menggunakan Azure CLI. Untuk melihat status penyebaran ekstensi untuk VM tertentu, jalankan perintah berikut 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

Support

Jika Anda memerlukan bantuan lebih lanjut kapan saja dalam artikel ini, hubungi pakar Azure di forum Microsoft Q & A 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 Tanya Jawab Umum dukungan Microsoft Azure.

  • Last updated on