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

  • مقالة
  • قراءة خلال 5 دقائق

نظرة عامة

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

ملاحظة

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

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

نظام التشغيل

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

إصدار عامل وVM Extension

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

إصدار ملحق Log Analytics Linux VM إصدار مجموعة Log Analytics Agent
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 للسحابة، فلا تقم بتشغيل الخطوات الواردة في هذا المستند. يؤدي القيام بذلك إلى الكتابة فوق مساحة العمل التي تم تكوينها وقطع الاتصال بـ 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.13",
    "autoUpgradeMinorVersion": true,
    "settings": {
      "workspaceId": "myWorkspaceId",
      "skipDockerProviderInstall": true
    },
    "protectedSettings": {
      "workspaceKey": "myWorkSpaceKey"
    }
  }
}

ملاحظة

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

قيم Property

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

توزيع القالب

ملاحظة

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

يمكن توزيع ملحقات Azure VM باستخدام قوالب 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.13",
    "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.13",
    "settings": {
      "workspaceId": "myWorkspaceId",
      "skipDockerProviderInstall": true
    },
    "protectedSettings": {
      "workspaceKey": "myWorkSpaceKey"
    }
  }
}

توزيع Azure CLI

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

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}'

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

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

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

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

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

/opt/microsoft/omsagent/bin/stdout

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

التعليمات البرمجية للأخطاء المعنى الإجراء الممكن
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، اقرأ الأسئلة المتداولة حول دعم Microsoft Azure.