Problemen met Hybrid Runbook Worker op basis van VM-extensies in Automation oplossen
Dit artikel bevat informatie over het oplossen en oplossen van problemen met Hybrid Runbook Workers op basis van azure Automation-extensies. Zie Problemen met Hybrid Runbook Worker op basis van agents in Automation oplossen voor het oplossen van problemen met werkrollen op basis van agents. Zie overzicht van Hybrid Runbook Worker voor algemene informatie.
Algemene controlelijst
Voor hulp bij het oplossen van problemen met hybrid runbook workers op basis van extensies:
Controleer of het besturingssysteem wordt ondersteund en of aan de vereisten is voldaan. Zie Vereisten.
Controleer of de door het systeem toegewezen beheerde identiteit is ingeschakeld op de virtuele machine. Azure-VM's en Azure-machines met Arc moeten worden ingeschakeld met een door het systeem toegewezen beheerde identiteit.
Controleer of de extensie is ingeschakeld met de juiste instellingen. Het instellen van een bestand moet juist
AutomationAccountURLzijn. Controleer de URL kruislings met de eigenschap Automation-account -AutomationHybridServiceUrl.- Voor Windows vindt u het instellingenbestand hier:
Tip
Vervang
*in het onderstaande pad door de specifieke versie die is geïnstalleerd als u dit weet.C:\Packages\Plugins\Microsoft.Azure.Automation.HybridWorker.HybridWorkerForWindows\*\RuntimeSettings- Voor Linux vindt u het instellingenbestand hier:
/var/lib/waagent/Microsoft.Azure.Automation.HybridWorker.HybridWorkerForLinux/
Controleer het foutbericht dat wordt weergegeven in de status van de Hybrid Worker-extensie/gedetailleerde status. Het bevat foutberichten en respectieve aanbevelingen om het probleem op te lossen.
Voer het hulpprogramma probleemoplosser uit op de virtuele machine en genereert een uitvoerbestand. Open het uitvoerbestand en controleer de fouten die zijn geïdentificeerd door het hulpprogramma probleemoplosser.
- Voor Windows vindt u de probleemoplosser hier:
Tip
Vervang
*in het onderstaande pad door de specifieke versie die is geïnstalleerd als u dit weet.C:\Packages\Plugins\Microsoft.Azure.Automation.HybridWorker.HybridWorkerForWindows\*\bin\troubleshooter\TroubleShootWindowsExtension.ps1- Voor Linux vindt u de probleemoplosser hier:
Tip
Vervang
*in het onderstaande pad door de specifieke versie die is geïnstalleerd als u dit weet./var/lib/waagent/Microsoft.Azure.Automation.HybridWorker.HybridWorkerForLinux-*/Troubleshooter/LinuxTroubleshooter.pyVoor Linux-machines maakt de Hybrid Worker-extensie een
hweautomationgebruiker en start de Hybrid Worker onder de gebruiker. Controleer of de gebruikerhweautomationis ingesteld met de juiste machtigingen. Als uw runbook toegang probeert te krijgen tot lokale resources, moet u ervoor zorgen dat hethweautomationde juiste machtigingen heeft voor de lokale resources.Controleer of het Hybrid Worker-proces wordt uitgevoerd.
- Voor Windows controleert u de
Hybrid Worker Serviceservice (HybridWorkerService). - Controleer de
hwdservice voor Linux.
- Voor Windows controleert u de
Logboeken verzamelen:
- Voer voor Windows het hulpprogramma logboekverzamelaar uit dat zich hier bevindt:
Tip
Vervang
*in het onderstaande pad door de specifieke versie die is geïnstalleerd als u dit weet.C:\Packages\Plugins\Microsoft.Azure.Automation.HybridWorker.HybridWorkerForWindows\*\bin\troubleshooter\PullLogs.ps1Logboeken bevinden zich hier:
C:\HybridWorkerExtensionLogs- Voor Linux: Logboeken bevinden zich in de volgende mappen:
en/var/log/azure/Microsoft.Azure.Automation.HybridWorker.HybridWorkerForLinux/home/hweautomation
Scenario: Runbooks gaan in een onderbroken status op een Hybrid Runbook Worker wanneer u een aangepast account op een server gebruikt waarvoor UAC (User Account Control) is ingeschakeld
Probleem
Taken mislukken en hebben een onderbroken status op de Hybrid Runbook Worker. In de Microsoft-SMA-gebeurtenislogboeken wordt aangegeven dat er een bijbehorende fout in het toepassingslogboek wordt weergegeven Win32 Process Exited with code [2148734720] wanneer het runbook probeert uit te voeren .NET Runtime version : 4.0.30319.0 , wat aangeeft dat de toepassing niet kan worden gestart.
Oorzaak
Wanneer een systeem UAC/LUA heeft, moeten machtigingen rechtstreeks worden verleend en niet via een groepslidmaatschap en wanneer de gebruiker machtigingen moet uitbreiden, mislukken de taken.
Oplossing
Werk de machtigingen in de volgende mappen bij voor aangepaste gebruikers in hybrid runbook Worker:
| Map | Machtigingen |
|---|---|
C:\ProgramData\AzureConnectedMachineAgent\Tokens |
Read |
C:\Packages\Plugins\Microsoft.Azure.Automation.HybridWorker.HybridWorkerForWindows |
Lezen en uitvoeren |
Scenario: De taak kan niet worden gestart omdat de Hybrid Worker niet beschikbaar was toen de geplande taak werd gestart
Probleem
De taak kan niet worden gestart op een Hybrid Worker en u ziet de volgende fout:
Kan niet starten, omdat hybrid worker niet beschikbaar was toen de geplande taak werd gestart, de hybrid worker voor het laatst actief was op mm/dd/jjjj.
Oorzaak
Deze fout kan worden veroorzaakt door de volgende redenen:
- De machines bestaan niet meer.
- De machine is uitgeschakeld en is onbereikbaar.
- De computer heeft een netwerkverbindingsprobleem.
- De Hybrid Runbook Worker-extensie is verwijderd van de computer.
Oplossing
- Zorg ervoor dat de machine bestaat en of de Hybrid Runbook Worker-extensie erop is geïnstalleerd. De Hybrid Worker moet in orde zijn en moet een heartbeat geven. Los eventuele netwerkproblemen op door de Gebeurtenislogboeken van Microsoft-SMA te controleren op de Workers in de Hybrid Runbook Worker-groep die deze taak probeerde uit te voeren.
- U kunt ook metrische gegevens van HybridWorkerPing bewaken die het aantal pings van een Hybrid Worker bieden en kunnen helpen bij het controleren van pinggerelateerde problemen.
Scenario: Taak is onderbroken omdat deze de taaklimiet voor een Hybrid Worker heeft overschreden
Probleem
De taak wordt onderbroken met het volgende foutbericht:
De taak is opgeschort omdat deze de taaklimiet voor een Hybrid Worker heeft overschreden. Voeg meer Hybrid Workers toe aan de Hybrid Worker-groep om dit probleem op te lossen.
Oorzaak
Taken kunnen om een van de volgende redenen worden opgeschort:
- Elke actieve Hybrid Worker in de groep vraagt elke 30 seconden na om te zien of er taken beschikbaar zijn. De werkrol kiest taken op basis van eerstkomer, eerste dienst. Afhankelijk van wanneer een taak is gepusht, wordt de taak eerst opgehaald door welke Hybrid Worker binnen de Hybrid Worker-groep de Automation-service pingt. Eén hybrid worker kan over het algemeen vier taken per ping ophalen (dat wil gezegd elke 30 seconden). Als het aantal pushtaken hoger is dan vier per 30 seconden en geen andere werkrol de taak ophaalt, wordt de taak mogelijk opgeschort.
- Hybrid Worker wordt mogelijk niet elke 30 seconden polling uitgevoerd zoals verwacht. Dit kan gebeuren als de werkrol niet in orde is of als er netwerkproblemen zijn.
Oplossing
- Als de taaklimiet voor een Hybrid Worker groter is dan vier taken per 30 seconden, kunt u meer Hybrid Workers toevoegen aan de Hybrid Worker-groep voor hoge beschikbaarheid en taakverdeling. U kunt ook taken plannen, zodat ze niet de limiet van vier taken per 30 seconden overschrijden. De verwerkingstijd van de takenwachtrij is afhankelijk van het Hardwareprofiel voor Hybrid Worker en de belasting. Zorg ervoor dat de Hybrid Worker in orde is en een heartbeat geeft.
- Los eventuele netwerkproblemen op door de Gebeurtenislogboeken van Microsoft-SMA te controleren op de Workers in de Hybrid Runbook Worker-groep die deze taak probeerde uit te voeren.
- U kunt ook de metrische gegevens hybridWorkerPing bewaken die het aantal pings van een Hybrid Worker bieden en kunnen helpen bij het controleren van pinggerelateerde problemen.
Scenario: Implementatie van Hybrid Worker mislukt met Private Link-fout
Probleem
U implementeert een Hybrid Runbook Worker op basis van extensies op een VIRTUELE machine en mislukt met de volgende fout: Verificatie is mislukt voor privékoppelingen.
Oorzaak
Het virtuele netwerk van de VIRTUELE machine verschilt van het privé-eindpunt van het Azure Automation-account of ze zijn niet verbonden.
Oplossing
Zorg ervoor dat het privé-eindpunt van het Azure Automation-account is verbonden met hetzelfde virtuele netwerk waarmee de VIRTUELE machine is verbonden. Volg de stappen in Planning op basis van uw netwerk om verbinding te maken met een privé-eindpunt. Stel ook openbare netwerktoegangsvlagmen in om een Automation-account te configureren om alle openbare configuratie te weigeren en alleen verbindingen via privé-eindpunten toe te staan. Zie DE DNS-configuratie voor meer informatie over het configureren van DNS-instellingen voor privé-eindpunten
Scenario: Implementatie van Hybrid Worker mislukt wanneer de opgegeven Hybrid Worker-groep niet bestaat
Probleem
U implementeert een Hybrid Runbook Worker op basis van extensies op een VIRTUELE machine en mislukt met de volgende fout: account/groep die is opgegeven, bestaat niet.
Oorzaak
De Hybrid Runbook Worker-groep waarnaar de Hybrid Worker moet worden geïmplementeerd, is al verwijderd.
Oplossing
Zorg ervoor dat u de Hybrid Runbook Worker-groep maakt en de virtuele machine toevoegt als een Hybrid Worker in die groep. Volg de stappen die worden vermeld in het maken van een Hybrid Runbook Worker-groep met behulp van Azure Portal.
Scenario: Hybrid Worker-implementatie mislukt wanneer door het systeem toegewezen beheerde identiteit niet is ingeschakeld op de VM
Probleem
U implementeert een Hybrid Runbook Worker op basis van extensies op een VIRTUELE machine en mislukt met de volgende fout:
Kan IMDS-identiteitseindpunt niet ophalen voor niet-Azure-VM's. Zorg ervoor dat de met Azure verbonden machineagent is geïnstalleerd en dat de door het systeem toegewezen identiteit is ingeschakeld.
Oorzaak
U implementeert de hybrid worker op basis van extensies op een niet-Azure-VM waarop geen met Arc verbonden machineagent is geïnstalleerd.
Oplossing
Op niet-Azure-machines moet de met Arc verbonden machineagent zijn geïnstalleerd voordat u deze implementeert als hybrid runbook worker op basis van extensies. Zie Hybride machines verbinden AzureConnectedMachineAgentmet Azure vanuit Azure Portal voor servers met Arc of Virtuele VMware-machines beheren met Azure Arc om gastbeheer in te schakelen voor virtuele VMware-VM's met Arc.
Scenario: Hybrid Worker-implementatie mislukt omdat de door het systeem toegewezen identiteit niet is ingeschakeld
Probleem
U implementeert een hybrid runbook worker op basis van extensies op een virtuele machine en mislukt met de volgende fout: Ongeldig autorisatietoken.
Oorzaak
Door de gebruiker toegewezen beheerde identiteit van de VIRTUELE machine is ingeschakeld, maar door het systeem toegewezen beheerde identiteit is niet ingeschakeld.
Oplossing
Volg de onderstaande stappen:
- Schakel door het systeem toegewezen beheerde identiteit van de virtuele machine in.
- Verwijder de Hybrid Worker-extensie die op de VIRTUELE machine is geïnstalleerd.
- Installeer de Hybrid Worker-extensie opnieuw op de virtuele machine.
Scenario: het installatieproces van de Hybrid Worker-extensie op windows-VM blijft hangen
Probleem
U hebt de Hybrid Worker-extensie geïnstalleerd op een Windows-VM vanuit de portal, maar u ontvangt geen melding dat het proces is voltooid.
Oorzaak
Soms kan het installatieproces vastlopen.
Oplossing
Volg de onderstaande stappen om de Hybrid Worker-extensie opnieuw te installeren:
Open de PowerShell-console.
Verwijder de registersleutel, indien aanwezig:
HKLM:\Software\Microsoft\Azure\HybridWorkerPowerShell-code voor het verwijderen van de registersleutel samen met eventuele subsleutels en waarden eronder.:
Get-Item HKLM:\Software\Microsoft\Azure\HybridWorker | Remove-Item -Recurse
Verwijder de registersleutel, indien aanwezig:
HKLM:\Software\Microsoft\HybridRunbookWorkerV2PowerShell-code voor het verwijderen van de registersleutel samen met eventuele subsleutels en waarden eronder.:
Get-Item HKLM:\Software\Microsoft\HybridRunbookWorkerV2 | Remove-Item -Recurse
Navigeer naar de installatiemap van de Hybrid Worker-extensie:
Tip
Vervang
*in de onderstaande opdracht door de specifieke versie die is geïnstalleerd als u dit weet.cd "C:\Packages\Plugins\Microsoft.Azure.Automation.HybridWorker.HybridWorkerForWindows\*"Installeer de Hybrid Worker-extensie:
.\bin\install.ps1Schakel de Hybrid Worker-extensie in:
.\bin\enable.ps1
Scenario: het verwijderingsproces van de Hybrid Worker-extensie op windows-VM blijft hangen
Probleem
U hebt een Hybrid Worker-extensie geïnstalleerd op een Virtuele Windows-machine vanuit de portal, maar u ontvangt geen melding dat het proces is voltooid.
Oorzaak
Soms kan het verwijderingsproces vastlopen.
Oplossing
Open de PowerShell-console.
Navigeer naar de installatiemap van de Hybrid Worker-extensie:
Tip
Vervang
*in de onderstaande opdracht door de specifieke versie die is geïnstalleerd als u dit weet.cd "C:\Packages\Plugins\Microsoft.Azure.Automation.HybridWorker.HybridWorkerForWindows\*"Schakel de Hybrid Worker-extensie uit:
.\bin\disable.cmdVerwijder de Hybrid Worker-extensie:
.\bin\uninstall.ps1Verwijder de registersleutel, indien aanwezig:
HKLM:\Software\Microsoft\Azure\HybridWorkerPowerShell-code voor het verwijderen van de registersleutel samen met eventuele subsleutels en waarden eronder.:
Get-Item HKLM:\Software\Microsoft\Azure\HybridWorker | Remove-Item -Recurse
Verwijder de registersleutel, indien aanwezig:
HKLM:\Software\Microsoft\HybridRunbookWorkerV2PowerShell-code voor het verwijderen van de registersleutel samen met eventuele subsleutels en waarden eronder.:
Get-Item HKLM:\Software\Microsoft\HybridRunbookWorkerV2 | Remove-Item -Recurse
Scenario: het installatieproces van de Hybrid Worker-extensie op linux-VM blijft hangen
Probleem
U hebt een Hybrid Worker-extensie geïnstalleerd op een Virtuele Linux-machine vanuit de portal, maar ontvangt geen melding dat het proces is voltooid.
Oorzaak
Soms kan het verwijderingsproces vastlopen.
Oplossing
Verwijder de
statemap:rm -r /home/hweautomation/stateNavigeer naar de installatiemap van de Hybrid Worker-extensie:
Tip
Vervang
*in de onderstaande opdracht door de specifieke versie die is geïnstalleerd als u dit weet.cd /var/lib/waagent/Microsoft.Azure.Automation.HybridWorker.HybridWorkerForLinux-*/Verwijder het mrseq-bestand:
rm mrseqInstalleer de Hybrid Worker-extensie:
./extension_shim.sh -c ./HWExtensionHandlers.py -iSchakel de Hybrid Worker-extensie in:
./extension_shim.sh -c ./HWExtensionHandlers.py -e
Scenario: het verwijderingsproces van de Hybrid Worker-extensie op linux-VM blijft hangen
Probleem
U hebt de Hybrid Worker-extensie verwijderd op een Linux-VM vanuit de portal, maar u ontvangt geen melding dat het proces is voltooid.
Oorzaak
Soms kan het verwijderingsproces vastlopen.
Oplossing
Volg de onderstaande stappen om de Hybrid Worker-extensie volledig te verwijderen:
- Navigeer naar de installatiemap van de Hybrid Worker-extensie:
Tip
Vervang
*in de onderstaande opdracht door de specifieke versie die is geïnstalleerd als u dit weet.cd /var/lib/waagent/Microsoft.Azure.Automation.HybridWorker.HybridWorkerForLinux-*/ - Schakel de Hybrid Worker-extensie uit:
./extension_shim.sh -c ./HWExtensionHandlers.py -d - Verwijder de Hybrid Worker-extensie:
./extension_shim.sh -c ./HWExtensionHandlers.py -u
Scenario: uitvoeren van runbook mislukt
Probleem
Uitvoeren van runbook mislukt en u ontvangt het volgende foutbericht:
The job action 'Activate' cannot be run, because the process stopped unexpectedly. The job action was attempted three times.
Uw runbook wordt kort na het uitvoeren van drie keer opgeschort. Er zijn voorwaarden waarmee het runbook niet kan worden voltooid. Het gerelateerde foutbericht bevat mogelijk geen aanvullende informatie.
Oorzaak
Mogelijke oorzaken zijn:
- De runbooks kunnen niet worden geverifieerd met lokale resources.
- De hybrid worker bevindt zich achter een proxy of firewall.
- De computer die is geconfigureerd voor het uitvoeren van Hybrid Runbook Worker voldoet niet aan de minimale hardwarevereisten.
Oplossing
Controleer of de computer uitgaande toegang heeft tot *.azure-automation.net op poort 443.
Computers waarop hybrid Runbook Worker wordt uitgevoerd, moeten voldoen aan de minimale hardwarevereisten voordat de werkrol is geconfigureerd voor het hosten van deze functie. Runbooks en het achtergrondproces dat ze gebruiken, kunnen ertoe leiden dat het systeem te veel wordt gebruikt en dat runbooktaak vertraging of time-outs veroorzaakt.
Controleer of de computer waarop de Hybrid Runbook Worker-functie moet worden uitgevoerd, voldoet aan de minimale hardwarevereisten. Als dit het geval is, controleert u het CPU- en geheugengebruik om een correlatie te bepalen tussen de prestaties van Hybrid Runbook Worker-processen en Windows. Elke geheugen- of CPU-druk kan duiden op de noodzaak om resources te upgraden. U kunt ook een andere rekenresource selecteren die ondersteuning biedt voor de minimale vereisten en schaal wanneer de workloadvereisten aangeven dat er een toename nodig is.
Controleer het Microsoft-SMA-gebeurtenislogboek op een bijbehorende gebeurtenis met de beschrijving Win32 Process Exited with code [4294967295]. De oorzaak van deze fout is dat u geen verificatie in uw runbooks hebt geconfigureerd of de Run As-referenties hebt opgegeven voor de Hybrid Runbook Worker-groep. Controleer runbookmachtigingen in Runbooks uitvoeren op een Hybrid Runbook Worker om te bevestigen dat u de verificatie voor uw runbooks correct hebt geconfigureerd.
Scenario: Er is geen certificaat gevonden in het certificaatarchief op de Hybrid Runbook Worker
Probleem
Een runbook dat wordt uitgevoerd op een Hybrid Runbook Worker mislukt met het volgende foutbericht:
Connect-AzAccount : No certificate was found in the certificate store with thumbprint 0000000000000000000000000000000000000000
At line:3 char:1
+ Connect-AzAccount -ServicePrincipal -Tenant $Conn.TenantID -Appl ...
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ CategoryInfo : CloseError: (:) [Connect-AzAccount],ArgumentException
+ FullyQualifiedErrorId : Microsoft.Azure.Commands.Profile.ConnectAzAccountCommand
Oorzaak
Deze fout treedt op wanneer u probeert een Uitvoeren als-account te gebruiken in een runbook dat wordt uitgevoerd op een Hybrid Runbook Worker waar het Uitvoeren als-accountcertificaat niet aanwezig is. Hybrid Runbook Workers hebben de certificaatasset standaard niet lokaal. Het Uitvoeren als-account vereist dat deze asset correct werkt.
Oplossing
Als uw Hybrid Runbook Worker een Virtuele Azure-machine is, kunt u in plaats daarvan runbookverificatie met beheerde identiteiten gebruiken. Dit scenario vereenvoudigt de verificatie doordat je je kunt verifiëren bij Azure-resources met behulp van de beheerde identiteit van de Azure-VM in plaats van het Uitvoeren als-account. Wanneer de Hybrid Runbook Worker een on-premises machine is, moet je het Uitvoeren als-accountcertificaat op de computer installeren. Zie de stappen voor het uitvoeren van het PowerShell-runbook Export-RunAsCertificateToHybridWorker in Runbooks op een Hybrid Runbook Worker voor meer informatie over het installeren van het certificaat.
Scenario: Virtuele Microsoft Azure-machines die automatisch zijn verwijderd uit een hybrid worker-groep
Probleem
Je kunt de Hybrid Runbook Worker of VM's niet zien wanneer de werkrolcomputer lange tijd is uitgeschakeld.
Oorzaak
De Hybrid Runbook Worker-machine heeft Azure Automation langer dan 30 dagen niet pingen. Daardoor heeft Automation de Hybrid Runbook Worker-groep of de System Worker-groep opgeschoond.
Oplossing
Start de werkmachine en registreer deze vervolgens opnieuw bij Azure Automation. Zie Een Windows Hybrid Runbook Worker implementeren voor instructies over het installeren van de runbookomgeving en verbinding maken met Azure Automation.
Volgende stappen
Als u het probleem hier niet ziet of als u het probleem niet kunt oplossen, kunt u een van de volgende kanalen proberen voor meer ondersteuning:
- Krijg antwoorden van Azure-experts via Azure-forums.
- Maak verbinding met @AzureSupport, het officiële Microsoft Azure-account voor het verbeteren van de klantervaring. Azure Support verbindt de Azure-community met antwoorden, ondersteuning en experts.
- Dien een ondersteuning voor Azure incident in. Ga naar de ondersteuning voor Azure site en selecteer Ondersteuning krijgen.