A Windows operációs rendszer (OS) Azure Monitor Agent hibaelhárítójának használata

Az Azure Monitor Agent (AMA) hibaelhárítóját úgy tervezték, hogy segítsen azonosítani az ügynökkel kapcsolatos problémákat, és általános állapotfelméréseket végezni. Különböző ellenőrzéseket végezhet annak érdekében, hogy az ügynök megfelelően legyen telepítve és csatlakoztatva legyen, valamint AMA-hoz kapcsolódó naplókat is gyűjthet a diagnosztizált gépről.

Feljegyzés

A Windows AMA hibaelhárító egy parancssori végrehajthatóság, amelyet az ügynök az 1.12.0.0-nál újabb verziókhoz szállít.

Előfeltételek

Hibaelhárító meglétének ellenőrzése

Ellenőrizze, hogy létezik-e az AMA-ügynök hibaelhárító könyvtára a számítógépen, hogy diagnosztizálni lehessen az ügynök hibaelhárítójának telepítését:

AMA-bővítmény – PowerShell

Az ügynök hibaelhárítójának jelenlétének ellenőrzéséhez másolja ki a következő parancsot, és futtassa a PowerShellben rendszergazdaként:

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

Ha a könyvtár létezik, a Test-Path parancsmag ad vissza True.

AMA-bővítmény – parancssor

Az ügynök hibaelhárítójának jelenlétének ellenőrzéséhez másolja ki a következő parancsot, és futtassa a parancssorban rendszergazdaként:

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

Ha a könyvtár létezik, a cd-parancs sikeresen módosítja a könyvtárakat.

Önálló AMA – PowerShell

Az ügynök hibaelhárítójának jelenlétének ellenőrzéséhez másolja ki a következő parancsot, és futtassa a PowerShellben rendszergazdaként:

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

Ha a könyvtár létezik, a Test-Path parancsmag ad vissza True.

Önálló AMA – parancssor

Az ügynök hibaelhárítójának jelenlétének ellenőrzéséhez másolja ki a következő parancsot, és futtassa a parancssorban rendszergazdaként:

Feljegyzés

Ha testre szabta az AMAInstallPathot, az alábbi elérési utat az egyéni elérési úthoz kell igazítania.

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

Ha a könyvtár létezik, a cd-parancs sikeresen módosítja a könyvtárakat.

Ha a címtár nem létezik, vagy a telepítés sikertelen, kövesse az alapszintű hibaelhárítási lépéseket.

Igen, a könyvtár létezik. Folytassa a hibaelhárító futtatásával.

A hibaelhárító futtatása

A diagnosztizálni kívánt gépen futtassa az ügynök hibaelhárítóját.

AMA-bővítmény – PowerShell

Az ügynök hibaelhárítójának elindításához másolja ki a következő parancsot, és futtassa a PowerShellben rendszergazdaként:

$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

Olyan tevékenységek sorozatát futtatja, amelyek végrehajtása akár 15 percet is igénybe vehet. Legyen türelmes, amíg a folyamat befejeződik.

AMA-bővítmény – parancssor

Az ügynök hibaelhárítójának elindításához másolja ki a következő parancsot, és futtassa a parancssorban rendszergazdaként:

Feljegyzés

Megjegyzés: A telepített verziószámnak megfelelően frissítenie kell a(z) {version} verziót. Az alábbi példában a verzió 1.20.0.0.

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

Olyan tevékenységek sorozatát futtatja, amelyek végrehajtása akár 15 percet is igénybe vehet. Legyen türelmes, amíg a folyamat befejeződik.

Önálló AMA – PowerShell

Az ügynök hibaelhárítójának elindításához másolja ki a következő parancsot, és futtassa a PowerShellben rendszergazdaként:

$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

Olyan tevékenységek sorozatát futtatja, amelyek végrehajtása akár 15 percet is igénybe vehet. Legyen türelmes, amíg a folyamat befejeződik.

Önálló AMA – parancssor

Az ügynök hibaelhárítójának elindításához másolja ki a következő parancsot, és futtassa a parancssorban rendszergazdaként:

Feljegyzés

Ha testre szabta az AMAInstallPathot, az alábbi elérési utat az egyéni elérési úthoz kell igazítania.

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

Olyan tevékenységek sorozatát futtatja, amelyek végrehajtása akár 15 percet is igénybe vehet. Legyen türelmes, amíg a folyamat befejeződik.

A naplófájl abban a könyvtárban jön létre, amelyben a AgentTroubleshooter.exe található.

Példa a bővítményalapú telepítésre:

Példa önálló telepítésre:

Gyakori kérdések

Átmásolhatom a hibaelhárítót egy újabb ügynökből egy régebbi ügynökbe, és futtathatom a régebbi ügynökön a régebbi ügynökkel kapcsolatos problémák diagnosztizálásához?

A hibaelhárító nem használható az ügynök egy régebbi verziójának diagnosztizálására másolással. A hibaelhárító megfelelő működéséhez az ügynök naprakész verziójával kell rendelkeznie.

Következő lépések

• Hibaelhárítási útmutató az Azure Monitor-ügynökhöz Windows rendszerű virtuális gépeken és méretezési csoportokban
• Hibaelhárítási útmutató az Azure Monitor-ügynökhöz Windows Arc-kompatibilis kiszolgálón