Artikel ini menjelaskan berbagai metode yang dapat Anda gunakan untuk menginstal, menghapus instalan, memperbarui, dan mengonfigurasi Agen Azure Monitor di komputer virtual Azure, set skala komputer virtual, dan server yang diaktifkan Azure Arc.
Prasyarat
Untuk prasyarat dan persyaratan lain untuk menggunakan Agen Azure Monitor, lihat artikel berikut ini:
Penting
Anda tidak perlu menghidupkan ulang komputer saat menginstal, meningkatkan, atau menghapus instalan Agen Azure Monitor.
Opsi penginstalan
Tabel berikut ini mencantumkan opsi untuk menginstal Agen Azure Monitor di Azure VM dan server dengan dukungan Azure Arc.
Untuk komputer apa pun yang tidak ada dalam Azure, Anda harus menginstal agen Azure Arc pada komputer sebelum Anda dapat menginstal Agen Azure Monitor.
| Metode penginstalan |
Deskripsi |
| Ekstensi Virtual Machine (VM) |
Gunakan salah satu metode yang dijelaskan dalam artikel ini untuk menginstal agen melalui kerangka kerja ekstensi Azure. Metode ini tidak membuat aturan pengumpulan data (DCR), jadi Anda harus membuat setidaknya satu DCR dan mengaitkannya dengan agen sebelum pengumpulan data dimulai. |
|
Membuat DCR |
Saat Anda membuat DCR di portal Azure, Agen Azure Monitor diinstal pada komputer apa pun yang ditambahkan sebagai sumber daya untuk DCR. Agen segera mulai mengumpulkan data seperti yang didefinisikan dalam DCR. |
|
Wawasan VM |
Saat Anda mengaktifkan VM Insights pada mesin, Agen Azure Monitor diinstal dan DCR dibuat untuk mengumpulkan sekumpulan data yang telah ditentukan sebelumnya. Anda tidak boleh memodifikasi DCR ini, tetapi Anda dapat membuat lebih banyak DCR untuk mengumpulkan lebih banyak data. |
|
Wawasan Kontainer |
Saat Anda mengaktifkan pengumpulan metrik Prometheus atau log kontainer pada kluster Kubernetes, versi kontainer Agen Azure Monitor diinstal di kluster dan DCR dibuat untuk segera mulai mengumpulkan data. Anda dapat memodifikasi DCR dengan menggunakan panduan dalam Mengonfigurasi pengumpulan data dan pengoptimalan biaya dalam wawasan Kontainer dengan menggunakan DCR. |
|
Penginstal klien |
Instal agen dengan menggunakan alat penginstal Windows MSI untuk klien Windows 11 dan Windows 10. |
|
Kebijakan Azure |
Gunakan Azure Policy untuk menginstal agen secara otomatis di komputer virtual Azure dan server dengan dukungan Azure Arc, dan untuk mengaitkannya secara otomatis dengan DCR yang diperlukan. |
Catatan
Untuk mengirim data di seluruh penyewa, Anda harus terlebih dahulu mengaktifkan Azure Lighthouse.
Mengkloning komputer yang menginstal Agen Azure Monitor tidak didukung. Praktik terbaik untuk skenario ini adalah menggunakan Azure Policy atau alat infrastruktur sebagai kode (IaaC) untuk menyebarkan Agen Azure Monitor dalam skala besar.
Tabel berikut ini meringkas metode mana yang tersedia untuk setiap operasi Agen Azure Monitor:
Pasang ekstensi agen
Cara yang disarankan untuk menginstal Agen Azure Monitor melalui portal Azure adalah dengan buat aturan pengumpulan data (DCR). Agen Azure Monitor diinstal secara otomatis jika perlu, dan asosiasi dibuat antara DCR dan setiap komputer yang Anda pilih.
Untuk panduan portal langkah demi langkah, termasuk cara mengatur jenis platform, menambahkan sumber daya, dan mengonfigurasi sumber data, lihat Membuat aturan pengumpulan data (DCR).
Anda dapat menginstal Agen Azure Monitor di komputer virtual Azure atau di server yang didukung Azure Arc dengan menggunakan perintah PowerShell untuk menambahkan ekstensi komputer virtual.
Menginstal Agen Azure Monitor pada komputer virtual Azure
Gunakan perintah PowerShell berikut untuk menginstal Agen Azure Monitor di komputer virtual Azure. Pilih perintah yang sesuai berdasarkan metode autentikasi yang Anda gunakan.
Windows
## User-assigned managed identity
Set-AzVMExtension -Name AzureMonitorWindowsAgent -ExtensionType AzureMonitorWindowsAgent -Publisher Microsoft.Azure.Monitor -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name> -Location <location> -TypeHandlerVersion <version-number> -EnableAutomaticUpgrade $true -SettingString '{"authentication":{"managedIdentity":{"identifier-name":"mi_res_id","identifier-value":"/subscriptions/<my-subscription-id>/resourceGroups/<my-resource-group>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<my-user-assigned-identity>"}}}'
## System-assigned managed identity
Set-AzVMExtension -Name AzureMonitorWindowsAgent -ExtensionType AzureMonitorWindowsAgent -Publisher Microsoft.Azure.Monitor -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name> -Location <location> -TypeHandlerVersion <version-number> -EnableAutomaticUpgrade $true
Linux
## User-assigned managed identity
Set-AzVMExtension -Name AzureMonitorLinuxAgent -ExtensionType AzureMonitorLinuxAgent -Publisher Microsoft.Azure.Monitor -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name> -Location <location> -TypeHandlerVersion <version-number> -EnableAutomaticUpgrade $true -SettingString '{"authentication":{"managedIdentity":{"identifier-name":"mi_res_id","identifier-value":"/subscriptions/<my-subscription-id>/resourceGroups/<my-resource-group>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<my-user-assigned-identity>"}}}'
## System-assigned managed identity
Set-AzVMExtension -Name AzureMonitorLinuxAgent -ExtensionType AzureMonitorLinuxAgent -Publisher Microsoft.Azure.Monitor -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name> -Location <location> -TypeHandlerVersion <version-number> -EnableAutomaticUpgrade $true
Instal Azure Monitor Agent pada kumpulan skala komputer virtual Azure
Gunakan cmdlet PowerShell Add-AzVmssExtension untuk menginstal Agen Azure Monitor pada set skala komputer virtual Azure.
Windows
$vmss = Get-AzVmss -ResourceGroupName <resource-group-name> -VMScaleSetName <vmss-name>
Add-AzVmssExtension -VirtualMachineScaleSet $vmss -Name AzureMonitorWindowsAgent -Publisher Microsoft.Azure.Monitor -Type AzureMonitorWindowsAgent -TypeHandlerVersion <version-number> -EnableAutomaticUpgrade $true
Update-AzVmss -ResourceGroupName <resource-group-name> -VMScaleSetName <vmss-name> -VirtualMachineScaleSet $vmss
Linux
$vmss = Get-AzVmss -ResourceGroupName <resource-group-name> -VMScaleSetName <vmss-name>
Add-AzVmssExtension -VirtualMachineScaleSet $vmss -Name AzureMonitorLinuxAgent -Publisher Microsoft.Azure.Monitor -Type AzureMonitorLinuxAgent -TypeHandlerVersion <version-number> -EnableAutomaticUpgrade $true
Update-AzVmss -ResourceGroupName <resource-group-name> -VMScaleSetName <vmss-name> -VirtualMachineScaleSet $vmss
Catatan
Jika Anda mengatur kebijakan peningkatan set skala ke Manual, Anda perlu memperbarui instans yang ada dengan menjalankan Update-AzVmssInstance setelah memodifikasi model VMSS. Untuk kumpulan skala dengan kebijakan pemutakhiran Automatic atau Rolling, ekstensi diterapkan pada instans secara otomatis.
Menginstal Agen Azure Monitor di server yang mendukung Azure Arc
Gunakan perintah PowerShell berikut untuk menginstal Agen Azure Monitor di server dengan dukungan Azure Arc:
Windows
New-AzConnectedMachineExtension -Name AzureMonitorWindowsAgent -ExtensionType AzureMonitorWindowsAgent -Publisher Microsoft.Azure.Monitor -ResourceGroupName <resource-group-name> -MachineName <arc-server-name> -Location <arc-server-location> -EnableAutomaticUpgrade
Linux
New-AzConnectedMachineExtension -Name AzureMonitorLinuxAgent -ExtensionType AzureMonitorLinuxAgent -Publisher Microsoft.Azure.Monitor -ResourceGroupName <resource-group-name> -MachineName <arc-server-name> -Location <arc-server-location> -EnableAutomaticUpgrade
Untuk menginstal Agen Azure Monitor pada komputer virtual Azure atau di server yang mendukung Azure Arc, gunakan perintah Azure CLI untuk menambahkan ekstensi komputer virtual.
Menginstal Agen Azure Monitor pada komputer virtual Azure
Gunakan perintah Azure CLI berikut untuk menginstal Agen Azure Monitor di komputer virtual Azure. Pilih perintah yang sesuai berdasarkan metode autentikasi yang Anda gunakan.
Identitas terkelola yang ditetapkan pengguna
Windows
az vm extension set --name AzureMonitorWindowsAgent --publisher Microsoft.Azure.Monitor --ids <vm-resource-id> --enable-auto-upgrade true --settings '{"authentication":{"managedIdentity":{"identifier-name":"mi_res_id","identifier-value":"/subscriptions/<my-subscription-id>/resourceGroups/<my-resource-group>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<my-user-assigned-identity>"}}}'
Linux
az vm extension set --name AzureMonitorLinuxAgent --publisher Microsoft.Azure.Monitor --ids <vm-resource-id> --enable-auto-upgrade true --settings '{"authentication":{"managedIdentity":{"identifier-name":"mi_res_id","identifier-value":"/subscriptions/<my-subscription-id>/resourceGroups/<my-resource-group>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<my-user-assigned-identity>"}}}'
Identitas terkelola yang ditetapkan sistem
Windows
az vm extension set --name AzureMonitorWindowsAgent --publisher Microsoft.Azure.Monitor --ids <vm-resource-id> --enable-auto-upgrade true
Linux
az vm extension set --name AzureMonitorLinuxAgent --publisher Microsoft.Azure.Monitor --ids <vm-resource-id> --enable-auto-upgrade true
Instal Azure Monitor Agent pada kumpulan skala komputer virtual Azure
Gunakan cmdlet Azure CLI az vmss extension set untuk menginstal Agen Azure Monitor pada kumpulan skala komputer virtual Azure.
Windows
az vmss extension set --name AzureMonitorWindowsAgent --publisher Microsoft.Azure.Monitor --vmss-name <vmss-name> --resource-group <resource-group-name> --enable-auto-upgrade true
Linux
az vmss extension set --name AzureMonitorLinuxAgent --publisher Microsoft.Azure.Monitor --vmss-name <vmss-name> --resource-group <resource-group-name> --enable-auto-upgrade true
Untuk menggunakan identitas terkelola yang ditetapkan pengguna, tambahkan --settings parameter :
az vmss extension set --name AzureMonitorLinuxAgent --publisher Microsoft.Azure.Monitor --vmss-name <vmss-name> --resource-group <resource-group-name> --enable-auto-upgrade true --settings '{"authentication":{"managedIdentity":{"identifier-name":"mi_res_id","identifier-value":"/subscriptions/<my-subscription-id>/resourceGroups/<my-resource-group>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<my-user-assigned-identity>"}}}'
Catatan
Jika Anda menetapkan kebijakan peningkatan versi kumpulan skala ke Manual, Anda perlu memperbarui instans yang ada dengan menjalankan perintah az vmss update-instances untuk menerapkan ekstensi. Untuk kumpulan skala dengan kebijakan pemutakhiran Automatic atau Rolling, ekstensi diterapkan pada instans secara otomatis.
Menginstal Agen Azure Monitor di server yang mendukung Azure Arc
Gunakan perintah Azure CLI berikut untuk menginstal Agen Azure Monitor di server dengan dukungan Azure Arc:
Windows
az connectedmachine extension create --name AzureMonitorWindowsAgent --publisher Microsoft.Azure.Monitor --type AzureMonitorWindowsAgent --machine-name <arc-server-name> --resource-group <resource-group-name> --location <arc-server-location> --enable-auto-upgrade true
Linux
az connectedmachine extension create --name AzureMonitorLinuxAgent --publisher Microsoft.Azure.Monitor --type AzureMonitorLinuxAgent --machine-name <arc-server-name> --resource-group <resource-group-name> --location <arc-server-location> --enable-auto-upgrade true
Anda dapat menggunakan templat Azure Resource Manager untuk menginstal Agen Azure Monitor di komputer virtual Azure atau di server yang didukung Azure Arc, dan untuk membuat asosiasi dengan DCR. Anda harus membuat setiap DCR sebelum membuat asosiasi untuk DCR tersebut.
Dapatkan templat sampel untuk menginstal agen dan membuat asosiasi dari sumber daya berikut:
Instal templat dengan menggunakan metode penyebaran apa pun untuk templat Resource Manager, termasuk perintah berikut.
PowerShell
New-AzResourceGroupDeployment -ResourceGroupName "<resource-group-name>" -TemplateFile "<template-filename.json>" -TemplateParameterFile "<parameter-filename.json>"
Azure CLI (antarmuka baris perintah Azure)
az deployment group create --resource-group "<resource-group-name>" --template-file "<path-to-template>" --parameters "@<parameter-filename.json>"
Akun pengguna Linux yang dibuat selama penginstalan
Saat Anda menginstal Agen Azure Monitor di komputer Linux, agen membuat akun pengguna lokal untuk menjalankan layanan komponennya dengan aman. Setiap akun berjalan di bawah konteks pengguna khususnya sendiri untuk mengisolasi hak istimewa dan mengikuti praktik terbaik keamanan Linux untuk manajemen layanan.
Tabel berikut mencantumkan akun yang dibuat agen Azure Monitor.
| Account |
Purpose |
Saat muncul |
azuremonitoragent |
Menjalankan proses layanan Agen Azure Monitor (mdsd) untuk pengumpulan log dan metrik. |
Penginstalan ekstensi agen. |
azureotelcollector |
Menjalankan komponen OpenTelemetry Collector yang mengumpulkan data observabilitas (metrik, log, jejak) dari VM dan meneruskannya ke Azure Monitor. |
Saat agen diaktifkan dengan pengumpulan data OpenTelemetry. |
azuremetricsext |
Menjalankan Ekstensi Metrik, yang memproses metrik yang dihasilkan oleh agen dan mengirimkannya ke Metrik Azure Monitor. Ekstensi Metrik beroperasi secara independen tetapi diluncurkan dan dikelola oleh agen. |
Saat Ekstensi Metrik diterapkan. |
Penting
Jangan hapus atau ubah akun ini. Menghapusnya dapat mencegah agen berfungsi dengan benar.
Akun-akun ini dibuat sebagai pengguna sistem non-interaktif (useradd --system --no-create-home --shell /usr/sbin/nologin). Setiap akun memiliki karakteristik keamanan berikut:
-
Tidak ada login interaktif: Shell login diatur ke
/usr/sbin/nologin, yang mencegah penggunaan interaktif.
-
Kata sandi terkunci: Kata sandi dikunci secara default. Akses
sudo tidak diberikan.
-
Tidak ada direktori beranda pada disk: Jalur direktori beranda yang tercantum di
/etc/passwd (misalnya, /home/azuremetricsext) hanya metadata. Direktori sengaja tidak dibuat pada disk.
Tip
Alat pemindaian keamanan yang menandai "pengguna tidak memiliki direktori beranda" dapat dengan aman memasukkan akun-akun ini ke dalam daftar yang diizinkan. Direktori home yang tidak ada memang disengaja dan tidak menandakan adanya masalah konfigurasi.
Azure Arc akun pengguna
Pada server yang mendukung Azure Arc, Azure Connected Machine Agent dan kerangka kerja ekstensinya membuat akun pengguna lokal tambahan (himds, arcproxy, arcuser) sebagai bagian dari infrastruktur prasyarat. Akun-akun ini tidak dibuat oleh Agen Azure Monitor. Untuk informasi selengkapnya tentang akun terkait Arc dan tujuannya, lihat gambaran umum Azure Connected Machine Agent.
Verifikasi penginstalan
Setelah Anda menginstal Agen Azure Monitor, verifikasi bahwa agen menjalankan dan mengirim data ke ruang kerja Log Analytics Anda.
Periksa status ekstensi di portal Azure
- Buka komputer virtual Anda atau server dengan dukungan Azure Arc di portal Azure.
- Pilih Ekstensi + aplikasi (atau Ekstensi untuk server yang diaktifkan Arc).
- Konfirmasikan bahwa AzureMonitorWindowsAgent atau AzureMonitorLinuxAgent tercantum dengan status Provisi berhasil.
Periksa status ekstensi dengan Azure CLI
Jalankan perintah berikut untuk mencantumkan ekstensi yang terinstal dan verifikasi bahwa ekstensi Agen Azure Monitor ada dan disediakan:
az vm extension list --resource-group <resource-group-name> --vm-name <virtual-machine-name> --output table
Untuk server yang mendukung Azure Arc, gunakan:
az connectedmachine extension list --resource-group <resource-group-name> --machine-name <arc-server-name> --output table
Memverifikasi pengumpulan data dengan kueri Heartbeat
Lakukan kueri pada tabel Heartbeat di ruang kerja Log Analytics Anda untuk memastikan Azure Monitor Agent sedang mengirim data heartbeat. Di Log Analytics, jalankan:
Heartbeat
| where Category == "Azure Monitor Agent"
| where TimeGenerated > ago(5m)
| project Computer, TimeGenerated, Category, OSType
| order by TimeGenerated desc
Jika kueri mengembalikan hasil, Agen Azure Monitor berhasil diinstal dan mengirim data ke ruang kerja.
Catatan
Diperlukan waktu beberapa menit setelah penginstalan agar data heartbeat pertama muncul. Jika Anda tidak melihat hasil, verifikasi bahwa aturan pengumpulan data dikaitkan dengan komputer.
Copot pemasangan
Untuk meng-uninstall Agen Azure Monitor dengan menggunakan portal Azure, buka mesin virtual, kumpulan skala, atau server yang diaktifkan oleh Azure Arc Anda. Pilih tab Ekstensi , lalu pilih AzureMonitorWindowsAgent atau AzureMonitorLinuxAgent. Dalam dialog yang terbuka, pilih Hapus instalan.
Menghapus instalan Agen Azure Monitor pada komputer virtual Azure
Gunakan perintah PowerShell berikut untuk menghapus instalan Agen Azure Monitor di komputer virtual Azure:
Windows
Remove-AzVMExtension -Name AzureMonitorWindowsAgent -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name>
Linux
Remove-AzVMExtension -Name AzureMonitorLinuxAgent -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name>
Menghapus Azure Monitor Agent pada kumpulan skala komputer virtual Azure
Gunakan cmdlet PowerShell Remove-AzVmssExtension untuk menghapus instalan Agen Azure Monitor pada set skala komputer virtual Azure.
Windows
$vmss = Get-AzVmss -ResourceGroupName <resource-group-name> -VMScaleSetName <vmss-name>
Remove-AzVmssExtension -VirtualMachineScaleSet $vmss -Name AzureMonitorWindowsAgent
Update-AzVmss -ResourceGroupName <resource-group-name> -VMScaleSetName <vmss-name> -VirtualMachineScaleSet $vmss
Linux
$vmss = Get-AzVmss -ResourceGroupName <resource-group-name> -VMScaleSetName <vmss-name>
Remove-AzVmssExtension -VirtualMachineScaleSet $vmss -Name AzureMonitorLinuxAgent
Update-AzVmss -ResourceGroupName <resource-group-name> -VMScaleSetName <vmss-name> -VirtualMachineScaleSet $vmss
Menghapus instalan Agen Azure Monitor di server yang mendukung Azure Arc
Gunakan perintah PowerShell berikut untuk menghapus instalan Agen Azure Monitor di server berkemampuan Azure Arc:
Windows
Remove-AzConnectedMachineExtension -MachineName <arc-server-name> -ResourceGroupName <resource-group-name> -Name AzureMonitorWindowsAgent
Linux
Remove-AzConnectedMachineExtension -MachineName <arc-server-name> -ResourceGroupName <resource-group-name> -Name AzureMonitorLinuxAgent
Menghapus instalan Agen Azure Monitor pada komputer virtual Azure
Gunakan perintah Azure CLI berikut untuk menghapus instalan Agen Azure Monitor pada komputer virtual Azure:
Windows
az vm extension delete --resource-group <resource-group-name> --vm-name <virtual-machine-name> --name AzureMonitorWindowsAgent
Linux
az vm extension delete --resource-group <resource-group-name> --vm-name <virtual-machine-name> --name AzureMonitorLinuxAgent
Menghapus Azure Monitor Agent pada kumpulan skala komputer virtual Azure
Gunakan az vmss extension delete Azure CLI cmdlet untuk mencopot Azure Monitor Agent pada set skala perangkat virtual Azure.
Windows
az vmss extension delete --name AzureMonitorWindowsAgent --vmss-name <vmss-name> --resource-group <resource-group-name>
Linux
az vmss extension delete --name AzureMonitorLinuxAgent --vmss-name <vmss-name> --resource-group <resource-group-name>
Menghapus instalan Agen Azure Monitor di server yang mendukung Azure Arc
Gunakan perintah Azure CLI berikut untuk menghapus instalan Agen Azure Monitor di server dengan dukungan Azure Arc:
Windows
az connectedmachine extension delete --name AzureMonitorWindowsAgent --machine-name <arc-server-name> --resource-group <resource-group-name>
Linux
az connectedmachine extension delete --name AzureMonitorLinuxAgent --machine-name <arc-server-name> --resource-group <resource-group-name>
Pembaruan
Catatan
Selalu perbarui ke versi terbaru agen atau ikut serta dalam peningkatan ekstensi otomatis.
Peluncuran ekstensi otomatis mengikuti praktik penyebaran Azure standar untuk menyebarkan agen versi terbaru dengan aman. Pembaruan otomatis memerlukan waktu beberapa minggu untuk menghadirkan versi terbaru.
Peningkatan diluncurkan secara bertahap, sehingga komputer virtual, kumpulan skala, atau server berkemampuan Azure Arc Anda mungkin ditingkatkan sebelum yang lain.
Jika Anda perlu segera meningkatkan ekstensi, gunakan instruksi manual yang dijelaskan dalam artikel ini. Hanya agen yang dirilis dalam satu tahun terakhir yang didukung.
Untuk memperbarui agen, buka komputer virtual atau kumpulan skala Anda. Pilih tab Ekstensi , periksa agen, dan pilih Perbarui.
Aktifkan pembaruan otomatis agen dengan mengaktifkan peningkatan ekstensi otomatis. Buka komputer virtual atau set skala Anda, pilih tab Ekstensi , lalu pilih AzureMonitorWindowsAgent atau AzureMonitorLinuxAgent. Dalam dialog yang terbuka, pilih Aktifkan peningkatan otomatis.
Memperbarui Agen Azure Monitor pada komputer virtual Azure
Untuk memperbarui agen sekali, instal versi baru seperti yang dijelaskan di artikel ini.
Aktifkan pembaruan otomatis agen dengan memilih pemutakhiran ekstensi otomatis.
Gunakan perintah PowerShell berikut ini:
Windows
Set-AzVMExtension -ExtensionName AzureMonitorWindowsAgent -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name> -Publisher Microsoft.Azure.Monitor -ExtensionType AzureMonitorWindowsAgent -TypeHandlerVersion <version-number> -Location <location> -EnableAutomaticUpgrade $true
Linux
Set-AzVMExtension -ExtensionName AzureMonitorLinuxAgent -ResourceGroupName <resource-group-name> -VMName <virtual-machine-name> -Publisher Microsoft.Azure.Monitor -ExtensionType AzureMonitorLinuxAgent -TypeHandlerVersion <version-number> -Location <location> -EnableAutomaticUpgrade $true
Perbarui Agen Azure Monitor pada kumpulan skala komputer virtual Azure
Aktifkan pemutakhiran ekstensi otomatis untuk kumpulan skala. Untuk memperbarui agen secara manual, instal ulang ekstensi.
Catatan
Jika Anda mengatur kebijakan peningkatan set skala ke Manual, Anda perlu memperbarui instans yang ada dengan menjalankan Update-AzVmssInstance setelah memodifikasi model VMSS. Untuk kumpulan skala dengan kebijakan pemutakhiran Automatic atau Rolling, ekstensi diterapkan pada instans secara otomatis.
Memperbarui Agen Azure Monitor di server yang didukung Azure Arc
Untuk memutakhirkan agen satu kali, gunakan perintah PowerShell berikut:
Windows
$target = @{"Microsoft.Azure.Monitor.AzureMonitorWindowsAgent" = @{"targetVersion"=<target-version-number>}}
Update-AzConnectedExtension -ResourceGroupName $env.ResourceGroupName -MachineName <arc-server-name> -ExtensionTarget $target
Linux
$target = @{"Microsoft.Azure.Monitor.AzureMonitorLinuxAgent" = @{"targetVersion"=<target-version-number>}}
Update-AzConnectedExtension -ResourceGroupName $env.ResourceGroupName -MachineName <arc-server-name> -ExtensionTarget $target
Aktifkan pembaruan otomatis agen dengan memilih peningkatan ekstensi otomatis.
Gunakan perintah PowerShell berikut ini:
Windows
Update-AzConnectedMachineExtension -ResourceGroup <resource-group-name> -MachineName <arc-server-name> -Name AzureMonitorWindowsAgent -EnableAutomaticUpgrade
Linux
Update-AzConnectedMachineExtension -ResourceGroup <resource-group-name> -MachineName <arc-server-name> -Name AzureMonitorLinuxAgent -EnableAutomaticUpgrade
Memperbarui Agen Azure Monitor pada komputer virtual Azure
Untuk memperbarui agen satu kali, pertama-tama hapus instalan versi agen yang ada. Kemudian, instal versi baru seperti yang dijelaskan dalam artikel ini.
Aktifkan pembaruan otomatis agen dengan memilih fitur peningkatan ekstensi automatik dengan menggunakan perintah Azure CLI berikut:
Windows
az vm extension set --name AzureMonitorWindowsAgent --publisher Microsoft.Azure.Monitor --vm-name <virtual-machine-name> --resource-group <resource-group-name> --enable-auto-upgrade true
Linux
az vm extension set --name AzureMonitorLinuxAgent --publisher Microsoft.Azure.Monitor --vm-name <virtual-machine-name> --resource-group <resource-group-name> --enable-auto-upgrade true
Perbarui Agen Azure Monitor pada kumpulan skala komputer virtual Azure
Aktifkan pemutakhiran ekstensi otomatis untuk kumpulan skala. Untuk memperbarui agen secara manual, instal ulang ekstensi.
Catatan
Jika Anda menetapkan kebijakan peningkatan versi kumpulan skala ke Manual, Anda perlu memperbarui instans yang ada dengan menjalankan perintah az vmss update-instances untuk menerapkan ekstensi. Untuk kumpulan skala dengan kebijakan pemutakhiran Automatic atau Rolling, ekstensi diterapkan pada instans secara otomatis.
Memperbarui Agen Azure Monitor di server yang didukung Azure Arc
Untuk meningkatkan agen satu kali, gunakan perintah Azure CLI berikut:
Windows
az connectedmachine upgrade-extension --extension-targets "{\"Microsoft.Azure.Monitor.AzureMonitorWindowsAgent\":{\"targetVersion\":\"<target-version-number>\"}}" --machine-name <arc-server-name> --resource-group <resource-group-name>
Linux
az connectedmachine upgrade-extension --extension-targets "{\"Microsoft.Azure.Monitor.AzureMonitorLinuxAgent\":{\"targetVersion\":\"<target-version-number>\"}}" --machine-name <arc-server-name> --resource-group <resource-group-name>
Aktifkan pembaruan otomatis agen dengan memilih pemutakhiran ekstensi otomatis.
Gunakan perintah Azure CLI berikut:
Windows
az connectedmachine extension update --name AzureMonitorWindowsAgent --machine-name <arc-server-name> --resource-group <resource-group-name> --enable-auto-upgrade true
Linux
az connectedmachine extension update --name AzureMonitorLinuxAgent --machine-name <arc-server-name> --resource-group <resource-group-name> --enable-auto-upgrade true
Data collection rules (DCR) mengelola Agen Azure Monitor di komputer Anda. Gunakan DCR AgentSettings untuk mengonfigurasi parameter Agen Azure Monitor tertentu agar sesuai dengan kebutuhan pemantauan spesifik Anda.
Catatan
Pertimbangan penting saat Anda bekerja dengan AgentSettings DCR:
- Saat ini, Anda dapat mengonfigurasi DCR AgentSettings hanya dengan menggunakan templat Azure Resource Manager.
- AgentSettings harus berupa satu DCR tanpa pengaturan lain.
- Komputer virtual dan DCR AgentSettings harus berada di wilayah yang sama.
Parameter yang didukung
AgentSettings DCR saat ini mendukung pengaturan parameter berikut:
| Pengaturan |
Deskripsi |
Nilai yang valid |
MaxDiskQuotaInMB |
Untuk memberikan ketahanan, agen mengumpulkan data dalam cache lokal saat agen tidak dapat mengirim data. Agen mengirim data dalam cache setelah koneksi dipulihkan. Parameter ini adalah jumlah ruang disk yang digunakan (dalam MB) oleh file log dan cache Agen Azure Monitor. |
Linux: 4,000 ke 1,000,000 default: 10,000 Windows: 4,000 ke 1,000,000 |
UseTimeReceivedForForwardedEvents |
Mengubah kolom WEF dalam tabel Microsoft Sentinel Windows Event Forwarding (WEF) untuk digunakan TimeReceived alih-alih TimeGenerated data |
0 atau 1 |
Menyiapkan AgentSettings DCR
Siapkan lingkungan dengan menginstal Agen Azure Monitor di VM Anda.
Membuat DCR.
Contoh ini mengatur jumlah maksimum ruang disk yang digunakan oleh cache Agen Azure Monitor menjadi 5.000 MB.
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {},
"resources": [
{
"type": "Microsoft.Insights/dataCollectionRules",
"name": "dcr-contoso-01",
"apiVersion": "2023-03-11",
"properties":
{
"description": "A simple agent settings",
"agentSettings":
{
"logs": [
{
"name": "MaxDiskQuotaInMB",
"value": "5000"
}
]
}
},
"kind": "AgentSettings",
"location": "eastus"
}
]
}
Kaitkan DCR dengan komputer Anda. Gunakan file Resource Manager berikut.
File templat:
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"vmName": {
"type": "string",
"metadata": {
"description": "The name of the virtual machine."
}
},
"dataCollectionRuleId": {
"type": "string",
"metadata": {
"description": "The resource ID of the data collection rule."
}
}
},
"resources": [
{
"type": "Microsoft.Insights/dataCollectionRuleAssociations",
"apiVersion": "2021-09-01-preview",
"scope": "[format('Microsoft.Compute/virtualMachines/{0}', parameters('vmName'))]",
"name": "agentSettings",
"properties": {
"description": "Association of data collection rule. Deleting this association will break the data collection for this virtual machine.",
"dataCollectionRuleId": "[parameters('dataCollectionRuleId')]"
}
}
]
}
Catatan
Jika Anda mengaitkan DCR dengan komputer yang mendukung Azure Arc, Anda harus memodifikasi properti scope dan nama /parameters.
"ruang lingkup": "[format('Microsoft.HybridCompute/machines/{0}', parameters('name'))]"
File parameter:
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"vmName": {
"value": "my-azure-vm"
},
"dataCollectionRuleId": {
"value": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/my-resource-group/providers/microsoft.insights/datacollectionrules/my-dcr"
}
}
}
Untuk menerapkan perubahan, mulai ulang Agen Azure Monitor.
Konten terkait
Buat aturan pengumpulan data untuk mengumpulkan data dari agen dan mengirimkannya ke Azure Monitor.