Partager via

Résoudre les problèmes de Runbook Worker hybride basés sur une extension de machine virtuelle dans Automation

  • Article

Cet article fournit des informations sur la détection et la résolution de problèmes liés aux Runbook Workers hybrides basés sur une extension d’Azure Automation. Pour la résolution des problèmes des Workers basés sur un agent, consultez Résoudre les problèmes de Runbook Workers hybrides basés sur un agent dans Automation. Pour obtenir des informations générales, consultez Vue d’ensemble des Runbook Worker hybrides.

Liste de contrôle générale

Pour aider à résoudre les problèmes liés aux Runbook Workers hybrides basés sur une extension :

  • Vérifiez que le système d’exploitation est pris en charge et que les prérequis ont été satisfaits. Consultez les Conditions préalables.

  • Vérifiez si l’identité managée affectée par le système est activée sur la machine virtuelle. Les machines virtuelles Azure et les machines Azure compatibles avec Arc doivent être activées avec une identité managée affectée par le système.

  • Vérifiez si l’extension est activée avec les paramètres appropriés. Le fichier de paramètres doit avoir la valeur AutomationAccountURL appropriée. Effectuez une vérification croisée de l’URL avec la propriété du compte Automation - AutomationHybridServiceUrl. 

    • Pour Windows, vous trouverez le fichier de paramètres ici :

    Conseil

    Remplacez * dans le chemin d’accès ci-dessous par la version spécifique installée, si vous la connaissez.

    C:\Packages\Plugins\Microsoft.Azure.Automation.HybridWorker.HybridWorkerForWindows\*\RuntimeSettings
    • Pour Linux : vous trouverez le fichier de paramètres ici : 
      /var/lib/waagent/Microsoft.Azure.Automation.HybridWorker.HybridWorkerForLinux/

  • Vérifiez le message d’erreur indiqué dans l’état de l’extension Worker hybride/état détaillé. Il contient le(s) message(s) d’erreur et les recommandations respectives pour résoudre le problème.

  • Exécutez l’outil de dépannage sur la machine virtuelle afin qu’il génère un fichier de sortie. Ouvrez le fichier de sortie et vérifiez les erreurs identifiées par l’outil de résolution des problèmes.

    • Pour Windows : vous trouverez l’utilitaire de résolution des problèmes ici :

    Conseil

    Remplacez * dans le chemin d’accès ci-dessous par la version spécifique installée, si vous la connaissez.

    C:\Packages\Plugins\Microsoft.Azure.Automation.HybridWorker.HybridWorkerForWindows\*\bin\troubleshooter\TroubleShootWindowsExtension.ps1
    • Pour Linux, vous trouverez l’utilitaire de résolution des problèmes ici :

    Conseil

    Remplacez * dans le chemin d’accès ci-dessous par la version spécifique installée, si vous la connaissez.

    /var/lib/waagent/Microsoft.Azure.Automation.HybridWorker.HybridWorkerForLinux-*/Troubleshooter/LinuxTroubleshooter.py

  • Pour les machines Linux, l’extension de Worker hybride crée un utilisateur hweautomation et démarre le Worker hybride sous l’utilisateur. Vérifiez que l’utilisateur hweautomation est configuré avec les autorisations appropriées. Si votre runbook tente d’accéder à des ressources locales, assurez-vous que le hweautomation dispose des autorisations appropriées pour les ressources locales.

  • Vérifiez si le processus Worker hybride est en cours d’exécution.

    • Pour Windows, vérifiez le service Hybrid Worker Service (HybridWorkerService).
    • Pour Linux, vérifiez le service hwd.

  • Collecter les journaux :

    • Pour Windows, exécutez l’outil collecteur de journaux situé ici :

    Conseil

    Remplacez * dans le chemin d’accès ci-dessous par la version spécifique installée, si vous la connaissez.

    C:\Packages\Plugins\Microsoft.Azure.Automation.HybridWorker.HybridWorkerForWindows\*\bin\troubleshooter\PullLogs.ps1

    Les journaux se trouvent ici :

    C:\HybridWorkerExtensionLogs
    • Pour Linux : les journaux se trouvent dans les dossiers suivants : 
      /var/log/azure/Microsoft.Azure.Automation.HybridWorker.HybridWorkerForLinux
      et 
      /home/hweautomation

Scénario : Les runbooks passent dans un état suspendu sur un Runbook Worker hybride lors de l’utilisation d’un compte personnalisé sur un serveur avec le contrôle de compte d’utilisateur (UAC) activé

Problème

