Mengaktifkan wawasan VM dengan menggunakan PowerShell

  • Artikel

Artikel ini menjelaskan cara mengaktifkan wawasan VM di komputer virtual Azure dengan menggunakan PowerShell. Prosedur ini dapat digunakan untuk:

  • Azure Virtual Machines
  • Kumpulan Skala Komputer Virtual Azure

Skrip ini menginstal ekstensi VM untuk Log Analytics/Azure Monitoring Agent (AMA) dan, jika perlu, Agen Dependensi untuk mengaktifkan Wawasan VM. Jika AMA di-onboarding, Aturan Pengumpulan Data (DCR) dan Identitas Terkelola yang Ditetapkan Pengguna (UAMI) juga dikaitkan dengan komputer virtual dan set skala komputer virtual.

Penting

Agen Analitik Log warisan tidak akan digunakan lagi pada Agustus 2024. Setelah tanggal ini, Microsoft tidak akan lagi memberikan dukungan apa pun untuk agen Analitik Log. Bermigrasi ke agen Azure Monitor sebelum Agustus 2024 untuk terus menyerap data.

Catatan

Agen Azure Monitor didukung dari versi 1.10.1.

Prasyarat

Anda perlu:

skrip PowerShell

Untuk mengaktifkan wawasan VM untuk beberapa VM atau set skala komputer virtual, gunakan skrip PowerShell Install-VMInsights.ps1. Skrip tersedia dari Galeri Azure PowerShell. Skrip ini berulang melalui komputer virtual atau set skala komputer virtual sesuai dengan parameter yang Anda tentukan. Skrip dapat digunakan untuk mengaktifkan wawasan VM untuk:

  • Setiap mesin virtual dan skala mesin virtual ditetapkan dalam langganan Anda.
  • Grup sumber daya terlingkup yang ditentukan oleh -ResourceGroup.
  • VM atau set skala komputer virtual yang ditentukan oleh -Name. Anda dapat menentukan beberapa grup sumber daya, VM, atau set skala dengan menggunakan kartubebas.

Verifikasi bahwa Anda menggunakan modul Az PowerShell versi 1.0.0 atau yang lebih baru dengan Enable-AzureRM alias kompatibilitas diaktifkan. Jalankan Get-Module -ListAvailable Az untuk menemukan versinya. Untuk meningkatkan, lihat Menginstal modul Azure PowerShell. Jika Anda menjalankan PowerShell secara lokal, jalankan Connect-AzAccount untuk membuat koneksi dengan Azure.

Untuk daftar detail argumen skrip dan contoh penggunaan, jalankan Get-Help.

Get-Help Install-VMInsights.ps1 -Detailed

Gunakan skrip untuk mengaktifkan wawasan VM menggunakan Agen Pemantauan Azure dan Agen Dependensi, atau Agen Analitik Log.

Saat Anda mengaktifkan wawasan VM menggunakan Azure Monitor Agent, skrip mengaitkan Aturan Pengumpulan Data (DCR) dan User Assigned Managed Identity (UAMI) ke VM/Virtual Machine Scale Set. Pengaturan UAMI diteruskan ke ekstensi Agen Azure Monitor.

Install-VMInsights.ps1 -SubscriptionId <SubscriptionId> `
[-ResourceGroup <ResourceGroup>] `
[-ProcessAndDependencies ] `
[-Name <VM or Virtual Machine Scale Set name>] `
-DcrResourceId <DataCollectionRuleResourceId> `
-UserAssignedManagedIdentityName <UserAssignedIdentityName> `
-UserAssignedManagedIdentityResourceGroup <UserAssignedIdentityResourceGroup>

Argumen yang Diperlukan:

  • -SubscriptionId <String> ID langganan Azure.
  • -DcrResourceId <String> Pengidentifikasi ID sumber daya Azure Aturan Pengumpulan Data (DCR). Anda dapat menentukan DCR dari langganan yang berbeda ke VM atau set skala komputer virtual yang diaktifkan dengan Vm-Insights.
  • -UserAssignedManagedIdentityResourceGroup <String> Nama grup sumber daya User Assigned Managed Identity (UAMI).
  • -UserAssignedManagedIdentityName <String> Nama Identitas Terkelola yang Ditetapkan Pengguna (UAMI).

