ملحق الجهاز الظاهري Log Analytics لـ Linux

نظرة عامة

توفر سجلات Azure Monitor المراقبة والتنبيه وإمكانات معالجة التنبيهات عبر السحابة والأصول المحلية. تم توزيع ملحق الجهاز الظاهري Log Analytics لنظام Linux ودعمه بواسطة Microsoft. يقوم الملحق بتثبيت عامل Log Analytics على الأجهزة الظاهرية Azure، وتسجيل الأجهزة الظاهرية في مساحة عمل Log Analytics الحالية. يوضح هذا المستند تفاصيل الأنظمة الأساسية المدعومة والتكوينات وخيارات التوزيع لملحق الجهاز الظاهري Log Analytics لنظام Linux.

إشعار

تمكّنك الخوادم الممكّنة من قبل Azure Arc من توزيع وإزالة وتحديث ملحق الجهاز الظاهري لعامل Log Analytics للأجهزة غير التابعة لـ Azure التي تعمل بنظامي التشغيل Windows وLinux، ما يبسط إدارة جهازك المختلط خلال دورة حياته. لمزيد من المعلومات، راجع إدارة ملحق الجهاز الظاهري باستخدام الخوادم الممكّنة من قبل Azure Arc.

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

نظام التشغيل

للحصول على تفاصيل حول توزيعات Linux المدعومة، راجع مقالة نظرة عامة على عوامل Azure Monitor.

إصدار Agent and VM Extension

يوفر الجدول التالي تعييناً لإصدار ملحق Log Analytics VM ومجموعة عامل Log Analytics لكل إصدار. تم تضمين ارتباط إلى ملاحظات حول الإصدار الخاصة بإصدار مجموعة عامل Log Analytics. تتضمن ملاحظات حول الإصدار تفاصيل حول تصحيحات الأخطاء والميزات الجديدة المتاحة لإصدار عامل معين.

إصدار ملحق Log Analytics Linux VM	إصدار مجموعة Log Analytics Agent
1.19.0	1.19.0
1.18.1	1.18.1
1.17.2	1.17.2
1.17.1	1.17.1
1.16.0	1.16.0
1.14.23	1.14.23
1.14.20	1.14.20
1.14.19	1.14.19
1.14.16	1.14.16
1.14.13	1.14.13
1.14.11	1.14.11
1.14.9	1.14.9
1.13.40	1.13.40
1.13.35	1.13.35
1.13.33	1.13.33
1.13.27	1.13.27
1.13.15	1.13.9-0
1.12.25	1.12.15-0
1.11.15	1.11.0-9
1.10.0	1.10.0-1
1.9.1	1.9.0-0
1.8.11	1.8.1-256
1.8.0	1.8.0-256
1.7.9	1.6.1-3
1.6.42.0	1.6.0-42
1.4.60.2	1.4.4-210
1.4.59.1	1.4.3-174
1.4.58.7	14.2-125
1.4.56.5	1.4.2-124
1.4.55.4	1.4.1-123
1.4.45.3	1.4.1-45
1.4.45.2	1.4.0-45
1.3.127.5	1.3.5-127
1.3.127.7	1.3.5-127
1.3.18.7	1.3.4-15

Microsoft Defender للسحابة

Microsoft Defender يكوّن إعدادات تشغيل الخدمة للسحابة تلقائياً لعامل Log Analytics ويعيّنه بمساحة عمل Log Analytics الافتراضية التي أنشأها Defender للسحابة في اشتراك Azure الخاص بك. إذا كنت تستخدم Microsoft Defender for Cloud، فلا تقم بتشغيل الخطوات الواردة في هذا المستند. يؤدي القيام بذلك إلى الكتابة فوق مساحة العمل التي تم تكوينها وقطع الاتصال بـ Microsoft Defender للسحابة.

الاتصال بالإنترنت

يتطلب ملحق عامل Log Analytics لنظام Linux أن يكون الجهاز الظاهري الهدف متصلا بالإنترنت.

مخطط الملحق

يُظهر JSON التالي مخطط ملحق عامل Log Analytics. يتطلب الملحق معرف مساحة العمل ومفتاح مساحة العمل من مساحة عمل Log Analytics المستهدفة؛ يمكن العثور على هذه القيم في مساحة عمل Log Analytics في مدخل Microsoft Azure. نظراً لأنه يجب التعامل مع مفتاح مساحة العمل كبيانات حساسة، يجب تخزينه في تكوين إعداد محمي. تُشفّر بيانات الإعداد المحمي لملحق Azure VM، ويتم فك تشفيرها فقط على الجهاز الظاهري الهدف. لاحظ أن workspaceId وworkspaceKey حساسان لحالة الأحرف.

إشعار

