Povolení přehledů virtuálních počítačů pomocí PowerShellu

  • Článek

Tento článek popisuje, jak povolit přehledy virtuálních počítačů na virtuálních počítačích Azure pomocí PowerShellu. Tento postup lze použít pro:

  • Azure Virtual Machines
  • Škálovací sady virtuálních počítačů Azure

Tento skript nainstaluje rozšíření virtuálních počítačů pro Log Analytics nebo agenta monitorování Azure (AMA) a v případě potřeby agenta závislostí pro povolení Přehledy virtuálního počítače. Pokud je AMA onboarded, pravidlo shromažďování dat (DCR) a spravovaná identita přiřazená uživatelem (UAMI) se také přidruží k virtuálním počítačům a škálovacím sadám virtuálních počítačů.

Důležité

Starší verze agentaLog Analytics bude do srpna 2024 zastaralá. Po tomto datu už Microsoft nebude poskytovat žádnou podporu pro agenta Log Analytics. Migrace na agenta Azure Monitoru před srpnem 2024 a pokračujte v ingestování dat.

Poznámka:

Agent Služby Azure Monitor je podporovaný ve verzi 1.10.1.

Požadavky

Budete muset:

Skript PowerShellu

Pokud chcete povolit přehledy virtuálních počítačů pro více virtuálních počítačů nebo škálovací sady virtuálních počítačů, použijte skript PowerShell Install-VM Přehledy.ps1. Skript je k dispozici v Azure Galerie prostředí PowerShell. Tento skript iteruje virtuálními počítači nebo škálovacími sadami virtuálních počítačů podle zadaných parametrů. Skript se dá použít k povolení přehledů virtuálních počítačů pro:

  • Všechny virtuální počítače a škálovací sady virtuálních počítačů ve vašem předplatném
  • Vymezené skupiny prostředků určené nástrojem -ResourceGroup.
  • Virtuální počítač nebo škálovací sada virtuálních počítačů určená nástrojem -Name. Pomocí zástupných znaků můžete zadat více skupin prostředků, virtuálních počítačů nebo škálovacích sad.

Ověřte, že používáte modul Az PowerShell verze 1.0.0 nebo novější s povolenými Enable-AzureRM aliasy kompatibility. Verzi zjistíte spuštěním příkazu Get-Module -ListAvailable Az. Pokud chcete upgradovat, přečtěte si téma Instalace modulu Azure PowerShellu. Pokud používáte PowerShell místně, spusťte Connect-AzAccount spuštění a vytvořte připojení k Azure.

Seznam podrobností argumentu skriptu a příklad použití spusťte Get-Help.

Get-Help Install-VMInsights.ps1 -Detailed

Pomocí skriptu můžete povolit přehledy virtuálních počítačů pomocí agenta monitorování Azure a agenta závislostí nebo agenta Log Analytics.

Když povolíte přehledy virtuálních počítačů pomocí agenta služby Azure Monitor, skript přidruží pravidlo shromažďování dat (DCR) a spravovanou identitu přiřazenou uživatelem (UAMI) ke škálovací sadě virtuálních počítačů nebo virtuálních počítačů. Nastavení UAMI se předá rozšíření agenta služby Azure Monitor.

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

Požadované argumenty:

  • -SubscriptionId <String> ID předplatného Azure.
  • -DcrResourceId <String> Identifikátor ID prostředku Azure (DCR) pro shromažďování dat U virtuálních počítačů nebo škálovacích sad virtuálních počítačů, které jsou povolené pomocí Přehledy virtuálních počítačů, můžete určit řadiče domény z různých předplatných.
  • -UserAssignedManagedIdentityResourceGroup <String> Název skupiny prostředků UAMI (User Assigned Managed Identity).
  • -UserAssignedManagedIdentityName <String> Název spravované identity přiřazené uživatelem (UAMI).

Volitelné argumenty:

  • -ProcessAndDependencies Tento příznak nastavte na onboarding závislého agenta s nastavením agenta monitorování Azure (AMA). Pokud není zadaný, je onboardován pouze agent AMA (Azure Monitoring Agent).
  • -Name <String> Název škálovací sady virtuálních počítačů nebo škálovací sady virtuálních počítačů, které se mají připojit. Pokud není zadaný, všechny virtuální počítače a škálovací sada virtuálních počítačů v předplatném nebo skupině prostředků jsou nasazené. Pomocí zástupných znaků můžete zadat několik virtuálních počítačů nebo škálovacích sad virtuálních počítačů.
  • -ResourceGroup <String> Název skupiny prostředků obsahující virtuální počítač nebo škálovací sadu virtuálních počítačů, které se mají připojit. Pokud ho nezadáte, všechny virtuální počítače a škálovací sada virtuálních počítačů v předplatném se zprovozní. Pomocí zástupných znaků můžete zadat více skupin prostředků.
  • -PolicyAssignmentName <String> Zahrnout pouze virtuální počítače přidružené k této zásadě. Pokud je zadán parametr PolicyAssignmentName, považují se virtuální počítače za součást parametru SubscriptionId.
  • -TriggerVmssManualVMUpdate [<SwitchParameter>] Aktivace aktualizace instancí virtuálních počítačů ve škálovací sadě, jejíž zásady upgradu jsou nastavené na Ruční.
  • -WhatIf [<SwitchParameter>] Získejte informace o očekávaném efektu příkazů ve skriptu.
  • -Confirm [<SwitchParameter>] Potvrďte každou akci ve skriptu.
  • -Approve [<SwitchParameter>] Poskytněte schválení instalace, aby se spustila bez výzvy k potvrzení pro uvedené škálovací sady virtuálních počítačů nebo virtuálních počítačů.

Skript podporuje zástupné kóty pro -Name a -ResourceGroup. Umožňuje například -Name vm* přehledy virtuálních počítačů pro všechny virtuální počítače a škálovací sady virtuálních počítačů, které začínají na virtuálním počítači. Další informace najdete v tématu Zástupné dokumentace v prostředí Windows PowerShell.

Příklad:

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

Výstup má následující formát:

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

Zkontrolujte virtuální počítač nebo škálovací sadu virtuálních počítačů na webu Azure Portal a zjistěte, jestli jsou rozšíření nainstalovaná, nebo použijte následující příkaz:


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

Další kroky

  • Viz Použití mapy přehledů virtuálních počítačů k zobrazení zjištěných závislostí aplikace.
  • Informace o zjištění kritických bodů, celkového využití a výkonu virtuálního počítače najdete v tématu Zobrazení výkonu virtuálního počítače Azure.