Les travaux échouent et passent en état de suspension sur le Runbook Worker hybride. Les journaux des événements Microsoft-SMA indiquent Win32 Process Exited with code [2148734720] et une erreur correspondante dans le journal d’application lorsque le runbook tente de s’exécuter est .NET Runtime version : 4.0.30319.0, ce qui indique que l’application n’a pas pu être démarrée.

Cause

Lorsqu’un système dispose d’un système UAC/LUA, les autorisations doivent être accordées directement et non via l’appartenance à un groupe, et lorsque l’utilisateur doit élever ses autorisations, les travaux commencent à échouer.

Résolution

Pour l’utilisateur Personnalisé sur le Runbook Worker Hybride, mettez à jour les autorisations dans les dossiers suivants :

Dossier Autorisations
C:\ProgramData\AzureConnectedMachineAgent\Tokens Lire
C:\Packages\Plugins\Microsoft.Azure.Automation.HybridWorker.HybridWorkerForWindows Lecture et exécution

Scénario : La tâche n’a pas démarré car le Worker hybride n’était pas disponible lorsque la tâche planifiée a démarré

Problème

Le travail ne démarre pas sur un Worker hybride et l’erreur suivante s’affiche :

Échec du démarrage, car le worker hybride n’était pas disponible au moment du démarrage de la tâche programmée, le worker hybride était actif pour la dernière fois le jj/mm/aaaa.

Cause

Cette erreur peut se produire pour les raisons suivantes :

  • Les machines n’existent plus.
  • La machine est éteinte et injoignable.
  • La machine a un problème de connectivité réseau.
  • L’extension Runbook Worker hybride a été désinstallée de la machine.

Résolution

  • Vérifiez que la machine existe et que l’extension Runbook Worker hybride est installée sur celle-ci. Le Worker hybride doit être sain et doit donner une pulsation. Résolvez les problèmes réseau en vérifiant les journaux des événements Microsoft-SMA sur les Workers dans le groupe de Runbooks Workers hybrides qui a essayé d’exécuter ce travail.
  • Vous pouvez également superviser la métrique HybridWorkerPing qui fournit le nombre de tests ping à partir d’un Worker hybride et peut vous aider à vérifier les problèmes liés au test ping.

Scénario : Le travail a été suspendu car il a dépassé la limite de travail d’un Worker hybride

Problème

Le travail est suspendu avec le message d’erreur suivant :

Le travail a été suspendu, car il a dépassé la limite de travail d’un Worker hybride. Ajoutez d’autres Workers hybrides au groupe de Workers hybrides pour surmonter ce problème.

Cause

Les travaux peuvent être suspendus pour l’une des raisons suivantes :

  • Chaque Worker hybride actif du groupe interroge les travaux toutes les 30 secondes pour voir si des travaux sont disponibles. Le Worker choisit les travaux selon le principe du premier arrivé, premier servi. Selon le moment où un travail a été envoyé, le Worker hybride du groupe de Workers hybrides, quel qu’il soit, qui effectue un test ping sur le service Automation récupère le travail en premier. Un seul worker hybride peut généralement récupérer quatre travaux par test Ping (c’est-à-dire, toutes les 30 secondes). Si votre taux d’envoi de travaux est supérieur à quatre toutes les 30 secondes et qu’aucun autre Worker ne récupère le travail, il se peut que celui-ci soit suspendu.
  • Le Worker hybride peut ne pas interroger comme prévu toutes les 30 secondes. Cela peut se produire si le Worker n’est pas sain ou s’il existe des problèmes réseau.

Résolution

  • Si la limite de travail pour un Worker hybride dépasse quatre travaux toutes les 30 secondes, vous pouvez ajouter d’autres Workers hybrides au groupe de Workers hybrides à des fins de haute disponibilité et d’équilibrage de charge. Vous pouvez également planifier les travaux afin qu’ils ne dépassent pas la limite de quatre travaux toutes les 30 secondes. Le temps de traitement de la file d’attente des travaux varie selon la charge et le profil matériel du Worker hybride. Vérifiez que le Worker hybride est sain et donne une pulsation.
  • Résolvez les problèmes réseau en vérifiant les journaux des événements Microsoft-SMA sur les Workers dans le groupe de Runbooks Workers hybrides qui a essayé d’exécuter ce travail.
  • Vous pouvez également surveiller la métrique HybridWorkerPing qui fournit le nombre de tests ping à partir d’un Worker hybride et peut vous aider à vérifier les problèmes liés au test ping.

Problème

Vous déployez un Runbook Worker hybride basé sur une extension sur une machine virtuelle et il échoue avec l’erreur : Échec de l’authentification pour les liaisons privées.