بسبب إيقاف العمل بـ حل Container Monitoring، تستخدم الوثائق التالية الإعداد الاختياري ‎"skipDockerProviderInstall": true.

{
  "type": "Microsoft.Compute/virtualMachines/extensions",
  "name": "OMSExtension",
  "apiVersion": "2018-06-01",
  "location": "<location>",
  "dependsOn": [
    "[concat('Microsoft.Compute/virtualMachines/', <vm-name>)]"
  ],
  "properties": {
    "publisher": "Microsoft.EnterpriseCloud.Monitoring",
    "type": "OmsAgentForLinux",
    "typeHandlerVersion": "1.16",
    "autoUpgradeMinorVersion": true,
    "settings": {
      "workspaceId": "myWorkspaceId",
      "skipDockerProviderInstall": true
    },
    "protectedSettings": {
      "workspaceKey": "myWorkSpaceKey"
    }
  }
}

إشعار

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

قيم Property

الاسم	القيمة / المثال
apiVersion	2018-06-01
publisher	Microsoft.EnterpriseCloud.Monitoring
النوع	OmsAgentForLinux
typeHandlerVersion	1.16
مساحة العمل (على سبيل المثال)	6f680a37-00c6-41c7-a93f-1437e3462574
workspaceKey (e.g)	z4bU3p1/GrnWpQkky4gdabWXAhbWSTz70hm4m2Xt92XI+rSRgE8qVvRhsGo9TXffbrTahyrwv35W0pOqQAU7uQ==

توزيع قالب

إشعار

يتم أيضاً شحن مكونات معينة لملحق Log Analytics VM في ملحق Diagnostics VM. بسبب هذه البنية، يمكن أن تنشأ التعارضات إذا تم إنشاء مثيل لكلا الملحقين في نفس قالب Azure Resource Manager. لتجنب تعارضات وقت التثبيت هذه، استخدم dependsOn التوجيه للتأكد من تثبيت الملحقات بشكل تسلسلي. يمكن تثبيت الملحقات بأي من الترتيبين.

يمكن توزيع ملحقات جهاز Azure الظاهري باستخدام قوالب Azure Resource Manager. تعتبر القوالب مثالية عند توزيع جهاز ظاهري واحد أو أكثر والتي تتطلب تكوين ما بعد التوزيع مثل إلحاق سجلات إلى Azure Monitor. يمكن العثور على عينة لقالب Resource Manager يتضمن ملحق VM لعامل Log Analytics في Azure Quickstart Gallery.

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

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

{
  "type": "extensions",
  "name": "OMSExtension",
  "apiVersion": "2018-06-01",
  "location": "<location>",
  "dependsOn": [
    "[concat('Microsoft.Compute/virtualMachines/', <vm-name>)]"
  ],
  "properties": {
    "publisher": "Microsoft.EnterpriseCloud.Monitoring",
    "type": "OmsAgentForLinux",
    "typeHandlerVersion": "1.16",
    "settings": {
      "workspaceId": "myWorkspaceId",
      "skipDockerProviderInstall": true
    },
    "protectedSettings": {
      "workspaceKey": "myWorkSpaceKey"
    }
  }
}

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

{
  "type": "Microsoft.Compute/virtualMachines/extensions",
  "name": "<parentVmResource>/OMSExtension",
  "apiVersion": "2018-06-01",
  "location": "<location>",
  "dependsOn": [
    "[concat('Microsoft.Compute/virtualMachines/', <vm-name>)]"
  ],
  "properties": {
    "publisher": "Microsoft.EnterpriseCloud.Monitoring",
    "type": "OmsAgentForLinux",
    "typeHandlerVersion": "1.16",
    "settings": {
      "workspaceId": "myWorkspaceId",
      "skipDockerProviderInstall": true
    },
    "protectedSettings": {
      "workspaceKey": "myWorkSpaceKey"
    }
  }
}

توزيع Azure CLI

يمكن استخدام Azure CLI لتوزيع ملحق VM لعامل Log Analytics على جهاز ظاهري موجود. استبدل قيمة myWorkspaceKey أدناه بمفتاح مساحة العمل وقيمة myWorkspaceId بمعرف مساحة العمل. يمكن العثور على هذه القيم في مساحة عمل Log Analytics في مدخل Microsoft Azure ضمن Advanced Settings. استبدل قيمة latestVersion بإصدار من إصدار ملحق Log Analytics Linux VM.

az vm extension set \
  --resource-group myResourceGroup \
  --vm-name myVM \
  --name OmsAgentForLinux \
  --publisher Microsoft.EnterpriseCloud.Monitoring \
  --protected-settings '{"workspaceKey":"myWorkspaceKey"}' \
  --settings '{"workspaceId":"myWorkspaceId","skipDockerProviderInstall": true}' \
  --version latestVersion

