ملحق جهاز Azure Monitor Dependency الظاهري لنظام التشغيل Windows

مقالة
03/05/2024

تحصل ميزة Azure Monitor لمخطط الأجهزة الظاهرية على بياناتها من عامل Microsoft Dependency. يقوم ملحق الجهاز الظاهري لعامل Azure VM Dependency ل Windows بتثبيت عامل التبعية على أجهزة Azure الظاهرية. يوضح هذا المستند الأنظمة الأساسية والتكوينات وخيارات التوزيع المدعومة لملحق الجهاز الظاهري لعامل Azure VM Dependency لنظام التشغيل Windows.

نظام التشغيل

يمكن تشغيل ملحق عامل تبعية جهاز Azure الظاهري لنظام التشغيل Windows مقابل أنظمة التشغيل المدعومة المدرجة في الجدول التالي. يفترض أن تكون جميع أنظمة التشغيل في الجدول التالي x64. x86 غير معتمد لأي نظام تشغيل.

نظام التشغيل	عامل تبعية جهاز Azure الظاهري
Windows Server 2022	√
Windows Server 2022 Core	√
Windows Server 2019	√
Windows Server 2019 Core	√
Windows Server 2016	√
Windows Server 2016 Core	√
Windows Server 2012 R2	√
Windows Server 2012	√
عميل Windows 11 وPro	^✓1، ²
Windows 11 Enterprise (بما في ذلك جلسات متعددة)	√
Windows 10 1803 (RS4) وأعلى	^✓1
Windows 10 Enterprise (بما في ذلك جلسات متعددة) وPro (سيناريوهات الخادم فقط)	√
Windows 8 Enterprise وPro (سيناريوهات الخادم فقط)
Windows 7 SP1 (سيناريوهات الخادم فقط)
Azure Stack HCI
Windows IoT Enterprise	√

¹ استخدام مثبت عميل عامل Azure Monitor.
² مدعوم أيضا على الأجهزة المستندة إلى Arm64.

مخطط الملحق

يعرض JSON التالي المخطط الخاص بملحق عامل Azure VM Dependency على جهاز Azure Windows ظاهري.

{
  "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "vmName": {
      "type": "string",
      "metadata": {
        "description": "The name of existing Azure VM. Supported Windows Server versions:  2008 R2 and above (x64)."
      }
    }
  },
  "variables": {
    "vmExtensionsApiVersion": "2017-03-30"
  },
  "resources": [
    {
      "type": "Microsoft.Compute/virtualMachines/extensions",
      "name": "[concat(parameters('vmName'),'/DAExtension')]",
      "apiVersion": "[variables('vmExtensionsApiVersion')]",
      "location": "[resourceGroup().location]",
      "dependsOn": [],
      "properties": {
          "publisher": "Microsoft.Azure.Monitoring.DependencyAgent",
          "type": "DependencyAgentWindows",
          "typeHandlerVersion": "9.10",
          "autoUpgradeMinorVersion": true,
          "settings": {
                "enableAMA": "true"
		    }
      }
    }
  ],
    "outputs": {
    }
}

قيم Property

الاسم	القيمة/المثال
apiVersion	2015-01-01
publisher	Microsoft.Azure.Monitoring.DependencyAgent
النوع	DependencyAgentWindows
typeHandlerVersion	9.10
autoUpgradeMinorVersion	صحيح
إعدادات	"enableAMA": "true"

هام

تأكد من إضافة enableAMA إلى القالب الخاص بك إذا كنت تستخدم عامل Azure Monitor؛ وإلا، يحاول عامل التبعية إرسال البيانات إلى عامل Log Analytics القديم.

توزيع قالب

يمكنك توزيع ملحقات جهاز Azure الظاهري باستخدام قوالب Azure Resource Manager. يمكنك استخدام مخطط JSON المفصل في القسم السابق في قالب Azure Resource Manager لتشغيل ملحق عامل Azure VM أثناء توزيع قالب Azure Resource Manager.

يمكن تداخل JSON لملحق الجهاز الظاهري داخل مورد الجهاز الظاهري. أو يمكنك وضعه في المستوى الجذري أو العلوي لقالب JSON في Resource Manager. يؤثر موضع JSON على قيمة اسم المورد ونوعه. لمزيد من المعلومات، راجع تعيين اسم ونوع الموارد التابعة.

يفترض المثال التالي أن ملحق الجهاز الظاهري متداخل داخل مورد الجهاز الظاهري. عند تداخل مورد الملحق، يتم وضع JSON في كائن "resources": [] للجهاز الظاهري.

{
	"type": "extensions",
	"name": "DAExtension",
	"apiVersion": "[variables('apiVersion')]",
	"location": "[resourceGroup().location]",
	"dependsOn": [
		"[concat('Microsoft.Compute/virtualMachines/', variables('vmName'))]"
	],
	"properties": {
      "publisher": "Microsoft.Azure.Monitoring.DependencyAgent",
      "type": "DependencyAgentWindows",
      "typeHandlerVersion": "9.10",
      "autoUpgradeMinorVersion": true,
      "settings": {
            "enableAMA": "true"
    		    }
    }
}