Cause

Le réseau virtuel de la machine virtuelle est différent du point de terminaison privé de Azure Automation compte, ou ils ne sont pas connectés.

Résolution

Vérifiez que le point de terminaison privé de Azure Automation compte est connecté au même Réseau virtuel auquel la machine virtuelle est connectée. Suivez les étapes mentionnées dans Planification basée sur votre réseau pour vous connecter à un point de terminaison privé. Définissez également des indicateurs d’accès au réseau public pour configurer un compte Automation afin de refuser toute configuration publique et d’autoriser uniquement les connexions via des points de terminaison privés. Pour plus d’informations sur la configuration des paramètres DNS pour les points de terminaison privés, consultez Configuration DNS

Scénario : Le déploiement de Worker hybride échoue lorsque le groupe Worker hybride fourni n’existe pas

Problème

Vous déployez un Runbook Worker hybride basé sur une extension sur une machine virtuelle et il échoue avec l’erreur : Le compte/groupe spécifié n’existe pas.

Cause

Le groupe Runbook Worker hybride dans lequel le Worker hybride doit être déployé est déjà supprimé.

Résolution

Veillez à créer le groupe Runbook Worker hybride et à ajouter la machine virtuelle en tant que Worker hybride dans ce groupe. Suivez les étapes mentionnées dans créer un groupe Runbook Worker hybride à l’aide du Portail Azure.

Scénario : Échec du déploiement de Worker hybride lorsque l’identité managée affectée par le système n’est pas activée sur la machine virtuelle

Problème

Vous déployez un Runbook Worker hybride basé sur une extension sur une machine virtuelle et il échoue avec une erreur :
Impossible de récupérer le point de terminaison d’identité IMDS pour une machine virtuelle non Azure. Vérifiez que l’agent d’ordinateur connecté Azure est installé et que l’identité affectée par le système est activée.

Cause

Vous déployez le Worker hybride basé sur une extension sur une machine virtuelle non Azure sur laquelle l’agent d’ordinateur connecté Arc n’est pas installé.

Résolution

L’agent d’ordinateur connecté Arc doit être installé sur les machines non Azure avant de le déployer en tant que Runbook Worker hybride basé sur une extension. Pour installer le AzureConnectedMachineAgent, voir connecter les machines hybrides à Azure depuis le portail Azure pour les serveurs compatibles avec Arc ou Gérer les machines virtuelles VMware Azure Arc pour activer la gestion des invités pour les VMware compatibles avec Arc.

Scénario : Échec du déploiement de Worker hybride en raison de l’identité affectée par le système non activée

Problème

Vous déployez un Runbook Worker hybride basé sur une extension sur une machine virtuelle et il échoue avec l’erreur : Jeton d’autorisation non valide.

Cause

L’identité managée attribuée à l’utilisateur de la machine virtuelle est activée, mais l’identité managée attribuée au système ne l’est pas.

Résolution

Suivez les étapes détaillées ci-dessous :

  1. Activer Identité managée affectée par le système de la machine virtuelle.
  2. Supprimez l’extension Worker hybride installée sur la machine virtuelle.
  3. Réinstallez l’extension Worker hybride sur la machine virtuelle.

Scénario : le processus d’installation de l’extension Worker hybride sur une machine virtuelle Windows est bloqué

Problème

Vous avez installé l’extension Worker hybride sur une machine virtuelle Windows à partir du portail, mais vous ne recevez pas de notification indiquant que le processus s’est terminé avec succès.

Cause

Parfois, le processus d’installation peut être bloqué.

Résolution

Suivez les étapes mentionnées ci-dessous pour installer à nouveau l’extension Worker hybride :

  1. Ouvrez la console PowerShell.

  2. Supprimez la clé de Registre, le cas échéant :HKLM:\Software\Microsoft\Azure\HybridWorker

    1. Code PowerShell pour supprimer la clé de Registre, ainsi que toutes les sous-clés et les valeurs qu’elles contiennent :

      Get-Item HKLM:\Software\Microsoft\Azure\HybridWorker | Remove-Item -Recurse

  3. Supprimez la clé de Registre, le cas échéant :HKLM:\Software\Microsoft\HybridRunbookWorkerV2

    1. Code PowerShell pour supprimer la clé de Registre, ainsi que toutes les sous-clés et les valeurs qu’elles contiennent :

      Get-Item HKLM:\Software\Microsoft\HybridRunbookWorkerV2 | Remove-Item -Recurse

  4. Accédez au dossier d’installation de l’extension Worker hybride :

    Conseil

    Remplacez * dans la commande ci-dessous par la version spécifique installée, si vous la connaissez.

    cd "C:\Packages\Plugins\Microsoft.Azure.Automation.HybridWorker.HybridWorkerForWindows\*"

  5. Installez l’extension Worker hybride :

    .\bin\install.ps1

  6. Activez l’extension Worker hybride :

    .\bin\enable.ps1

