كيفية استخدام مستكشف أخطاء عامل Azure Monitor ومصلحها لنظام التشغيل Windows (OS)

تم تصميم مستكشف أخطاء عامل Azure Monitor (AMA) ومصلحها للمساعدة في تحديد المشكلات مع العامل وإجراء تقييمات السلامة العامة. يمكنه إجراء فحوصات مختلفة للتأكد من تثبيت العامل وتوصيله بشكل صحيح، ويمكنه أيضا جمع السجلات المتعلقة ب AMA من الجهاز الذي يتم تشخيصه.

إشعار

مستكشف أخطاء Windows AMA ومصلحها هو سطر أوامر قابل للتنفيذ يتم شحنه مع العامل لجميع الإصدارات الأحدث من 1.12.0.0.

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

التحقق من وجود مستكشف الأخطاء ومصلحها

تحقق من وجود دليل مستكشف أخطاء عامل AMA ومصلحها على الجهاز ليتم تشخيصه لتأكيد تثبيت مستكشف أخطاء العامل ومصلحها:

ملحق AMA - PowerShell

للتحقق من وجود مستكشف أخطاء العامل ومصلحها، انسخ الأمر التالي وقم بتشغيله في PowerShell كمسؤول:

Test-Path -Path "C:/Packages/Plugins/Microsoft.Azure.Monitor.AzureMonitorWindowsAgent"

إذا كان الدليل موجودا، يقوم الأمر cmdlet Test-Path بإرجاع True.

ملحق AMA - موجه الأوامر

للتحقق من وجود مستكشف أخطاء العامل ومصلحها، انسخ الأمر التالي وقم بتشغيله في موجه الأوامر كمسؤول:

cd "C:/Packages/Plugins/Microsoft.Azure.Monitor.AzureMonitorWindowsAgent"

إذا كان الدليل موجودا، يقوم الأمر cd بتغيير الدلائل بنجاح.

AMA المستقل - PowerShell

للتحقق من وجود مستكشف أخطاء العامل ومصلحها، انسخ الأمر التالي وقم بتشغيله في PowerShell كمسؤول:

$installPath = (Get-ItemProperty -Path "Registry::HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\AzureMonitorAgent").AMAInstallPath
Test-Path -Path $installPath\Troubleshooter

إذا كان الدليل موجودا، يقوم الأمر cmdlet Test-Path بإرجاع True.

AMA مستقل - موجه الأوامر

للتحقق من وجود مستكشف أخطاء العامل ومصلحها، انسخ الأمر التالي وقم بتشغيله في موجه الأوامر كمسؤول:

إشعار

إذا قمت بتخصيص AMAInstallPath، فستحتاج إلى ضبط المسار أدناه إلى المسار المخصص.

cd "C:\Program Files\Azure Monitor Agent\Troubleshooter"

إذا كان الدليل موجودا، يقوم الأمر cd بتغيير الدلائل بنجاح.

إذا لم يكن الدليل موجودا أو فشل التثبيت، فاتبع خطوات استكشاف الأخطاء وإصلاحها الأساسية.

نعم، الدليل موجود. تابع إلى تشغيل مستكشف الأخطاء ومصلحها.

تشغيل مستكشف الأخطاء ومصلحها

على الجهاز المراد تشخيصه، قم بتشغيل مستكشف أخطاء العامل ومصلحها.

ملحق AMA - PowerShell

لبدء تشغيل مستكشف أخطاء العامل ومصلحها، انسخ الأمر التالي وقم بتشغيله في PowerShell كمسؤول:

$currentVersion = ((Get-ChildItem -Path "Registry::HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows Azure\HandlerState\" `
    | where Name -like "*AzureMonitorWindowsAgent*" `
    | ForEach-Object {$_ | Get-ItemProperty} `
    | where InstallState -eq "Enabled").PSChildName -split('_'))[1]

$troubleshooterPath = "C:\Packages\Plugins\Microsoft.Azure.Monitor.AzureMonitorWindowsAgent\$currentVersion\Troubleshooter"
Set-Location -Path $troubleshooterPath
Start-Process -FilePath $troubleshooterPath\AgentTroubleshooter.exe -ArgumentList "--ama"
Invoke-Item $troubleshooterPath

يدير سلسلة من الأنشطة التي قد تستغرق ما يصل إلى 15 دقيقة لإكمالها. كن صبورا حتى تكتمل العملية.

ملحق AMA - موجه الأوامر

لبدء تشغيل مستكشف أخطاء العامل ومصلحها، انسخ الأمر التالي وقم بتشغيله في موجه الأوامر كمسؤول:

إشعار

ملاحظة: ستحتاج إلى تحديث {version} لمطابقة رقم الإصدار المثبت. في المثال التالي، الإصدار هو 1.20.0.0.

cd C:/Packages/Plugins/Microsoft.Azure.Monitor.AzureMonitorWindowsAgent/{version}/Troubleshooter/
AgentTroubleshooter.exe --ama

يدير سلسلة من الأنشطة التي قد تستغرق ما يصل إلى 15 دقيقة لإكمالها. كن صبورا حتى تكتمل هذه العملية.

AMA المستقل - PowerShell

لبدء تشغيل مستكشف أخطاء العامل ومصلحها، انسخ الأمر التالي وقم بتشغيله في PowerShell كمسؤول:

$installPath = (Get-ItemProperty -Path "Registry::HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\AzureMonitorAgent").AMAInstallPath
Set-Location -Path $installPath\Troubleshooter
Start-Process -FilePath $installPath\Troubleshooter\AgentTroubleshooter.exe -ArgumentList "--ama"
Invoke-Item $installPath\Troubleshooter

يدير سلسلة من الأنشطة التي قد تستغرق ما يصل إلى 15 دقيقة لإكمالها. كن صبورا حتى تكتمل العملية.

AMA مستقل - موجه الأوامر

لبدء تشغيل مستكشف أخطاء العامل ومصلحها، انسخ الأمر التالي وقم بتشغيله في موجه الأوامر كمسؤول:

إشعار

إذا قمت بتخصيص AMAInstallPath، فستحتاج إلى ضبط المسار أدناه إلى المسار المخصص.

cd "C:\Program Files\Azure Monitor Agent\Troubleshooter"
AgentTroubleshooter.exe --ama

يدير سلسلة من الأنشطة التي قد تستغرق ما يصل إلى 15 دقيقة لإكمالها. كن صبورا حتى تكتمل هذه العملية.

يتم إنشاء ملف السجل في الدليل حيث يوجد AgentTroubleshooter.exe.

مثال على التثبيت المستند إلى الملحق:

مثال على التثبيت المستقل:

الأسئلة المتداولة

هل يمكنني نسخ مستكشف الأخطاء ومصلحها من عامل أحدث إلى عامل أقدم وتشغيله على العامل الأقدم لتشخيص المشكلات مع العامل الأقدم؟

لا يمكن استخدام مستكشف الأخطاء ومصلحها لتشخيص إصدار أقدم من العامل عن طريق نسخه. يجب أن يكون لديك إصدار محدث من العامل حتى يعمل مستكشف الأخطاء ومصلحها بشكل صحيح.

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

• إرشادات استكشاف الأخطاء وإصلاحها لعامل Azure Monitor على أجهزة Windows الظاهرية ومجموعات المقياس
• إرشادات استكشاف الأخطاء وإصلاحها لعامل Azure Monitor على الخادم الذي يدعم Windows Arc