Argumen Opsional:

  • -ProcessAndDependencies Atur bendera ini ke onboarding Agen Dependensi dengan pengaturan Azure Monitoring Agent (AMA). Jika tidak ditentukan, hanya Azure Monitoring Agent (AMA) yang di-onboarding.
  • -Name <String> Nama VM atau Virtual Machine Scale Set yang akan di-onboarding. Jika tidak ditentukan, semua VM dan Virtual Machine Scale Set dalam grup langganan atau sumber daya di-onboarding. Gunakan kartubebas untuk menentukan beberapa VM atau Virtual Machine Scale Sets.
  • -ResourceGroup <String> Nama grup sumber daya yang berisi VM atau Virtual Machine Scale Set yang akan di-onboarding. Jika tidak ditentukan, semua VM dan Virtual Machine Scale Set dalam langganan di-onboarding. Gunakan kartubebas untuk menentukan beberapa grup sumber daya.
  • -PolicyAssignmentName <String> Hanya menyertakan VM yang terkait dengan kebijakan ini. Saat parameter PolicyAssignmentName ditentukan, bagian VM dari parameter SubscriptionId dipertimbangkan.
  • -TriggerVmssManualVMUpdate [<SwitchParameter>] Picu pembaruan instans VM dalam set skala yang kebijakan peningkatannya diatur ke Manual.
  • -WhatIf [<SwitchParameter>] Dapatkan info tentang efek perintah yang diharapkan dalam skrip.
  • -Confirm [<SwitchParameter>] Konfirmasikan setiap tindakan dalam skrip.
  • -Approve [<SwitchParameter>] Berikan persetujuan agar penginstalan dimulai tanpa permintaan konfirmasi untuk VM/Virtual Machine Scale Sets yang tercantum.

Skrip mendukung wildcard untuk -Name dan -ResourceGroup. Misalnya, -Name vm* mengaktifkan wawasan VM untuk semua VM dan Virtual Machine Scale Sets yang dimulai dengan "vm". Untuk informasi selengkapnya, lihat Wildcard di Windows PowerShell.

Contoh:

Install-VMInsights.ps1 -SubscriptionId 12345678-abcd-abcd-1234-12345678 `
-ResourceGroup rg-AMAPowershell  `
-ProcessAndDependencies  `
-Name vmAMAPowershellWindows `
-DcrResourceId /subscriptions/12345678-abcd-abcd-1234-12345678/resourceGroups/rg-AMAPowershell/providers/Microsoft.Insights/dataCollectionRules/MSVMI-ama-vmi-default-dcr `
-UserAssignedManagedIdentityName miamatest1  `
-UserAssignedManagedIdentityResourceGroup amapowershell

Output memiliki format berikut:

Name                                     Account                               SubscriptionName                      Environment                          TenantId
----                                     -------                               ----------------                      -----------                          --------
AzMon001 12345678-abcd-123…              MSI@9876                              AzMon001                              AzureCloud                           abcd1234-9876-abcd-1234-1234abcd5648

Getting list of VMs or VM Scale Sets matching specified criteria.
VMs and Virtual Machine Scale Sets matching selection criteria :

ResourceGroup : rg-AMAPowershell
  vmAMAPowershellWindows


Confirm
Continue?
[Y] Yes  [N] No  [S] Suspend  [?] Help (default is "Y"): 

(rg-AMAPowershell) : Assigning roles

(rg-AMAPowershell) vmAMAPowershellWindows : Assigning User Assigned Managed Identity edsMIAMATest
(rg-AMAPowershell) vmAMAPowershellWindows : Successfully assigned User Assigned Managed Identity edsMIAMATest
(rg-AMAPowershell) vmAMAPowershellWindows : Data Collection Rule Id /subscriptions/12345678-abcd-abcd-1234-12345678/resourceGroups/rg-AMAPowershell/providers/Microsoft.Insights/dataCollectionRules/MSVMI-ama-vmi-default-dcr already associated with the VM.
(rg-AMAPowershell) vmAMAPowershellWindows : Extension AzureMonitorWindowsAgent, type = Microsoft.Azure.Monitor.AzureMonitorWindowsAgent already installed. Provisioning State : Succeeded
(rg-AMAPowershell) vmAMAPowershellWindows : Installing/Updating extension AzureMonitorWindowsAgent, type = Microsoft.Azure.Monitor.AzureMonitorWindowsAgent
(rg-AMAPowershell) vmAMAPowershellWindows : Successfully installed/updated extension AzureMonitorWindowsAgent, type = Microsoft.Azure.Monitor.AzureMonitorWindowsAgent
(rg-AMAPowershell) vmAMAPowershellWindows : Installing/Updating extension DA-Extension, type = Microsoft.Azure.Monitoring.DependencyAgent.DependencyAgentWindows
(rg-AMAPowershell) vmAMAPowershellWindows : Successfully installed/updated extension DA-Extension, type = Microsoft.Azure.Monitoring.DependencyAgent.DependencyAgentWindows
(rg-AMAPowershell) vmAMAPowershellWindows : Successfully onboarded VM insights

Summary :
Total VM/VMSS to be processed : 1
Succeeded : 1
Skipped : 0
Failed : 0
VMSS Instance Upgrade Failures : 0

Periksa VM/Virtual Machine Scale Set Anda di portal Azure untuk melihat apakah ekstensi diinstal atau gunakan perintah berikut:


az vm extension list --resource-group <resource group> --vm-name <VM name>  -o table 


Name                      ProvisioningState    Publisher                                   Version    AutoUpgradeMinorVersion
------------------------  -------------------  ------------------------------------------  ---------  -------------------------
AzureMonitorWindowsAgent  Succeeded            Microsoft.Azure.Monitor                     1.16       True
DA-Extension              Succeeded            Microsoft.Azure.Monitoring.DependencyAgent  9.10       True

Langkah berikutnya