Scénario : Le processus de désinstallation de l’extension Worker hybride sur une machine virtuelle Windows est bloqué

Problème

Vous avez installé une extension Worker hybride sur une machine virtuelle Windows à partir du portail, mais vous ne recevez pas de notification indiquant que le processus s’est terminé avec succès.

Cause

Parfois, le processus de désinstallation peut être bloqué.

Résolution

  1. Ouvrez la console PowerShell.

  2. Accédez au dossier d’installation de l’extension Worker hybride :

    Conseil

    Remplacez * dans la commande ci-dessous par la version spécifique installée, si vous la connaissez.

    cd "C:\Packages\Plugins\Microsoft.Azure.Automation.HybridWorker.HybridWorkerForWindows\*"

  3. Désactivez l’extension Worker hybride :

    .\bin\disable.cmd

  4. Désinstallez l’extension Worker hybride :

    .\bin\uninstall.ps1

  5. Supprimez la clé de Registre, le cas échéant :HKLM:\Software\Microsoft\Azure\HybridWorker

    1. Code PowerShell pour supprimer la clé de Registre, ainsi que toutes les sous-clés et les valeurs qu’elles contiennent :

      Get-Item HKLM:\Software\Microsoft\Azure\HybridWorker | Remove-Item -Recurse

  6. Supprimez la clé de Registre, le cas échéant :HKLM:\Software\Microsoft\HybridRunbookWorkerV2

    1. Code PowerShell pour supprimer la clé de Registre, ainsi que toutes les sous-clés et les valeurs qu’elles contiennent :

      Get-Item HKLM:\Software\Microsoft\HybridRunbookWorkerV2 | Remove-Item -Recurse

Scénario : le processus d’installation de l’extension Worker hybride sur une machine virtuelle Linux est bloqué

Problème

Vous avez installé une extension Worker hybride sur une machine virtuelle Linux à partir du portail, mais vous ne recevez pas de notification indiquant que le processus s’est terminé avec succès.

Cause

Parfois, le processus de désinstallation peut être bloqué.

Résolution

  1. Supprimez le dossier state :

    rm -r /home/hweautomation/state

  2. Accédez au dossier d’installation de l’extension Worker hybride :

    Conseil

    Remplacez * dans la commande ci-dessous par la version spécifique installée, si vous la connaissez.

    cd /var/lib/waagent/Microsoft.Azure.Automation.HybridWorker.HybridWorkerForLinux-*/

  3. Supprimez le fichier mrseq :

    rm mrseq

  4. Installez l’extension Worker hybride :

    ./extension_shim.sh -c ./HWExtensionHandlers.py -i

  5. Activez l’extension Worker hybride :

    ./extension_shim.sh -c ./HWExtensionHandlers.py -e

Scénario : le processus de désinstallation de l’extension Worker hybride sur une machine virtuelle Linux est bloqué

Problème

Vous avez désinstallé l’extension Worker hybride sur une machine virtuelle Linux à partir du portail, mais vous n’obtenez pas de notification indiquant que le processus s’est terminé avec succès.

Cause

Parfois, le processus de désinstallation peut être bloqué.

Résolution

Suivez les étapes mentionnées ci-dessous pour désinstaller complètement l’extension Worker hybride :

  1. Accédez au dossier d’installation de l’extension Worker hybride :

    Conseil

    Remplacez * dans la commande ci-dessous par la version spécifique installée, si vous la connaissez.

    cd /var/lib/waagent/Microsoft.Azure.Automation.HybridWorker.HybridWorkerForLinux-*/
  2. Désactivez l’extension Worker hybride : 
    ./extension_shim.sh -c ./HWExtensionHandlers.py -d
  3. Désinstallez l’extension Worker hybride : 
    ./extension_shim.sh -c ./HWExtensionHandlers.py -u

Scénario : Échec de l’exécution d’un Runbook

Problème

L’exécution du runbook échoue et vous recevez le message d’erreur ci-après :

The job action 'Activate' cannot be run, because the process stopped unexpectedly. The job action was attempted three times.

Le runbook est interrompu peu après sa tentative d’exécution à trois reprises. Certaines conditions peuvent interrompre la bonne exécution du runbook. Le message d’erreur associé peut ne pas inclure d’informations supplémentaires.

