Delen via

Problemen met de Chaos Agent oplossen

Deze pagina bevat een geconsolideerde handleiding voor het oplossen van problemen met betrekking tot de Chaos Agent die wordt gebruikt in Azure Chaos Studio. Gebruik deze handleiding voor het diagnosticeren van problemen tijdens de installatie, het controleren van de netwerkverbinding, het interpreteren van statusberichten van de agent en het oplossen van veelvoorkomende fouten.

Opmerking

Raadpleeg de pagina Chaos Agent installeren en configureren voor gedetailleerde installatie-instructies. Zie Private Link en Netwerkbeveiliging voor meer informatie over het netwerk en de beveiliging.

Problemen met de installatie van de agent

Als de Chaos Agent niet kan worden geïnstalleerd of ongezond lijkt, voert u de volgende stappen voor foutopsporing uit:

  • Fout bij implementatie van extensie
    • Symptomen: Op de blade Extensies van de virtuele machine (VM) ziet u een andere status dan Provisioning succeeded (bijvoorbeeld Mislukt, Fout).
    • Stappen voor probleemoplossing:
      1. Controleer of de doel-VM voldoet aan de minimale vereisten (ondersteund besturingssysteem automatisch installeren, juiste versie, enzovoort). Zie ondersteuning en compatibiliteit van het besturingssysteem.
      2. Controleer of een door de gebruiker toegewezen beheerde identiteit is gekoppeld aan de virtuele machine.
      3. Controleer het activiteitenlogboek in Azure Portal op eventuele fouten met betrekking tot de implementatie van extensies.
      4. Als de VM deel uitmaakt van een virtuele-machineschaalset, controleert u of het upgradebeleid voor de schaalset niet is ingesteld op Handmatig. Als dit het geval is, voert u handmatig een upgrade uit van exemplaren (met behulp van az vmss update-instances) of schakelt u over naar een automatisch beleid.
      5. Overweeg de extensie te verwijderen en opnieuw te installeren met behulp van de Azure CLI of Azure Portal door op agents gebaseerde fouten op uw VM uit te schakelen en opnieuw in te schakelen: 
        az vm extension delete --resource-group <ResourceGroup> --vm-name <VMName> --name ChaosAgent
az vm extension set --resource-group <ResourceGroup> --vm-name <VMName> --name ChaosAgent --publisher Microsoft.Azure.Chaos --version <version>

Problemen met de netwerkverbinding

Zelfs wanneer de agent is geïnstalleerd, communiceert deze mogelijk niet goed als de netwerkverbinding wordt onderbroken.

  • Symptomen:

    • De handlerstatus van de agent wordt niet weergegeven Ready.
    • Logboeken geven aan dat het service-eindpunt van de Chaos Studio-agent niet kan worden bereikt.

  • Stappen voor probleemoplossing:

    1. Uitgaande toegang controleren:
      Zorg ervoor dat de VM uitgaande netwerktoegang heeft tot het service-eindpunt chaosagent, dat het patroon volgt:
      https://<region>.agents.chaos-prod.azure.com
      Vervang door region de implementatieregio van uw VM.
    2. Controleer de NSG- en firewallinstellingen:
      een. Controleer of een netwerkbeveiligingsgroep (NSG) die is gekoppeld aan de virtuele machine uitgaand HTTPS-verkeer (poort 443) toestaat.
      b. De aanbevolen methode is om de ChaosStudio-servicetag toe te staan voor uitgaand verkeer.
    3. Proxy en aangepaste DNS:
      Als uw omgeving gebruikmaakt van een proxy of aangepaste DNS-instellingen, controleert u of deze instellingen de toegang tot het eindpunt niet blokkeren.
    4. Private Link-configuratie:
      Voor omgevingen die zijn geconfigureerd met Private Link, moet u ervoor zorgen dat: a. Het privé-eindpunt is correct ingesteld en goedgekeurd. b. DNS-omzetting wordt bijgewerkt, zodat het Chaos Agent-servicedomein wordt omgezet in het IP-adres van het privé-eindpunt. c. De configuratie van de agent wordt dienovereenkomstig bijgewerkt.

Status en gezondheidscontroles van de agent

De agent rapporteert twee belangrijke statussen op de blade Extensies en toepassingen van de VM:

  • Statusveld:

    • Provisioning succeeded: Geeft aan dat de extensie is geïmplementeerd.
    • Alle andere statussen (bijvoorbeeld Failed of Error) geven installatieproblemen aan.

  • Handlerstatusveld:

    • Ready: Geeft aan dat de agent actief is en communiceert met de Chaos Studio-service.
    • NotReady of een lege status geeft aan dat de agent geen verbinding kan maken, meestal vanwege netwerkproblemen of onjuist geconfigureerde identiteiten.

