مشاركة عبر

تمكين نتائج تحليلات الجهاز الظاهري باستخدام PowerShell

  • مقالة

توضح هذه المقالة كيفية تمكين رؤى الجهاز الظاهري على أجهزة Azure الظاهرية باستخدام PowerShell. يمكن استخدام هذا الإجراء من أجل:

  • Azure Virtual Machines
  • مجموعات توسعة الأجهزة الظاهرية في Azure

يقوم هذا البرنامج النصي بتثبيت ملحقات الجهاز الظاهري لعامل مراقبة Azure (AMA)، وإذا لزم الأمر، عامل التبعية لتمكين VM Insights. إذا تم إلحاق AMA، يتم أيضا ربط قاعدة تجميع البيانات (DCR) والهوية المدارة المعينة من قبل المستخدم (UAMI) بالأجهزة الظاهرية ومجموعات مقياس الجهاز الظاهري.

إشعار

يتم دعم Azure Monitor Agent من الإصدار 1.10.1.

المتطلبات الأساسية

تحتاج إلى:

البرنامج النصي لـ PowerShell:

لتمكين رؤى الجهاز الظاهري لأجهزة ظاهرية متعددة أو مجموعة مقياس الجهاز الظاهري، استخدم البرنامج النصي PowerShell Install-VMInsights.ps1. البرنامج النصي متاح من معرض Azure PowerShell. يتكرر هذا البرنامج النصي من خلال الأجهزة الظاهرية أو مجموعات مقياس الجهاز الظاهري وفقا للمعلمات التي تحددها. يمكن استخدام البرنامج النصي لتمكين رؤى الجهاز الظاهري من أجل:

  • كل جهاز ظاهري ومقياس جهاز ظاهري يعين في الاشتراك الخاص بك.
  • مجموعات الموارد المحددة من قبل -ResourceGroup.
  • جهاز ظاهري أو مجموعة مقياس جهاز ظاهري محددة بواسطة -Name. يمكنك تحديد مجموعات موارد متعددة أو أجهزة ظاهرية أو مجموعات مقياس باستخدام أحرف البدل.

تحقق من أنك تستخدم إصدار الوحدة النمطية Az PowerShell 1.0.0 أو أحدث مع Enable-AzureRM تمكين الأسماء المستعارة للتوافق. قم بتشغيل Get-Module -ListAvailable Az للعثور على الإصدار. للترقية، راجع تثبيت وحدة Azure PowerShell النمطية. إذا كنت تقوم بتشغيل PowerShell محليا، فقم بتشغيل Connect-AzAccount لإنشاء اتصال مع Azure.

للحصول على قائمة بتفاصيل وسيطة البرنامج النصي ومثال الاستخدام، قم بتشغيل Get-Help.

Get-Help Install-VMInsights.ps1 -Detailed

استخدم البرنامج النصي لتمكين نتائج تحليلات الجهاز الظاهري باستخدام عامل مراقبة Azure وعامل التبعية.

عند تمكين رؤى الجهاز الظاهري باستخدام عامل Azure Monitor، يربط البرنامج النصي قاعدة تجميع البيانات (DCR) والهوية المدارة المعينة من قبل المستخدم (UAMI) بمجموعة مقياس الجهاز الظاهري/الجهاز الظاهري. يتم تمرير إعدادات UAMI إلى ملحق Azure Monitor Agent.

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

الوسيطات المطلوبة:

  • -SubscriptionId <String> معرف اشتراك Azure.
  • -DcrResourceId <String> معرف مورد Azure لقاعدة تجميع البيانات (DCR). يمكنك تحديد DCRs من اشتراكات مختلفة للأجهزة الظاهرية أو مجموعات مقياس الجهاز الظاهري التي يتم تمكينها باستخدام Vm-Insights.
  • -UserAssignedManagedIdentityResourceGroup <String> اسم مجموعة موارد الهوية المدارة المعينة من قبل المستخدم (UAMI).
  • -UserAssignedManagedIdentityName <String> اسم الهوية المدارة المعينة من قبل المستخدم (UAMI).

الوسيطات الاختيارية:

  • -ProcessAndDependencies قم بتعيين هذه العلامة على إلحاق عامل التبعية بإعدادات عامل مراقبة Azure (AMA). إذا لم يتم تحديده، يتم إعداد عامل مراقبة Azure (AMA) فقط.
  • -Name <String> اسم الجهاز الظاهري أو مجموعة مقياس الجهاز الظاهري التي سيتم إلحاقها. إذا لم يتم تحديدها، يتم إلحاق جميع الأجهزة الظاهرية ومجموعة مقياس الجهاز الظاهري في الاشتراك أو مجموعة الموارد. استخدم أحرف البدل لتحديد أجهزة ظاهرية متعددة أو مجموعات مقياس الجهاز الظاهري.
  • -ResourceGroup <String> اسم مجموعة الموارد التي تحتوي على الجهاز الظاهري أو مجموعة مقياس الجهاز الظاهري ليتم إلحاقها. إذا لم يتم تحديدها، يتم إلحاق جميع الأجهزة الظاهرية ومجموعة مقياس الجهاز الظاهري في الاشتراك. استخدم أحرف البدل لتحديد مجموعات موارد متعددة.
  • -PolicyAssignmentName <String> قم بتضمين الأجهزة الظاهرية المقترنة بهذا النهج فقط. عند تحديد المعلمة PolicyAssignmentName، يتم اعتبار جزء الأجهزة الظاهرية من المعلمة SubscriptionId.
  • -TriggerVmssManualVMUpdate [<SwitchParameter>] قم بتشغيل تحديث مثيلات الجهاز الظاهري في مجموعة مقياس تم تعيين نهج ترقيتها إلى يدوي.
  • -WhatIf [<SwitchParameter>] احصل على معلومات حول التأثير المتوقع للأوامر في البرنامج النصي.
  • -Confirm [<SwitchParameter>] قم بتأكيد كل إجراء في البرنامج النصي.
  • -Approve [<SwitchParameter>] قم بتوفير الموافقة على التثبيت للبدء بدون مطالبة تأكيد لمجموعات مقياس الجهاز الظاهري/الجهاز الظاهري المدرجة.

يدعم البرنامج النصي أحرف البدل ل -Name و -ResourceGroup. على سبيل المثال، -Name vm* يمكن نتائج تحليلات الجهاز الظاهري لجميع الأجهزة الظاهرية ومجموعات مقياس الجهاز الظاهري التي تبدأ ب "vm". لمزيد من المعلومات، راجع أحرف البدل في Windows PowerShell.

مثال:

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

يحتوي الإخراج على التنسيق التالي:

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

تحقق من VM/Virtual Machine Scale Set في مدخل Microsoft Azure لمعرفة ما إذا كانت الملحقات مثبتة أو استخدم الأمر التالي:


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

الخطوات التالية