Artikel ini merinci berbagai metode untuk menginstal, menghapus instalan, memperbarui, dan mengonfigurasi Agen Azure Monitor di komputer virtual Azure, set skala, dan server dengan dukungan Azure Arc.
Penting
Agen Azure Monitor memerlukan setidaknya satu aturan pengumpulan data (DCR) untuk mulai mengumpulkan data setelah diinstal pada komputer klien. Bergantung pada metode penginstalan yang Anda gunakan, DCR mungkin atau mungkin tidak dibuat secara otomatis. Jika tidak, maka Anda perlu mengonfigurasi pengumpulan data mengikuti panduan di Mengumpulkan data dengan Agen Azure Monitor.
Prasyarat
Lihat artikel berikut untuk prasyarat dan persyaratan lainnya untuk Agen Azure Monitor:
Menginstal, memutakhirkan, atau menghapus instalan Agen Azure Monitor tidak akan memerlukan mulai ulang komputer.
Opsi penginstalan
Tabel berikut ini mencantumkan berbagai opsi untuk menginstal Azure Monitor Agent di Azure VM dan server dengan dukungan Azure Arc. Agen Azure Arc harus diinstal pada komputer apa pun yang tidak ada di Azure sebelum Agen Azure Monitor dapat diinstal.
Metode penginstalan
Deskripsi
Ekstensi Mesin Virtual
Gunakan salah satu metode di bawah ini untuk menggunakan kerangka kerja ekstensi Azure untuk menginstal agen. Metode ini tidak membuat DCR, jadi Anda harus membuat setidaknya satu dan mengaitkannya dengan agen sebelum pengumpulan data akan dimulai.
Saat Anda membuat DCR di portal Azure, Agen Azure Monitor diinstal pada komputer apa pun yang ditambahkan sebagai sumber daya untuk DCR. Agen akan segera mulai mengumpulkan data yang ditentukan dalam DCR.
Saat Anda mengaktifkan wawasan VM pada komputer, Azure Monitor Agent diinstal, dan DCR dibuat yang mengumpulkan sekumpulan data yang telah ditentukan sebelumnya. Anda tidak boleh mengubah DCR ini, tetapi Anda dapat membuat DCR tambahan untuk mengumpulkan data lain.
Gunakan Azure Policy untuk menginstal agen secara otomatis di komputer virtual Azure dan server yang diaktifkan Azure Arc dan secara otomatis mengaitkannya dengan DCR yang diperlukan.
Catatan
Untuk mengirim data di seluruh penyewa, Anda harus terlebih dahulu mengaktifkan Azure Lighthouse.
Mengkloning komputer dengan Agen Azure Monitor yang diinstal tidak didukung. Praktik terbaik untuk situasi ini adalah menggunakan Azure Policy atau Infrastruktur sebagai alat kode untuk menyebarkan AMA dalam skala besar.
Menginstal ekstensi agen
Bagian ini menyediakan detail tentang menginstal Agen Azure Monitor menggunakan ekstensi VM.
Gunakan panduan di Mengumpulkan data dengan Agen Azure Monitor untuk menginstal agen menggunakan portal Azure dan membuat DCR untuk mengumpulkan data.
Anda dapat menginstal Agen Azure Monitor di komputer virtual Azure dan di server yang diaktifkan Azure Arc dengan menggunakan perintah PowerShell untuk menambahkan ekstensi komputer virtual.
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 pilih.
Anda dapat menginstal Azure Monitor Agent di komputer virtual Azure dan di server dengan dukungan Azure Arc dengan menggunakan perintah Azure CLI untuk menambahkan ekstensi komputer virtual.
Komputer virtual Azure
Gunakan perintah CLI berikut untuk menginstal Agen Azure Monitor di komputer virtual Azure. Pilih perintah yang sesuai berdasarkan metode autentikasi yang Anda pilih.
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
Set skala komputer virtual Azure
Gunakan cmdlet CLI set ekstensi az vmss untuk menginstal Azure Monitor Agent pada set skala komputer virtual Azure.
Server dengan Azure Arc yang diaktifkan
Gunakan perintah CLI berikut untuk menginstal Agen Azure Monitor di server dengan dukungan Azure Arc.
Anda dapat menggunakan templat Resource Manager untuk menginstal Azure Monitor Agent di komputer virtual Azure dan di server dengan dukungan Azure Arc dan untuk membuat asosiasi dengan aturan pengumpulan data. Anda harus membuat aturan pengumpulan data apa pun sebelum membuat pengaitan.
Dapatkan sampel templat untuk menginstal agen dan membuat pengaitan dari hal berikut ini:
Untuk menghapus instalan Agen Azure Monitor dengan menggunakan portal Azure, buka komputer virtual, set skala, atau server dengan dukungan Azure Arc Anda. Pilih tab Ekstensi dan pilih AzureMonitorWindowsAgent atau AzureMonitorLinuxAgent. Dalam dialog yang terbuka, pilih Hapus instalan.
Menghapus instalan di mesin virtual Azure
Gunakan perintah PowerShell berikut untuk menghapus instalan Agen Azure Monitor di komputer virtual Azure.
Gunakan perintah CLI berikut untuk menghapus instalan Agen Azure Monitor di 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 instalasi pada set skala komputer virtual Azure
Gunakan cmdlet CLI penghapusan ekstensi az vmss untuk menghapus instalan Agen Azure Monitor pada set skala komputer virtual Azure.
Menghapus instalan di server berkemampuan Azure Arc
Gunakan perintah 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>
T/A
Pembaruan
Catatan
Rekomendasinya adalah mengaktifkan Peningkatan Ekstensi Otomatis untuk memperbarui ekstensi yang diinstal ke versi stabil di semua wilayah. Versi tidak diluncurkan secara otomatis sampai memenuhi bilah berkualitas tinggi yang dapat memakan waktu selama 5 minggu setelah rilis awal. Peningkatan dikeluarkan dalam batch, sehingga Anda mungkin melihat beberapa komputer virtual, set skala, atau server berkemampuan Arc ditingkatkan sebelum yang lain. Jika Anda perlu segera meningkatkan ekstensi, Anda dapat menggunakan instruksi manual di bawah ini.
Untuk melakukan pembaruan agen satu kali, Anda harus terlebih dahulu menghapus instalan versi agen yang ada. Kemudian instal versi baru seperti yang dijelaskan.
Sebaiknya Anda mengaktifkan pembaruan otomatis agen dengan mengaktifkan fitur Peningkatan Ekstensi Otomatis. Masuk ke VM atau set skala Anda, pilih tab Ekstensi dan pilih AzureMonitorWindowsAgent atau AzureMonitorLinuxAgent. Dalam dialog yang terbuka, pilih Aktifkan peningkatan otomatis.
Memperbarui di mesin virtual Azure
Untuk melakukan pembaruan satu kali agen, Anda harus terlebih dahulu menghapus instalan versi agen yang ada, lalu menginstal versi baru seperti yang dijelaskan.
Sebaiknya Anda mengaktifkan pembaruan otomatis agen dengan mengaktifkan fitur Peningkatan Ekstensi Otomatis menggunakan perintah PowerShell berikut.
Untuk melakukan pembaruan satu kali agen, Anda harus terlebih dahulu menghapus instalan versi agen yang ada, lalu menginstal versi baru seperti yang dijelaskan.
Sebaiknya Anda mengaktifkan pembaruan otomatis agen dengan mengaktifkan fitur Peningkatan Ekstensi Otomatis menggunakan perintah 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
Pembaruan pada server dengan dukungan Azure Arc
Untuk melakukan peningkatan agen satu kali, gunakan perintah 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>
Sebaiknya Anda mengaktifkan pembaruan otomatis agen dengan mengaktifkan fitur Peningkatan Ekstensi Otomatis menggunakan perintah PowerShell berikut.
Aturan Pengumpulan Data (DCR) berfungsi sebagai alat manajemen untuk Azure Monitor Agent (AMA) di komputer Anda. AgentSettings DCR dapat digunakan untuk mengonfigurasi parameter AMA tertentu untuk mengonfigurasi agen ke kebutuhan pemantauan spesifik Anda.
Catatan
Pertimbangan penting yang perlu diingat saat bekerja dengan AgentSettings DCR:
AgentSettings DCR saat ini hanya dapat dikonfigurasi menggunakan templat ARM.
AgentSettings harus berupa satu DCR tanpa pengaturan lain.
Komputer virtual dan AgentSettings DCR harus terletak di wilayah yang sama.
Parameter yang didukung
AgentSettings DCR saat ini mendukung konfigurasi parameter berikut:
Parameter
Deskripsi
Nilai yang valid
MaxDiskQuotaInMB
Menentukan jumlah ruang disk yang digunakan (dalam MB) oleh file log dan cache Agen Azure Monitor.
Linux: 1025-51199 Windows: 4000-51199
UseTimeReceivedForForwardedEvents
Mengubah kolom WEF dalam tabel WEF Sentinel untuk menggunakan TimeReceived alih-alih data TimeGenerated
{
"$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')]"
}
}
]
}