عند وضع الملحق JSON في جذر القالب، يتضمن اسم المورد مرجعًا إلى الجهاز الظاهري الأصل. يعكس النوع التكوين المتداخل.

{
	"type": "Microsoft.Compute/virtualMachines/extensions",
	"name": "<parentVmResource>/DAExtension",
	"apiVersion": "[variables('apiVersion')]",
	"location": "[resourceGroup().location]",
	"dependsOn": [
		"[concat('Microsoft.Compute/virtualMachines/', variables('vmName'))]"
	],
	"properties": {
      "publisher": "Microsoft.Azure.Monitoring.DependencyAgent",
      "type": "DependencyAgentWindows",
      "typeHandlerVersion": "9.10",
      "autoUpgradeMinorVersion": true,
      "settings": {
            "enableAMA": "true"
    		    }
	}
}

توزيع PowerShell

يمكنك استخدام الأمر Set-AzVMExtension لتوزيع ملحق الجهاز الظاهري لعامل Dependency إلى جهاز ظاهري موجود. قبل تشغيل الأمر، يجب تخزين التكوينات العامة والخاصة في جدول تجزئة PowerShell.


Set-AzVMExtension -ExtensionName "Microsoft.Azure.Monitoring.DependencyAgent" `
    -ResourceGroupName "myResourceGroup" `
    -VMName "myVM" `
    -Publisher "Microsoft.Azure.Monitoring.DependencyAgent" `
    -ExtensionType "DependencyAgentWindows" `
    -TypeHandlerVersion 9.10 `
    -Location WestUS

ترقية الملحق التلقائي

تتوفر الآن ميزة جديدة لترقية الإصدارات الثانوية تلقائيًا من ملحق Dependency.

لتمكين ترقية الملحق تلقائيًا لملحق، يجب التأكد من تعيين الخاصية enableAutomaticUpgrade إلى true وإضافتها إلى قالب الملحق. يجب تمكين هذه الخاصية على كل جهاز ظاهري ومجموعة توسعة جهاز ظاهري بشكل فردي. استخدم إحدى الطرق الموضحة في القسم تمكين لتمكين الميزة لجهاز ظاهري أو مجموعة توسعة جهاز ظاهري.

عند تمكين ترقية الملحق تلقائيًا على جهاز ظاهري أو مجموعة توسعة جهاز ظاهري، تتم ترقية الملحق تلقائيًا كلما أصدر ناشر الملحق إصدارًا جديدًا لهذا الملحق. يتم تطبيق الترقية بأمان وفقًا لمبادئ التوافر أولاً كما هو موضح هنا.

تختلف وظيفة السمة enableAutomaticUpgrade عن تلك الخاصة بـ autoUpgradeMinorVersion. autoUpgradeMinorVersion لا تقوم السمة تلقائيا بتشغيل تحديث إصدار ثانوي عندما يصدر ناشر الملحق إصدارا جديدا. تشير السمة autoUpgradeMinorVersion إلى ما إذا كان يجب أن يستخدم الملحق إصدارًا ثانويًا أحدث إذا كان متوفرًا في وقت التوزيع. ومع ذلك، بمجرد النشر، لن يقوم الملحق بترقية الإصدارات الثانوية ما لم تتم إعادة توزيعه، حتى مع تعيين هذه الخاصية إلى صحيح.

للحفاظ على تحديث إصدار الملحق، نوصي باستخدام enableAutomaticUpgrade مع توزيع الملحق.

هام

في حالة إضافة enableAutomaticUpgrade إلى القالب، فتأكد من استخدامه في إصدار واجهة برمجة التطبيقات 2019-12-01 أو أعلى.

استكشاف الأخطاء وإصلاحها والدعم

استكشاف الأخطاء وإصلاحها

يمكن استرداد البيانات حول حالة عمليات توزيع الملحقات من مدخل Microsoft Azure وباستخدام وحدة Azure PowerShell النمطية. للاطلاع على حالة توزيع ملحقات جهاز ظاهري معين، قم بتشغيل الأمر التالي باستخدام وحدة Azure PowerShell النمطية:

Get-AzVMExtension -ResourceGroupName myResourceGroup -VMName myVM -Name myExtensionName

يتم تسجيل إخراج تنفيذ الملحق في الملفات الموجودة في الدليل التالي:

C:\WindowsAzure\Logs\Plugins\Microsoft.Azure.Monitoring.DependencyAgent\

يدعم

إذا كنت بحاجة إلى مزيد من المساعدة في أي وقت من هذه المقالة، يمكنك الاتصال بخبراء Azure في منتديات Microsoft Q وAds stack Overflow. أو يمكنك الإبلاغ عن حادث دعم Azure. انتقل إلى موقع دعم Azure، وحدد الحصول على الدعم. للحصول على معلومات حول استخدام دعم Azure، اقرأ الأسئلة المتداولة حول دعم Microsoft Azure.