Cause

Les causes possibles sont les suivantes :

  • Les runbooks ne peuvent pas s’authentifier auprès des ressources locales.
  • Le worker hybride est derrière un pare-feu ou un proxy.
  • L’ordinateur configuré pour exécuter le Runbook Worker hybride ne satisfait pas à la configuration matérielle minimale requise.

Résolution

Vérifiez que l’ordinateur dispose d’un accès sortant à *.azure-automation.net sur le port 443.

Les ordinateurs qui exécutent les Runbooks Worker hybrides doivent respecter la configuration matérielle minimale requise pour pouvoir héberger cette fonctionnalité. Les runbooks et le processus d’arrière-plan qu’ils utilisent peuvent entraîner la sur-utilisation du système et des retards ou expirations de travaux de runbooks.

Vérifiez que l’ordinateur qui exécute la fonctionnalité Runbook Worker hybride possède la configuration matérielle minimale requise. Si c’est le cas, surveillez l’utilisation du processeur et de la mémoire pour déterminer toute corrélation entre les performances des processus Runbook Worker hybride et Windows. Toute pression sur la mémoire ou les ressources processeur peut indiquer la nécessité de mettre à niveau des ressources. Vous pouvez également sélectionner une ressource de calcul différente qui prend en charge la configuration minimale requise et effectuer une mise à l’échelle lorsque les demandes en matière de charge de travail indiquent qu’une augmentation est nécessaire.

Vérifiez dans le journal des événements Microsoft-SMA la présence d’un événement correspondant à la description Win32 Process Exited with code [4294967295]. La cause de cette erreur est que vous n’avez pas configuré l’authentification dans vos runbooks ou que vous n’avez pas spécifié les informations de connexion du compte d’identification du groupe Runbook Worker hybride. Consultez les autorisations du runbook dans la section Exécution de runbooks sur un Runbook Worker hybride pour vérifier que l’authentification a été correctement configurée pour vos runbooks.

Scénario : Aucun certificat n’a été trouvé dans le magasin de certificats sur le Runbook Worker hybride

Problème

Un runbook en cours d’exécution sur un Runbook Worker hybride échoue avec le message d’erreur suivant :

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

Cause

Cette erreur se produit lorsque vous essayez d’utiliser un compte d’identification dans un runbook qui s’exécute sur un Runbook Worker hybride où le certificat de compte d’identification n’est pas présent. Les Runbook Worker hybrides n’ont pas la ressource de certificat locale par défaut. Le compte d’identification exige que cette ressource fonctionne correctement.

Résolution

Si votre Runbook Worker hybride est une machine virtuelle Azure, vous pouvez utiliser une authentification de runbook avec des identités managées à la place. Ce scénario simplifie l’authentification en vous permettant de vous authentifier auprès des ressources Azure à l’aide de l’identité managée de la machine virtuelle Azure au lieu du compte d’identification. Lorsque le Runbook Worker hybride est une machine locale, vous devez installer le certificat de compte d’identification sur cette machine. Pour découvrir comment installer le certificat, consultez les étapes de l’exécution du runbook PowerShell Export-RunAsCertificateToHybridWorker dans Exécution de runbooks sur un Runbook Worker hybride.

Scénario : les machines virtuelles Microsoft Azure sont automatiquement annulées du groupe Worker hybride

Problème

Vous ne pouvez pas voir les machines virtuelles ou les Runbook Worker hybrides lorsque l’ordinateur Worker a été mis hors tension pendant un certain temps.

Cause

L’ordinateur Runbook Worker hybride n’a pas interrogé Azure Automation depuis plus de 30 jours. Par conséquent, Automation a vidé le groupe Runbook Worker hybride ou le groupe System Worker.

Résolution

Démarrez l’ordinateur Worker, puis réinscrivez-le avec Azure Automation. Pour obtenir des instructions sur l’installation de l’environnement runbook et la connexion à Azure Automation, consultez Déployer un Runbook Worker hybride Windows.

Étapes suivantes

Si votre problème ne figure pas ici ou que vous ne pouvez pas le résoudre, utilisez l’un des canaux suivants pour obtenir une aide supplémentaire :

  • Obtenez des réponses de la part d’experts Azure via les Forums Azure.
  • Connectez-vous à @AzureSupport, le compte Microsoft Azure officiel pour améliorer l’expérience client. Le Support Azure fournit à la communauté Azure des réponses, un support technique et des experts.
  • Signaler un incident au support Azure Accédez au site du support Azure, puis sélectionnez Obtenir de l’aide.