Hoe de agentlogboeken te controleren

  • Ramen:
    Open Logboek → Windows-logboeken → Toepassing. Filter op de bron AzureChaosAgent om relevante logboekvermeldingen weer te geven.

  • Linux:
    Voer de volgende opdracht uit om de meest recente logboeken van de Chaos Agent-service weer te geven:

    journalctl -u azure-chaos-agent --lines 50

Zoek naar foutberichten die connectiviteits- of afhankelijkheidsproblemen aangeven.

Chaos Agent voor lokale VM-foutopsporing

Fouten opsporen in agentlogboeken op host

  • Lokale foutopsporing voor Windows-agent
    • Chaos-agent wordt uitgevoerd als Windows-service AzureChaosAgent
      • Windows-servicecode wordt uitgevoerd in de VMExtention-handler
    • Agentlocatie
      • Agent wordt geïnstalleerd als Azure VM-extensie. De locatie van de agent bevindt zich meestal op C:\Packages\Plugins\Microsoft.Azure.Chaos.ChaosWindowsAgent\<version> . De map bevat zowel AzureChaosAgent.exe als agentsettings.json en de bibliotheken.
    • Agentlogboek ophalen op host: Het agentlogboek wordt naar het Windows-servicelogboek verzonden.
      • Voorbeeld van een PowerShell-opdracht om de laatste 50 regels agentlogboek te controleren: '''Get-EventLog -LogName 'Toepassing' -Source 'AzureChaosAgent' -Newest 50''' .
    • Agent starten/stoppen op de host
      • Voer in PowerShell voor beheerders uit Start-Service AzureChaosAgent of Stop-Service AzureChaosAgent
  • Lokale foutopsporing voor Linux-agent
    • Linux chaos-agent wordt beheerd door Systemd.
    • Agentlocatie
      • Als Agent wordt uitgevoerd, kunt u het uitvoerbare bestand van de Linux-agent vinden door ps aux | grep chaos uit te voeren.
    • Haal agentlog op op host
      • Voorbeeld van een bash-opdracht naar de laatste 50 regels van het agentlogboek: journalctl -u azure-chaos-agent --lines 50
    • Agent starten/stoppen op de host
      • voer de bash-opdracht systemctl start azure-chaos-agent uit of systemctl stop azure-chaos-agent

Andere veelvoorkomende fouten en oplossingen

Enkele andere problemen en bijbehorende oplossingen voor de Chaos-agent.

Referentie- of identiteitsfouten

Foutmelding Oorzaak Oplossing
'Kan agent niet registreren vanwege referentiefout'. De beheerde identiteit van de virtuele machine is niet juist geconfigureerd. Controleer of aan de VM de juiste door de gebruiker toegewezen beheerde identiteit is gekoppeld en of deze over de vereiste machtigingen beschikt. Raadpleeg de pagina Chaos Agent installeren en configureren voor gedetailleerde stappen.

Ontbrekende vereisten voor foutuitvoering

Foutmelding Oorzaak Oplossing
'Kan agent niet registreren vanwege API-uitzondering'. Of 'Niet voldaan aan foutvereisten' (bijvoorbeeld ontbrekende stress-ng op Linux) Vereiste afhankelijkheden (zoals stress-ng) zijn niet aanwezig. Probeer de Chaos-agent te verwijderen en opnieuw te installeren. Installeer de ontbrekende afhankelijkheid op de doel-VM. Bijvoorbeeld op Debian/Ubuntu:

sudo apt-get install stress-ng

Raadpleeg de pagina Ondersteuning en compatibiliteit van het besturingssysteem voor meer informatie.

Netwerkverbindingsblokkering

Foutmelding Oorzaak Oplossing
"Het agentlogboek toont een onmogelijkheid om verbinding te maken met https://<region>.agents.chaos-prod.azure.com." Uitgaand netwerkverkeer wordt geblokkeerd. Werk NSG-regels bij om HTTPS-verkeer naar het service-eindpunt van de Chaos Agent toe te staan. Overweeg het gebruik van de ChaosStudio-servicetag voor uitgaande regels. Zorg ervoor dat DNS correct wordt omgezet in het IP-adres van het privé-eindpunt voor omgevingen met Private Link.

Time-out voor extensie of ExtensionHandlerFailed

Foutmelding Oorzaak Oplossing
'ExtensionHandlerFailed'- of time-outfouten in het logboek. De agentextensie is niet goed gestart, mogelijk vanwege netwerk- of resourceconfiguratieproblemen. - Start de VIRTUELE machine opnieuw op en controleer de netwerkverbinding.
- Controleer op eventuele storende beveiligingssoftware die de extensie kan blokkeren.
- Als de extensie permanent is, installeert u de extensie opnieuw met behulp van de Azure CLI (zie de sectie voor het oplossen van installatieproblemen).

Meer middelen