توزيع Azure PowerShell

يمكن استخدام Azure Powershell cmdlets لتوزيع ملحق جهاز ظاهري لعامل Log Analytics على جهاز ظاهري موجود. استبدل قيمة myWorkspaceKey أدناه بمفتاح مساحة العمل وقيمة myWorkspaceId بمعرف مساحة العمل. يمكن العثور على هذه القيم في مساحة عمل Log Analytics في مدخل Microsoft Azure ضمن Advanced Settings. استبدل قيمة latestVersion بإصدار من إصدار ملحق Log Analytics Linux VM.

Set-AzVMExtension \
  -ResourceGroupName myResourceGroup \
  -VMName myVM \
  -ExtensionName OmsAgentForLinux \
  -ExtensionType OmsAgentForLinux \
  -Publisher Microsoft.EnterpriseCloud.Monitoring \
  -TypeHandlerVersion latestVersion \
  -ProtectedSettingString '{"workspaceKey":"myWorkspaceKey"}' \
  -SettingString '{"workspaceId":"myWorkspaceId","skipDockerProviderInstall": true}'

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

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

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

az vm extension list --resource-group myResourceGroup --vm-name myVM -o table

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

/var/log/azure/Microsoft.EnterpriseCloud.Monitoring.OmsAgentForLinux/extension.log

لاسترداد إصدار ملحق OMS المُثبت على جهاز ظاهري، شغّل الأمر التالي إذا كنت تستخدم Azure CLI.

az vm extension show --resource-group myResourceGroup --vm-name myVM --instance-view

لاسترداد إصدار ملحق OMS المُثبت على جهاز ظاهري، شغّل الأمر التالي إذا كنت تستخدم Azure PowerShell.

Get-AzVMExtension -ResourceGroupName my_resource_group  -VMName my_vm_name -Name OmsAgentForLinux -Status

رموز الخطأ ومعانيها

رمز الخطأ	المعنى	الإجراء الممكن
9	تمكين يسمى قبل الأوان	قم بتحديث Azure Linux Agent إلى أحدث إصدار متوفر.
10	VM متصل بالفعل بمساحة عمل Log Analytics	لتوصيل الجهاز الظاهري بمساحة العمل المحددة في مخطط الملحق، اضبط stopOnMultipleConnections على false في الإعدادات العامة أو قم بإزالة هذه الخاصية. تتم فوترة جهاز VM هذا مرة واحدة لكل مساحة عمل متصلة بها.
11	تم توفير تكوين غير صالح للملحق	اتبع الأمثلة السابقة لمجموعة كل قيم الخصائص اللازمة للتوزيع.
17	فشل تثبيت حزمة Log Analytics
18	فشل تثبيت حزمة OMSConfig.	ابحث في مخرجات الأمر عن فشل الجذر.
19	فشل تثبيت حزمة OMI
20	فشل تثبيت حزمة SCX
33	خطأ في إنشاء metaconfiguration لـ omsconfig.	سجّل مشكلة GitHub مع التفاصيل من المخرجات.
51	هذا الملحق غير مدعوم في نظام عملية الجهاز الظاهري
52	فشل هذا الملحق بسبب فقدان التبعية أو الإذن	تفحص المخرجات والسجلات للحصول على مزيد من المعلومات حول التبعية أو الإذن المفقود.
53	فشل هذا الملحق بسبب معلمات التكوين المفقودة أو الخاطئة	تفحص الإخراج والسجلات لمزيد من المعلومات حول الخطأ الذي حدث. بالإضافة إلى ذلك، تحقق من صحة معرف مساحة العمل، وتحقق من اتصال الجهاز بالإنترنت.
55	لا يمكن الاتصال بخدمة Azure Monitor أو أن الحزم المطلوبة مفقودة أو أن مدير حزم dpkg مؤمَّن (تم قفله)	تحقق من أن النظام لديه وصول إلى الإنترنت، أو أنه تم توفير وكيل HTTP صالح. بالإضافة إلى ذلك، تحقق من صحة معرف مساحة العمل، وتحقق من تثبيت أدوات curl وtar.

يمكن العثور على معلومات إضافية حول استكشاف الأخطاء وإصلاحها في دليل استكشاف الأخطاء وإصلاحها لـ Log Analytics-Agent-for-Linux.

يدعم

إذا احتجت إلى مزيد من المساعدة بخصوص هذه المقالة في أي وقت، يمكنك الاتصال بخبراء Azure على منتديات MSDN Azure وStack Overflow. بدلاً من ذلك، يمكنك تقديم حدث دعم Azure. انتقل إلى موقع دعم Azure، وحدد Get support. للحصول على معلومات حول استخدام Azure Support، اقرأ الأسئلة المتداولة حول دعم Microsoft Azure.